OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: quote inside code. WAS emphasis inside command is illegal?

Here's another problem, showing that <quote> cannot occur inside <code>
The doc says its allowed, at least as far I can see. It actually says "quote (db_quote)". not sure what the parenthetical means here.

nvdl validation chokes:
error: element "quote" from namespace "http://docbook.org/ns/docbook"; not allowed in this context

the document:
<chapter xmlns="http://docbook.org/ns/docbook"; version="5.0">
  <info><title>My Title</title></info>
<para>text with <code>print <quote>hello</quote></code>

Either I'm misunderstanding or there are several errors of this type in the doc. I'm hoping it's me, since I've written a converter based on the info in the doc!

--Tim Arnold

> -----Original Message-----
> From: Rowland, Larry [mailto:larry.rowland@hp.com]
> Sent: Friday, September 24, 2010 12:47 PM
> To: Tim Arnold; docbook@lists.oasis-open.org
> Subject: RE: emphasis inside command is illegal?
> Historically, rather than use <emphasis>, the <replaceable> element would
> have been used.  It is still legal in that location, and provides a more
> semantic identifier for the item being identified.  Not sure why the
> documentation is off, since it is normally derived by parsing the schema,
> but using replaceable is usually mapped to italics, just like emphasis, so
> it will give the same visual presentation while providing a more
> meaningful markup.
> I am also a little curious about why you chose to put "vale" inside the
> command, when it actually appears to be an argument to the command?
> Regards,
> Larry Rowland
> -----Original Message-----
> From: Tim Arnold [mailto:Tim.Arnold@sas.com]
> Sent: Friday, September 24, 2010 8:37 AM
> To: docbook@lists.oasis-open.org
> Subject: [docbook] emphasis inside command is illegal?
> Hi,
> According to what I read here, <emphasis> can occur in <command>
> http://www.docbook.org/tdg5/en/html/command.html
> However, I get this error from onvdl.jar when validating the following xml
> file:
>  error: element "emphasis" from namespace "http://docbook.org/ns/docbook";
> not allowed in this context
> <chapter xmlns="http://docbook.org/ns/docbook"; version="5.0">
>   <info><title>My Title</title></info>
> <para>
> <cmdsynopsis sepchar=" ">
>  <command>NAME <emphasis>value</emphasis></command>
>  <arg choice="plain">options</arg>
> </cmdsynopsis>
> </para>
> </chapter>
> I guess I'm missing something. My validation command:
> java -
> Dorg.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.par
> sers.XIncludeParserConfiguration -jar DocBook/oNVDL/bin/onvdl.jar
> DocBook/V5.0/docbook.nvdl filename.xml
> Anybody see what's wrong?
> thanks,
> --Tim Arnold
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]