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: [EMAIL PROTECTED]
  http://www.kosek.cz

Reply via email to