Re: see also

From: Date: Thu, 19 Jun 2003 19:34:51 +0000
Subject: Re: see also
References: 1 2 3 4  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969354640@lists.php.net to get a copy of this message
Gabor Hojtsy wrote:
Adding our own things to docbook is not a good idea, as it will need more modifications to our stylesheets. Also, it will make it less flexible in cases like:
Why our own tag for see also would be better? - 98% [approx] of see alsos are not that exoticaly worded, as you have done in your example - with our own tags, no translation would be needed for this part - there will be an ability to automatically recognize see also parts, which can seriously help in presentation, and automatic discovery [eg. we can check what parts are better connected in the manual, and what needs more attention]
i remember that we have thought about it before (when someone insisted that in english a comma is needed before the 'and' here ...) ... and AFAIR there are DocBook tags for lists or enumerations that we could use with setting a special role attribute ... i even did some experimental stuff with this back then but somehow this got lost on the way ... i'll try to remember what i did back then ... -- Hartmut Holzgraefe <hartmut@php.net>

« previous php.doc (#969354640) next »