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: RE: emphasis inside command is illegal?

Hi Larry,
Thanks for the info. That example was just a mockup of a bit more complex real life situation. I agree, the value would normally not be inside the <command> element.

I'm finding some additional problems in the documentation (or at least situations similar to this one, where the doc says something is okay, but the validation chokes).

I'll post again with examples when I come across them.

> -----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]