From: Warren Young
Date: May 11 2005 6:52pm
Subject: Re: [PATCH] Re: equal_list() using a bool vector
List-Archive: http://lists.mysql.com/plusplus/4388
Message-Id: <4282547B.5090007@etr-usa.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

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.