Created attachment 13405 [details]
Unadequate format in programlisting
Most XML files for manpages which use programlisting tag are not adequate in the typing manner, so the output would also be not adequate. This is because the characters within the programlisting tags have the unneccessary blanks or tabs in the head position of each lines, as will be output exactly as seen, and this cause unadequate results in the output. Few files, such as pdbedit.8.xml, rpcclient.1.xml, wbinfo.1.xml, are good in the point of this view. But, especially vfs_shell_snap.8.xml is the worst one, please look in the htmlman version, its hyperlinks created for other option pages look bad because of having the unneccessary line breaks in the middle of smbconfoption tags.
Here is a sample, manpages/idmap_tdb2.8.xml:
diff --git a/docs-xml/manpages/idmap_tdb2.8.xml b/docs-xml/manpages/idmap_tdb2.8.xml
index 5b4fe2e..4f93f7b 100644
@@ -79,10 +79,9 @@
- SIDTOID S-1-xxxx
- IDTOSID UID xxxx
- IDTOSID GID xxxx
+IDTOSID UID xxxx
+IDTOSID GID xxxx</programlisting>
And it should return one of the following responses as a single line of
Note that there should be no blanks or tags before '</programlisting>' tag. If not, an unnesseary blank line would create at the end of this programlising content.
I have found several pages that, I am afraid, should modify, and these are shown in an attachment diff file.
Wrong explanation I had before.
Note that there should be no blanks or tags before '</programlisting>' tag. If there exists a blank or tag, an unnesseary blank line would create at the end of this programlising content.