Bug 10602 - There's documentation in there that's not in /usr/doc
There's documentation in there that's not in /usr/doc
Product: Red Hat Linux
Classification: Retired
Component: stylesheets (Show other bugs)
All Linux
medium Severity low
: ---
: ---
Assigned To: Bill Nottingham
Depends On:
  Show dependency treegraph
Reported: 2000-04-05 14:25 EDT by kop
Modified: 2014-03-16 22:13 EDT (History)
1 user (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2000-04-05 14:25:44 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description kop 2000-04-05 14:25:44 EDT
usr/lib/sgml/stylesheets/nwalsh-modular/doc/ contains some really useful
documentation, but it's hard (as in "wack your head against the wall for a
while") to find because it's not in /usr/doc.

I'd probably be a good idea to put the doc in an nwalsh-modular
sub-directory, to make it more clear that it just applies to the
nwalsh-modular style sheets.

(Hate to do this to your bug tracking system)  Also...

/usr/lib/sgml/stylesheets/dbtohtml.dsl dosen't work (for me anyhow, with
jade), although it looks like a good example and should probably be kept
around.  (I think it needs additional <> markup above and below the scheme
code, sorta like this:


4.4. Customizing the Stylesheets

The best way to customize the stylesheets is to write your own "driver"
file; this is a stylesheet that contains your local modifications and then
includes the
appropriate stylesheet from the standard distribution by reference. This
allows you to make local changes and extensions without modifying the
distributed files,
which makes upgrading to the next release much simpler.

4.4.1. Writing Your Own Driver

A basic driver file looks like this:

<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY dbstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print
Stylesheet//EN" CDATA DSSSL>

<style-specification use="docbook">

;; your changes go here...

<external-specification id="docbook" document="dbstyle">


but idunnknow.  Maybe changing it to work with jade would completely break
something else.)
Comment 1 Bill Nottingham 2000-06-10 18:12:57 EDT
Fixed in stylesheets-1.54.13rh-2, which should be
in the next rawhide release - thanks for the bug

Note You need to log in before you can comment on or make changes to this bug.