On Tuesday, 09 August 2005 at 22:27, Vincent Lefevre wrote: > On 2005-08-09 08:42:11 -0700, Brendan Cully wrote: > > Here's a diff against CVS HEAD. There's a PDF target in there too, but > > the autoconf magic for finding the xml entity declarations isn't quite > > done. openjade/opensp seem to be kind of a mess that way. I would have > > used passivetex instead but it seems to choke on the manual no matter > > how much extra memory I give it. > > In manual.txt: > > * The Table of Contents is on 2 levels only. um, feature? Do you really want a TOC entry for each of the hundreds of configuration variables? Anyway this is the same as the linuxdoc manual... > * There's no longer bold and underlined text. hmm, that can be fixed by using lynx with a couple of options instead of w3m to do the conversion. I've changed the Makefile to prefer lynx to w3m. On the other hand... > * Layout in Section 2.3.1.1 (Status Flags) is suboptimal: > > D > > message is deleted (is marked for deletion) This seems to be pretty standard layout for definition lists, but I don't really love it either. There's an xsl option to use tables instead of definition lists for these entries, and it works great with w3m, but lynx predictably makes a mess. > * The manual doesn't fit on 80 columns. In Section 2.3.2 (The Pager): > > <Space> display the next page (or next message if at the end of a > message) > > (this is also the case without the docbook patch, though). > > * Bad line breaks, e.g. line 654: > > The second character indicates the key's signing capabilities. Once again, a > `` > -'' implies ``not for signing'', ``.'' implies that the key is marked as an These will have to be fixed by hand I think... thanks for the feedback.
Attachment:
pgp0bnpZ16thI.pgp
Description: PGP signature