[xml/sgml-pkgs] Bug#258697: marked as done (docbook-utils.dsl overriding site-local config in /etc/sgml/docbook-dsssl/html/siteconfig.dsl)

Debian Bug Tracking System owner@bugs.debian.org
Tue, 09 Nov 2004 03:03:12 -0800

Your message dated Tue, 9 Nov 2004 11:57:49 +0100
with message-id <200411091157.49893.peter_e@gmx.net>
and subject line docbook-utils.dsl overriding site-local config in /etc/sgml/docbook-dsssl/html/siteconfig.dsl
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

Received: (at submit) by bugs.debian.org; 11 Jul 2004 03:46:35 +0000
>From sc@tokamak.homeunix.net Sat Jul 10 20:46:35 2004
Return-path: <sc@tokamak.homeunix.net>
Received: from smtp810.mail.sc5.yahoo.com [] 
	by spohr.debian.org with smtp (Exim 3.35 1 (Debian))
	id 1BjVIR-0001KU-00; Sat, 10 Jul 2004 20:46:35 -0700
Received: from unknown (HELO tokamak.homeunix.net) (gimbal@sbcglobal.net@ with login)
  by smtp810.mail.sc5.yahoo.com with SMTP; 11 Jul 2004 03:46:35 -0000
Received: by tokamak.homeunix.net (Postfix, from userid 1000)
	id 1B04B101F84; Sat, 10 Jul 2004 20:46:34 -0700 (PDT)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Sean Champ <schamp@users.sourceforge.net>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: docbook-utils.dsl overriding site-local config in
X-Mailer: reportbug 2.63
Date: Sat, 10 Jul 2004 20:46:33 -0700
Message-Id: <20040711034634.1B04B101F84@tokamak.homeunix.net>
Delivered-To: submit@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-8.0 required=4.0 tests=BAYES_00,HAS_PACKAGE 
	autolearn=no version=2.60-bugs.debian.org_2004_03_25

Package: docbook-utils
Version: 0.6.13-7
Severity: normal

* Background:

 Using debconf, I'd defined the value #t for %use-id-as-filename%, in 
 But, when I ran 'docbook2html', i noticed that the 'id' attribute was /not/
 being used as the filename, for each individual 'section' element and so-on.
 but, when I ran docbook2html -V "%use-id-as-filename%" somefile.sgml
 then it worked as expected.
After some digging in the shell scripts, it looks like 
is being used *before* either of  /etc/sgml/docbook-dsssl/html/siteconfig.dsl
or  /etc/sgml/docbook-dsssl/print/siteconfig.dsl

So, any values defined in docbook-utils.dsl, the will override anything defined
in the particular siteconfig.dsl

* siteconfig.dsl overridden by docbook-utils.dsl

The two siteconfig.dsl files are referenced from within the respective

Those stylesheets are referenced *after*

docbook-utils.dsl references the respective nwalsh stylesheet, but not
until after it's already added its own stuff; the nwalsh stylesheet, then,
is what references the correct siteconfig.dsl 

docbook-utils.dsl is being used, as the top-level styelsheet, becasue:
 - by default, JW calls   /usr/share/docbook-utils/frontends/docbook
   in order for JW to see which SGML_STYLESHEET to use
 - that 'docbook' frontend script is configured to emit the file-name of
    docbook-utils.dsl, by defualt. 

 docbook-utils.dsl defines %use-id-as-filename% to #f; since that is the
first time that the value is defined, then that will be the value that will
be used throughout the stylesheets.

So, by the time that the correct nwalsh stylesheet has been called, and then
it calls the respective siteconf.dsl (i'm guessing that it makes the call,
somehow, before it sets many values, itself), then that siteconf.dsl will
only be useful for setting values that were not set in docbook-utils.dsl

* Suggestion 1 : empty-out docbook-utils.dsl

The "easiest", most hasty resolution, which I can figure, enough to suggest,
would be to remove the explicit dsssl expressions from 
but leave the file there, so :

