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, Pennsylvania 19073 ---------------------------(end of broadcast)--------------------------- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
