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: quote inside code. WAS emphasis inside command is illegal?


It appears to work as documented (based on a small sampling of children elements) with the 5.1 beta, which I have been working with developing some sample documents.  You might try it from here:

  http://www.docbook.org/xml/5.1b2/rng/

Regards,
Larry Rowland


-----Original Message-----
From: Barton Wright [mailto:bwright@streambase.com] 
Sent: Friday, September 24, 2010 12:46 PM
To: Tim Arnold; docbook@lists.oasis-open.org
Subject: [docbook] RE: quote inside code. WAS emphasis inside command is illegal?

I verified that both of Tim's examples also fail validation in XXE and Oxygen.

So either TDG5 is wrong or the schema is wrong.

Anyone know which?

[Re-sent from a list-valid address. No rejection this time?]

-----Original Message-----
From: Tim Arnold [mailto:Tim.Arnold@sas.com] 
Sent: Friday, September 24, 2010 2:01 PM
To: docbook@lists.oasis-open.org
Subject: [docbook] 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.
http://www.docbook.org/tdg5/en/html/code.html

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>
</para>
</chapter>

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
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org


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