RE: [docbook] varname question

[Tim Arnold <Tim.Arnold@sas.com>]

Hi Dick,
Thanks for confirming that for me. I switched over to <symbol> instead of <emphasis>.
I gave some thought to <replaceable> but this isn't something a user would replace, it's just referred to in text after a pattern like this:
" The variables are numbered as follows: _TYPE1_, _TYPE2_, ..., _TYPEn_ "

So maybe <symbol> is the best choice here; in any case, either <symbol> or <replaceable> gets around the bug.

thanks again,
--Tim


> -----Original Message-----
> From: Dick Hamilton [mailto:rlhamilton@frii.com]
> Sent: Friday, June 25, 2010 1:59 PM
> To: Tim Arnold; docbook@lists.oasis-open.org
> Subject: RE: [docbook] varname question
> 
> Tim,
> 
> I think this is a bug in 5.0; I get the same problem using emacs in nxml
> mode, even though the 5.0 Definitive Guide says it should be ok.
> 
> I have a vague memory of this point coming up in the TC a while back.
> Maybe someone with a better memory than mine can help clarify that
> point.
> 
> That said, I'd probably use a different construct anyway:
> 
> <varname>_TYPE<replaceable>N</replaceable></varname>
> 
> Seems like it more accurately captures your intent, renders the same
> way, and it might parse correctly for you (it does for me).
> 
> Hope that helps.
> 
> Dick Hamilton
> ---------------------------------
> XML Press
> XML for Technical Communicators
> http://xmlpress.net
> (970) 231-3624
> 
> 
> > -----Original Message-----
> > From: Tim Arnold [mailto:Tim.Arnold@sas.com]
> > Sent: Friday, June 25, 2010 8:07 AM
> > To: docbook@lists.oasis-open.org
> > Subject: [docbook] varname question
> >
> >
> > Hi,
> > I have a situation where I want to refer to a variable name
> > that looks like this:
> > _TYPEn_ where the 'n' is italicized to stand for some number,
> > n. I tag it like this:
> > <varname>_TYPE<emphasis>n</emphasis>_</varname>
> >
> > But I get this error when validating with onvdl:
> > test.xml:7:35: error: element "emphasis" from namespace
> "http://docbook.org/ns/docbook"; not allowed in this context
> 
> I thought it was allowed to have emphasis in varname. What am I doing
> wrong?
> thanks,
> --Tim Arnold
> 
> DETAILS:
> -----------------
> <chapter xmlns="http://docbook.org/ns/docbook";
>          xml:id="test" version="5.0">
>   <info><title>la di da</title></info>
>   <section>
>     <info><title>hey</title></info>
>     <para><varname>_TYPE<emphasis>n</emphasis>_</varname></para>
>   </section>
> </chapter>
> -----------------
> Here's the validation command:
> 
> /usr/local/bin/java
> -Dorg.apache.xerces.xni.parser.XMLParserConfiguration=org.apache.xerces.
> parsers.XIncludeParserConfiguration -jar /DocBook/oNVDL/bin/onvdl.jar
> /DocBook/V5.0/docbook.nvdl test.xml
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
> 
> 
>