apr-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stas Bekman <s...@stason.org>
Subject Re: [PATCH] apr_{file,network}_io.h doxygen data
Date Wed, 31 Dec 2003 21:57:41 GMT
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


Mime
View raw message