[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation question

From: Reuben Thomas
Subject: Re: Documentation question
Date: Sat, 14 Aug 2010 16:46:08 +0100

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?


reply via email to

[Prev in Thread] Current Thread [Next in Thread]