[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?
--
http://rrt.sc3d.org
- Re: Documentation question,
Reuben Thomas <=