Christopher Kings-Lynne wrote:
> > I read the PHP addslashes() manual page:
> >
> > http://us3.php.net/addslashes
> >
> > First, I see what people mean about PHP having most of the complex
> > content in comments, rather than in the actual manual text, and this
> > tendency is certainly something we want to avoid --- you end up having
> > to digest all the comments to find the details that should be in the
> > manual already.
>
> Actually, all the comments are posted on the php-doc list, with
> automatic urls in them for 'fixed in cvs', 'rejected', etc.
>
> Each comment is supposed to be acted upon (ie. fixed in source), then
> deleted.
>
> There's still a lot of old comment around that hasn't had that treatment
> though...
Right, they are more _usage_ comments, but still I think they could be
consolidated into manual text.
-- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610)
359-1001+ If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square,
Pennsylvania19073
