On Wed, 24 Jul 2013, Gabor Kovesdan wrote:
On 2013.07.23. 23:11, Warren Block wrote:
There is something weird about bulleted lists and sub-lists, starting on
page 35 of the PDF Handbook (page 7-9 of the content). Some entries in the
first list are blank, the ones in the second list have an extra linefeed
after the bullet.
It is a known issue and is actually the result of misplaced indexterms, not a
bug in the rendering. I've already fixed some of them in the English docs but
translations still has to be fixed and there may be slightly different cases,
which I haven't caught yet. We should document in fdp-primer that indexterms
should be put right inside of the text after the referred word. Not between
paragraphs, not into <itemizedlist>, not into <listitem> but right inside
<para> after the referred word without leaving a single a space. If they are
not in <para>, it can cuase such problems. And if you put a space before the
indexterm, there may be a page break and you get a wrong page number in the
index. But the probability of this latter is very low, the former thing is
more important.
Presently, indexes and indeterms are not even mentioned in the FDPP.
I'll start a list of things to add after the doc slush. If you or
anyone else have found things which are not documented well or at all in
the FDPP, please let me know or enter a PR.
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[email protected]"
