Re: Re: some remaining new doc style issues
| From: | Philip Olson | Date: | Sun, 22 Aug 2004 17:43:20 +0000 |
| Subject: | Re: Re: some remaining new doc style issues | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969363412@lists.php.net to get a copy of this message | ||
> I agree with everything except the seealso.
>
> Let's formalise it and let XSL do the hard work.
>
> We can make a simplelist, or find some relevant docbook tag, sticking the
> entity in is a bit dirty.
This has been discussed many times with many dead ends. Here
are some see also threads:
http://marc.theaimsgroup.com/?l=phpdoc&m=100894842011360
http://marc.theaimsgroup.com/?l=phpdoc&m=101051061316162
http://marc.theaimsgroup.com/?l=phpdoc&m=105601918607181
One structure that was proposed is as follows. Not sure why
it wasn't implemented, let's wait until Goba comes back from
vacation to answer this :)
<note role="seealso">
<simplelist>
<member><function>print</function></member>
<member><function>echo</function></member>
</simplelist>
</note>
I can't find any mention of &listendand; on the lists, and
from RFC/2003_meeting_findings.txt is this:
"About see also lists, the attendees of the meeting concluded
in that the current see also writing scheme is fine, and
there is no need to modify it."
In summary: Not sure what happened with this idea. It seemed
like everyone wanted the structured see also (no commas, no
and...) as to let XSL/Livedocs deal with the style but it never
happened. Let's see what Goba says on this.
Regards,
Philip