[xml/sgml-pkgs] Bug#258525: docbook-utils: %use-id-as-filename%

[Sean Champ]

Package: docbook-utils
Version: 0.6.13-7
Followup-For: Bug #258525


This can be a matter of:

- having the DSSSL variable %use-id-as-filename% defined to #t in the
  stylesheets, and
- using meaningful 'id' attribute values, on each section, bibliography, or
  so-on, within the document.

The quickest way to manage the first of those is to run docbook2html with a
-V argument like:
  docbook2html -V "%use-id-as-filename%" {somefile}.sgml


There is a way for having debconf set the value, in
  /etc/sgml/docbook-dsssl/html/siteconfig.dsl
  
(but it seems that whatever's being set -- in the site-customizable files
 /etc/sgml-docbook/*/siteconfg.dsl -- are, currently,x being overridden by
values in /usr/share/docbook-utils/docbook-utils.dsl

I'll be filing a seperate bug report about that, shortly.)

For now, the -V example, with the shell command, and having a meaningful 'id'
value, on each "seperate file" (i.e.: chapter, section, bibliography, etc)
part, in the document ... should work.

--
sean


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