Re: See also

From: Date: Mon, 14 Jan 2002 19:49:50 +0000
Subject: Re: See also
References: 1 2 3 4  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969341233@lists.php.net to get a copy of this message
Egon Schmid wrote: > Jirka, please don´t make changes for the rendering of the "see also" > notes until there is a solution for the incomplete PDF manuals. IMHO > it is an overkill. You mean: overkill = too much markup? In general you are right, but marking some block as "seealso" can be very usefull when rendering and converting to other formars (e.g. HTML Help). Handling role="seealso" on para will be possible but much more harder then on note. Using note as a container allows you to use simplelist if you want some longer list of functions or whatever else be seealso-ed. Ultimately, you guys (Egon, Goba, Harmut) should agree on correct markup pattern. I just offered my opinion from DocBook markup point of view. > It is much better to write the "see also" notes > as before. Indeed it will be too complex if you consider the other > languages with different rules for rendering. I see no problem here, if you are afraid of localizations of "see also" this is not problem as there is localization for this string already present in stylesheets. Jirka -- ----------------------------------------------------------------- Jirka Kosek e-mail: jirka@kosek.cz http://www.kosek.cz

« previous php.doc (#969341233) next »