Re: see also

'See also' is in the gentext language files, folks. It's supposed to be an entity. (and no, we don't use it either .. yet) ----- Original Message ----- From: "Hartmut Holzgraefe" <hartmut@php.net> To: "Gabor Hojtsy" <gabor@hojtsy.hu> Cc: "Derick Rethans" <derick@php.net>; "Philip Olson" <philip@cornado.com>; "Friedhelm Betz" <holliwell@gmx.net>; <phpdoc@lists.php.net> Sent: Thursday, June 19, 2003 7:34 PM Subject: Re: [PHP-DOC] see also > 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> > > > -- > PHP Documentation Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > >