<<< Date Index >>>     <<< Thread Index >>>

Re: Docbook patch



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