Re: How do you read a sgml file?

[David Z Maze <dmaze@MIT.EDU>]

Mark Phillips <mark@ist.flinders.edu.au> writes:
Mark> I'm looking at the wine documentation directory, and half the files
Mark> seem to be sgml ones.  How do you read them?  Do you need to run a
Mark> utility to convert them to latex or something?

In general, you need a tool capable of reading whatever instantiation
of SGML the files are and doing appropriate processing/rendering.  For 
certain DTDs, you probably already have appropriate software, but
those files are generally referred to as just "HTML".  :-)

While I haven't looked at the WINE documentation, I wouldn't be
surprised if the files are in DocBook format.  (Look at the first line 
of the file; it should have a <!DOCTYPE ...> declaration, and it'll
say if it's DocBook or something else.)  For general-purpose SGML
processing, I'd recommend installing the jade and jadetex packages.
To format DocBook documents, also install docbook and
docbook-stylesheets.

At this point, you're ready to do the formatting.  Look for a DSSSL
style sheet file (it'll probably have a .dsl extension); if one
doesn't exist, use
/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl
instead.  Then run

        jade -t tex -d (name-of-dsl-file) file.sgml
        jadetex file
        jadetex file
        xdvi file
        dvips file (etc.)

-- 
David Maze             dmaze@mit.edu          http://www.mit.edu/~dmaze/
"Theoretical politics is interesting.  Politicking should be illegal."
	-- Abra Mitchell