> > (ii) Parameter List: I'd like to see this kept as compact as > > possible, so I'd prefer to do without the vertical spacing > > between the parameter name and its description. (Also, if it > > were possible to merge the top and bottom dashed borders, that > > would be great!) However, I would like to see the type > > information repeated here, so I don't have to refer back to the > > proto if the associated description doesn't make it obvious to > > me (including an & if it's a by-reference parameter). > > Type information and by reference passing should be included IMHO too. > BTW the names of the parameters are missing from > > http://livedocs.phpp.org/index.php?l=en&q=function.exif-thumbnail >
Livedocs does not handle parameters with & correctly, they show up blank. I'll clean exif up, and add the type information, and the ref although have we figured out a way to not confuse users with this yet? Meaning, not promote people to inapropriately pass parameters by reference at runtime. This still worries me. The new exif docs will be posted to phpdoc later today. > > (iii) The Change Log table has a rather wide first column -- this > > may in part be due to the long title, which I think is excessive: > > "Version" would be quite sufficient IMO. > > Agreed. This title should be generated with an entity anyway. There are entities named &Version; and &Description; in language-defs.ent, does this sound good? They are simply one word entities. Regards, Philip
