Re: Documentation question

[Reuben Thomas]

On 4 August 2010 09:54, James Youngman <address@hidden> wrote:
> On Wed, Aug 4, 2010 at 1:02 AM, Reuben Thomas <address@hidden> wrote:
>
>> "in regexprops-generic.texi, I think that having a plain English
>> definition of the various syntaxes obscures the fact that each is
>> defined as a strict combination of features. Would you be happy if I
>> rewrote the manual as English documentation of each
>> feature plus a simple list (possibly automatically generated from
>> regex.h) of which features are present in which syntax?"
>
> I'm not sure the two options need to be exclusive.

Fair enough, especially as it's machine generated, so the maintenance
problem I imagined is non-existent.

> In any case, the current documentation is machine-generated by a C
> program in findutils.   You might want to download it; this should
> help you get some more specific ideas about what you propose to
> change.

gnulib people: you seem to be unhappy with code-generated
documentation. How would you like to proceed?

-- 
http://rrt.sc3d.org