Re: cvs: phpdoc / Makefile.in

From: Date: Fri, 16 May 2003 18:51:08 +0000
Subject: Re: cvs: phpdoc / Makefile.in
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969353547@lists.php.net to get a copy of this message
> > > 1) We don't reset the Example numbering for each function name. (I > > > fixed this.) > > > > We agreed that this is not a problem, maybe even an advantage. One can > > refer to a specific example number (but it will change with every build, > > so this should not be relied on). As far as I can see it is not our main > > focus to make the XSL output exactly the same as the DSSSL one. Anytime > > we can improve things, we'd better to that. This was considered to be > > sort of an improvement. > > Hum... I don't think I really agree that this is sort of an > improvement. If you refer to Example 2 for array_merge() and it's > switched to Example 3, then it's a little confusing, but you're still > on the page physical HTML page. But, if Example 143 moves from > array_merge() to array_merge_recursive() then that's really > confusing. > > Since we update the docs on a frequent basis that means all the > Examples won't necessarily stay constant for more than a few > days. That kind of defeats the purpose of letting people refer to them > easily. IMHO. This is a good point, we should go back to the old method unless something else is figured. I was also for the new "feature" but have been convinced otherwise. Regards, Philip

« previous php.doc (#969353547) next »