This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: <subscript> not valid in <parameter>?


> From: Bob McIlvride <robert@cogent.ca>
> 
> After moving from DocBook version 3.1 to 4.1.2 and updating our DSSSL
> from 1.54 to 1.59, we encountered this unexpected behavior during
> validation:
> 
> /usr/bin/nsgmls:../../i/gamma/re_with.sgml:19:32:E: document type does
> not allow element "SUBSCRIPT" here; assuming missing "REPLACEABLE"
> start-tag
> /usr/bin/nsgmls:../../i/gamma/re_with.sgml:19:57:E: end tag for
> "REPLACEABLE" omitted, but OMITTAG NO was specified
> /usr/bin/nsgmls:../../i/gamma/re_with.sgml:19:22: start tag was here
> 
> Here is the relevant code in i/gamma/re_with.sgml:
> 
> <synopsis>
>   <literal>
> ...
> with <parameter>symbol<subscript>1</subscript></parameter> in|on  
> ...
>   </literal>
> </synopsis>
 

The content model for parameter (and several other elements)
was reduced in Docbook 4.0.  The parameter element went
from %cptr.char.mix to %smallcptr.char.mix.  There was this
warning comment in the Docbook 3.1 DTD file dbpoolx.mod:

  <!ENTITY % parameter.module "INCLUDE">
  <![%parameter.module;[
  <!--FUTURE USE (V4.0):
  ......................
  Parameter will have its content constrained to smallcptr.char.mix.
  ......................
  -->

The Docbook team's policy is that backwards incompatible
changes can be made when rolling the major version number,
if sufficient warning is given.
If you cannot update your files, then you'll need to
use the old DTD with them.

bobs
Bob Stayton                                 400 Encinal Street
Publications Architect                      Santa Cruz, CA  95060
Technical Publications                      voice: (831) 427-7796
The Santa Cruz Operation, Inc.              fax:   (831) 429-1887
                                            email: bobs@sco.com

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]