Re: See also

Gabor Hojtsy wrote: > > What is the exact syntax, will we still be defining commas and 'and' > > within the blocks? > > Yes. It seems that using lists is much more complex for the rendering, > as it involves adding commas and and words only where needed > programatically. > > <note role="seealso"> > <function>print</function>, and > <function>echo</function> > </note> You can't put mixed content directly into note in DocBook. You must wrap it with para: <note> <para><function>print</function>, and <function>echo</function></para> </note> > <somelisttag role="seealso"> > <function>print</function> > <function>echo</function> > </somelisttag> This will require change in DocBook, you can use simplelist instead: <note role="seealso"> <simplelist> <member><function>print</function></member> <member><function>echo</function></member> </simplelist> </note> > but the note form allows us to do things like this: > > <note role="seealso"> > <function>print</function>, and > the notes on the <link linkend="secutity.cgi">CGI > security page</link> > </note> Once again, you must wrap it inside para: <note role="seealso"> <para> <function>print</function>, and the notes on the <link linkend="secutity.cgi">CGI security page</link> </para> </note> > Either we choose "note" or "somelisttag", it is better > than the current style. I have not seen too many > comments about this on the list so far... IMHO <note> is on semantic level very close to seealso. Using role is standard DocBook way to make it different from standard note. Jirka -- ----------------------------------------------------------------- Jirka Kosek e-mail: jirka@kosek.cz http://www.kosek.cz