Chris Frey wrote:
> I thought that at first too, but then I noticed there were other instances
> of the same type of constructor, with variables in different order.
Hmmm, okay, I buy that. I'm going to accept it provisionally, on the
condition that it doesn't break my existing binaries.
> Doxygen isn't really possible in custom.pl, as far as I know.
Instruction to self: open mouth, insert foot.
Sorry, I wasn't thinking when I wrote that. The sentiment is still
valid, though. :)
> For DocBook, I assume straight patches to doc/userman/userman.xml are
> the preferred format?
Yes, that's the source file. See the README file in that directory for
sources of information on DocBook. It really isn't all that different
from HTML, so if you know that, the learning curve should be pretty shallow.
> I haven't finished reading it all, so
> don't feel qualified to change it yet. :-)
I won't be asking as much for changes to the userman as to the refman.
"Voice" is important in the userman, so it there should be as few
fingers as practical in that pie. In the refman, it's just a recounting
of hard facts using a well-defined format, so there are few style
concerns with it.
Don't worry about documenting custom5. I'll handle that.