Return-Path: Delivered-To: apmail-apr-dev-archive@www.apache.org Received: (qmail 93898 invoked from network); 31 Dec 2003 21:47:03 -0000 Received: from daedalus.apache.org (HELO mail.apache.org) (208.185.179.12) by minotaur-2.apache.org with SMTP; 31 Dec 2003 21:47:03 -0000 Received: (qmail 5859 invoked by uid 500); 31 Dec 2003 21:46:50 -0000 Delivered-To: apmail-apr-dev-archive@apr.apache.org Received: (qmail 5783 invoked by uid 500); 31 Dec 2003 21:46:50 -0000 Mailing-List: contact dev-help@apr.apache.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: Delivered-To: mailing list dev@apr.apache.org Received: (qmail 5770 invoked from network); 31 Dec 2003 21:46:50 -0000 Message-ID: <3FF34655.3080403@stason.org> Date: Wed, 31 Dec 2003 13:57:41 -0800 From: Stas Bekman Organization: Hope, Humanized User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.4) Gecko/20030630 X-Accept-Language: en-us, en, he, ru MIME-Version: 1.0 To: Sander Temme Cc: APR Development Subject: Re: [PATCH] apr_{file,network}_io.h doxygen data References: In-Reply-To: Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Sander Temme wrote: > Silence two make dox warnings with this small patch: > > * Doxygen thinks a backslash precedes a command, so the backslash in the > documentation for apr_file_gets() needs to be escaped. [...] > - * @remark The buffer will be '\0'-terminated if any characters are stored. > + * @remark The buffer will be '\\0'-terminated if any characters are > stored. Can't this be worked around in some other way? People reading raw .h files may get confused with '\\0'. And I won't be surprised if someone will try to 'fix' that as a typo later on. __________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:stas@stason.org http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com