> > >b) No ending period in the see also > > > > Why not? > > "See also echo and print." > > > The ending period makes sense to me! > > This also make sense to me. Unlike the refpurpose, the "see also" > paragraph is exactly that; a paragraph in the body of the text, and > should end in a period like any other sentence. > > Consistency between these sorts of things may not be as important as > content, but it does make for a more refined and professional manual.
I am referring to the new style where see also is its own refsect1 as 'See Also' is in a <title> now, not a <para>. Because of this it's no longer a paragraph or even a sentence but rather a simple list of functions/items. I can even see us not using commas. I think this one reason why Goba proposed not using punctuation at all long ago and letting stylesheets dictate the format. Here's a post (it uses old <para> format but the gist holds true) http://marc.theaimsgroup.com/?l=phpdoc&m=105604569204232 For the exotic entries listed in that post perhaps we can simply surround those with <para> and format accordingly. And here's an example using the new format: http://www.php.net/manual/en/function.mysqli-close.php It doesn't look bad but the use of commas and periods is leftover from the old style. If we stick with commas as the seperator that's fine but other options do exist. Regards, Philip
