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