Am Donnerstag, den 02.02.2006, 10:50 +0100 schrieb Daniel Leidert:
> Am Mittwoch, den 01.02.2006, 16:40 -0600 schrieb Bob Hanson:
> > (1) Please take a look at 
> > http://www.stolaf.edu/jmol/docs/JmolDevelopersGuide.html
> > and let me know if that looks OK to you.
> 
> Small markup issues (don't care, others did the same). Menus are not
> commands. To write about a menu use
[snip]

<menuchoice>
  <guimenu>foo</guimenu>
  <guisubmenu>foobar</guisubmenu>
  <guimenuitem>bar</guimenuitem>
</menuchoice>

> and not
> 
> <command>foo | bar</command>
> 
> See http://docbook.org/tdg/en/html/menuchoice.html.
> 
> I know, there are more markup issues, but atm I don't have the time to
> fix them.

Another one. Error texts, like e.g. "class file has wrong version 49.0,
should be 48.0" should be marked as

<errortext>class file has wrong version 49.0, should be 48.0</errortext>

If it's more a return value, you can use the <returnvalue> tag instead.
Examples showing their usage are at
http://docbook.org/tdg/en/html/returnvalue.html and
http://docbook.org/tdg/en/html/errorcode.html.

Regards, Daniel



-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
Jmol-developers mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/jmol-developers

Reply via email to