Re: Bug#91892: Small problem with Layout of pdf documentation
Osamu Aoki (debian@aokiconsulting.com) wrote:
> Ardo,
>
> I do not see the exact problem on current installmanual in section 5.4
> but see similar problem in appendix. (I remember seeing it a lot with
> the old woody TEX before freeze.)
>
> With the released woody version of TEX, run over of right margin by URL
> is rare (mostly <example> section. I am limiting 72char/line for that
> to avoid this.)
Good! That probably should also be mentioned in the documentation.
> Problem in appendix is happening with TAGLIST's TAG. Somewhat similar
> to Bug 61038.
>
> Something like:
>
> <taglist>
> <tag>Title of section
> <taglist>
> <tag><ref id="&long-url1;" name="long-name1">
> <tag><ref id="&long-url2;" name="long-name2">
> <tag><ref id="&long-url3;" name="long-name3">
> <item>Explanation
> </taglist>
> ...
> </taglist>
>
> For me, this can be easily fixed by avoiding this aggressive use of tag
> list. I wonder following does better?
>
> <sec?>Title of section
> <list compact>
> <item><ref id="&long-url1;" name="long-name1">
> <item><ref id="&long-url2;" name="long-name2">
> <item><ref id="&long-url3;" name="long-name3">
> </list>
> <p>Explanation
> </sec?>
> ...
>
> We may add <strong>...</> to emulate bold.
That's what's going in the documentation.
> Can you confirm exact location of problem? There may be a way to fix
> this without hacking with debiandoc-sgml which seem to work fine for me.
> My "Debian Reference" has quite a bit of long URL.
Oh, this is already a very old problem. It occurred in the installation
manual with the complete location of all the various floppy disks. AFAIK
the manual has been changed.
> TAG to me sounds like some short header thus may not need folding line
> capability.
That's exactly what I want to mention in the documentation.
Thanks,
Ardo
--
Ardo van Rangelrooij
home email: ardo@debian.org
home page: http://people.debian.org/~ardo
GnuPG fp: 3B 1F 21 72 00 5C 3A 73 7F 72 DF D9 90 78 47 F9
Reply to: