Re: Query: bug in <citation>#PCDATA</citation>

[Ron Catterall <ron@catterall.net>]

Title: Re: Query: bug in <citation>#PCDATA</citation>

jirka@kosek.cz believes this is the correct behavior for the Docbook DTD, and that it is an error in the XEP FO style sheets.  The question seems to lie in the interpretation of the Docbook DTD specification (which allows #PCDATA): citation::=(#PCDATA|footnoteref|xref|biblioref|abbrev|acronym|citation|

 citerefentry|citetitle|emphasis|firstterm|foreignphrase|etc.

and the description in the Docbook ref. book:

"citation - An inline bibliographic reference to another published work"

and "The content of a Citation is assumed to be a reference string, perhaps identical to an abbreviation in an entry in a Bibliography." http://docbook.org/tdg/en/html/citation.html

Note the words "perhaps identical"

Can anyone give me a definitive resolution of this?

Ron

> > #PCDATA is allowed in <citation>
> > (Docbook 4 manual), but transformation
> > to xhtml produces warning messages which
> > suggest that the content of
> > <citation> is assumed to be a
> > <biblioref>.  The XHTML output inserts [
> > and ] around the #PCDATA within
> > <citation></citation> as it would do if=
> > this were a <biblioref>. Same for
> > <citation> a child of <para> or
> > <attribution>.
> > The Warning messages produced are:
> > Citation to nonexistent publication abbrev: 35-36
> > Citation to nonexistent publication abbrev: 13-16
> I think that this behavior is completely aligned with TDG. See:
> http://docbook.org/tdg/en/html/citation.html
> "The content of a Citation is
> assumed to be a reference string, perhaps
> identical to an abbreviation in an entry
> in a Bibliography."
>
> Why do you think that this is a bug?

because

DocBook: The Definitive Guide

by Norman Walsh and Leonard Muellner
With contributions from Bob Stayton
ISBN: 156592-580-7
2.0.12
Updated: Mon, 18 Apr 2005

tells me that <citation> accepts #PCDATA - I always understood this was any parsed character data and had no other meaning within the DTD.

I take the point that  "citation - An inline bibliographic reference to another published work" seems to imply a <biblioref or somesuch, but the formal inclusion of #PCDATA in the Docbook DTD surely contradicts this?

 

citation

$Revision: 1.3 $

$Date: 2002/06/12 11:18:03 $

citation - An inline bibliographic reference to another published work

Synopsis

Mixed Content Model

citation ::=
(#PCDATA|footnoteref|xref|biblioref|abbrev|acronym|citation|

 citerefentry|citetitle|emphasis|firstterm|foreignphrase|

etc.

> > FO transformation to PDF with XEP 4.6
> > interprets the <citation>
> > correctly - no warning or error messages,
> > and no [ and ] wrapped around
> > the citation.
>
> Then this is bug in FO stylesheets that
> should be fixed.

I'll query the XEP list on this.

> ------------------------------------------------------------------
>    Jirka
> Kosek     e-mail:
> jirka@kosek.cz    
> http://www.kosek.cz
> ------------------------------------------------------------------

-- 

Ron Catterall, Phd, DSc                         email: ron@catterall.net
Prolongacion de Hidalgo 140                             http://catterall.net/
San Felipe del Agua                                        tel: +52 951 520 1821
Oaxaca      68020  Mexico                          fax: +1 530 348 8309