- allowing the respective siteconf.dsl files to be used for setting *all* of
   the values that the stylesheet-user would like to  modify -- and without
   the user having to resort to using multiple instances of the -V argument
   on every call to jw or dobook2foo
 - leave the file in place, in case anyone has an existing stylesheet setup
   that requirs the presence of docbook-utils.dsl
Now, a problem with that, might be that the expressions in docbook-utils.dsl
are eliciting behaviors, from docbook2html and docbook2ps, which users will
have grown accustomed to -- and which are very useful, if they would
just not override the user's own settings.

* Suggestion 2 : use docbook-utils.dsl as a template for a new, top-level driver

Perhaps, then, something could be conceived for ensuring that the
right siteconfig.dsl file will be referenced *before*

Perhaps the file docbook-utils.dsl could be used as a template.

Let's say that we'd copy docbook-utils.dsl to
/etc/sgml/docbook-dsssl/custom.dsl , then remove all of the dsssl 
expressions from it, and have it reference the respective siteconfig.dsl
file (for #html or #print)  *then* reference docbook-utils.dsl -- *after* the 
right siteconfig file.

Then   /usr/share/docbook-utils/frontends/docbook could be modified, so as
to use /etc/sgml/docbook-dsssl/custom.dsl (in this example) as the 'default'

I'd offer a patch for trying this, but I'm afraid that i do not, yet, have
quite a handle on the DSSSL and DSSSL-stylesheet SGML syntax.

Hoping, still, this might help for something,


-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i586)
Kernel: Linux 2.6.7
Locale: LANG=en_US, LC_CTYPE=en_US.iso88591

Versions of packages docbook-utils depends on:
ii  docbook-dsssl             1.78-4         modular DocBook DSSSL stylesheets,
ii  jadetex                   3.13-1         generator of printable output from
ii  links-ssl [links]         0.98-2         Character mode WWW browser with SS
ii  lynx                      2.8.5-1        Text-mode WWW Browser
ii  perl                      5.8.4-2        Larry Wall's Practical Extraction 
ii  sgmlspl                   1.03ii-30      SGMLS-based example Perl script fo
ii  sp                        1.3.4-1.2.1-42 James Clark's SGML parsing tools

-- no debconf information

Received: (at 258697-done) by bugs.debian.org; 9 Nov 2004 10:58:00 +0000
>From peter_e@gmx.net Tue Nov 09 02:58:00 2004
Return-path: <peter_e@gmx.net>
Received: from credativ.com (curie.credativ.org) [] 
	by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1CRThH-0003sO-00; Tue, 09 Nov 2004 02:58:00 -0800
Received: from localhost (localhost [])
	by curie.credativ.org (Postfix) with ESMTP id 71243564A9
	for <258697-done@bugs.debian.org>; Tue,  9 Nov 2004 11:57:58 +0100 (CET)
Received: from www.credativ.de (pD950049C.dip0.t-ipconnect.de [])
	(using TLSv1 with cipher EDH-RSA-DES-CBC3-SHA (168/168 bits))
	(No client certificate requested)
	by curie.credativ.org (Postfix) with ESMTP id B610955B6B
	for <258697-done@bugs.debian.org>; Tue,  9 Nov 2004 11:57:57 +0100 (CET)
Received: from bell.credativ.de (bell.credativ.de [])
	by www.credativ.de (Postfix) with ESMTP id 2FA521C0025
	for <258697-done@bugs.debian.org>; Tue,  9 Nov 2004 11:57:55 +0100 (CET)
From: Peter Eisentraut <peter_e@gmx.net>
To: 258697-done@bugs.debian.org
Subject: Re: docbook-utils.dsl overriding site-local config in /etc/sgml/docbook-dsssl/html/siteconfig.dsl
Date: Tue, 9 Nov 2004 11:57:49 +0100
User-Agent: KMail/1.6.2
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
Content-Transfer-Encoding: 7bit
Message-Id: <200411091157.49893.peter_e@gmx.net>
X-Virus-Scanned: by AMaViS at credativ.com
Delivered-To: 258697-done@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-3.0 required=4.0 tests=BAYES_00 autolearn=no 

siteconfig.dsl is gone, so this bug is obsolete.