Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@httpd.apache.org
Received-SPF: pass (nike.apache.org: local policy)
From: Stefan Fritsch <sf@sfritsch.de>
To: docs@httpd.apache.org
Subject: Re: Error documentation, more thoughts
Date: Mon, 12 Mar 2012 10:25:15 +0100
User-Agent: KMail/1.13.7 (Linux/3.2.0-2-amd64; KDE/4.7.4; x86_64; ; )
References: <12095CB0-6076-4FD6-95D4-286CEA2DC9F9@rcbowen.com>
 <alpine.DEB.2.00.1203111524500.24599@eru.sfritsch.de>
 <C723D5A6-B3D5-4B84-B5EA-AF2550DDE2D9@rcbowen.com>
In-Reply-To: <C723D5A6-B3D5-4B84-B5EA-AF2550DDE2D9@rcbowen.com>
MIME-Version: 1.0
Content-Type: Text/Plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <201203121025.15968.sf@sfritsch.de>

On Sunday 11 March 2012, Rich Bowen wrote:
> On Mar 11, 2012, at 10:31, Stefan Fritsch <sf@sfritsch.de> wrote:
> > A doxygen-like comment that resides in the *.c file right above
> > the log call may be even more easy to edit for developers. There
> > would be a script that extracts these comments and puts them
> > into xml files in the docs.
> 
> See, I knew there was a reason I didn't just go ahead and do it.

OTOH, this would prevent people with only docs commit access to edit 
the comment. Or the some script would have to do the syncing in both 
ways, which seems rather complex.

I guess this really should be discussed on the -dev list.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org