Re: Re: documenting php5

> I have yet to see a function with this on it maybe I am just blind, most > functions I see have the no version info may only be in cvs which is down > right confusing what cvs branch for one ;) > Initially it has "No Version Information" but when whatshisname runs his version script every so often, the version information is added.... dns_get_record() is (again) a good example as it's been documented for nearly a year. > Not really but as you said some params wont be in it and may be buried in a > user comment or the such, generally the docs team is good with staying on > top of things but these things do happen. Maybe separate strings for > separate versions but this again is a hassle on the documenter and creates a > mess in the docs, colours are always nice ;) > If the manual doesn't get updated with functionality changes it's the programmer's fault and (s)he should be whipped within an inch of thier life. > Good idea, but as you say a pain in the arse specially when it comes to > merging especially user notes ;) and the need doesn't arise to often mainly > around a major release I would assume > So maybe instead of PHP_4_3, PHP_5_0, PHP_5_1 style branching, just go with PHP_4, PHP_5 style.... That feels like a half measure.... but as recently stated, I'm generally against it anyway. -Sara (Duplicitous as always)