asciidoctor warnings messages when generating documentation #429

[JesseCoretta]

As requested by @maximthomas, here are some asciidoc errors I've observed during (successful) build processes. This ticket is for tracking purposes only.

[INFO] asciidoctor: INFO: possible invalid reference: make-ldif-1       
[INFO] asciidoctor: INFO: possible invalid reference: makeldif-template-5
[INFO] asciidoctor: ERROR: the table cell on page 4223 has been truncated; Asciidoctor PDF does not support table cell content that exceeds the height of a single page
[INFO] asciidoctor: ERROR: man-dsjavaproperties.adoc: line 23: non-conforming name section body
[INFO] asciidoctor: ERROR: man-makeldif-template.adoc: line 21: non-conforming name section body
[INFO] asciidoctor: ERROR: man-windows-service.adoc: line 23: non-conforming name section body

Note that in many cases, the above errors appear more than once. Again, the build process IS successful otherwise.

[maximthomas]

Unresolved issues in the #429 PR:

[INFO] asciidoctor: INFO: possible invalid reference: make-ldif-1       
[INFO] asciidoctor: INFO: possible invalid reference: makeldif-template-5

Messages appear while building man-pages, links work fine in antora and pdf

[INFO] asciidoctor: ERROR: the table cell on page 4223 has been truncated; Asciidoctor PDF does not support table cell content that exceeds the height of a single page

Known limitation of the asciidoc to pdf converter. https://docs.asciidoctor.org/pdf-converter/latest/features/#limitations
There is no workaround yet