Thread

Building Documentation under Debian

Mark Hollomon <mhh@nortelnetworks.com> — 2000-01-21T13:31:30Z

If anyone cares, here is what I had to do to build the postgresql
documentation on a Debian system.

1. install jade, docbook, and unzip
	apt-get install jade
	apt-get install docbook
	apt-get install unzip

2. grab the DSSSL stuff from http://www.nwalsh.com/docbook/dsssl
	 and unzip it somewhere (I chose /usr/share).

3. edit Makefile.custom to add appropriate HSTYLE and PSTYLE
	definitions
	HSTYLE= /usr/share/docbook/html
	PSTYLE= /usr/share/docbook/print

And thats it.

-- 

Mark Hollomon
mhh@nortelnetworks.com
ESN 451-9008 (302)454-9008

Re: [HACKERS] Building Documentation under Debian

Oliver Elphick <olly@lfix.co.uk> — 2000-01-21T13:51:24Z

"Mark Hollomon" wrote:
  >If anyone cares, here is what I had to do to build the postgresql
  >documentation on a Debian system.
 
...

Thomas, don't you do some hand-tweaking after the standard build?

-- 
Oliver Elphick                                Oliver.Elphick@lfix.co.uk
Isle of Wight                              http://www.lfix.co.uk/oliver
               PGP key from public servers; key ID 32B8FAA1
                 ========================================
     "For we wrestle not against flesh and blood, but  
      against principalities, against powers, against the 
      rulers of the darkness of this world, against  
      spiritual wickedness in high places. Wherefore take 
      unto you the whole armour of God, that ye may be able 
      to withstand in the evil day, and having done all, to 
      stand."              Ephesians 6:12,13

Re: [HACKERS] Building Documentation under Debian

Thomas Lockhart <lockhart@alumni.caltech.edu> — 2000-01-21T15:06:40Z

Mark Hollomon wrote:
> 
> If anyone cares, here is what I had to do to build the postgresql
> documentation on a Debian system.

Thanks. I've added a section on Debian to the "Doc Guide" appendix.

                     - Thomas

-- 
Thomas Lockhart				lockhart@alumni.caltech.edu
South Pasadena, California

Re: [HACKERS] Building Documentation under Debian

Thomas Lockhart <lockhart@alumni.caltech.edu> — 2000-01-21T15:16:39Z

>   >If anyone cares, here is what I had to do to build the postgresql
>   >documentation on a Debian system.
> Thomas, don't you do some hand-tweaking after the standard build?

For hardcopy, yes, to spiff up the page breaks and get the page
numbering right. But nothing gets tweaked for html...

                   - Thomas

-- 
Thomas Lockhart				lockhart@alumni.caltech.edu
South Pasadena, California

Re: [HACKERS] Building Documentation under Debian

Thomas Lockhart <lockhart@alumni.caltech.edu> — 2000-01-22T02:49:20Z

> > > 2. grab the DSSSL stuff from http://www.nwalsh.com/docbook/dsssl
> > >        and unzip it somewhere (I chose /usr/share).
> > FWIW, this stuff is available in a package as as docbook-stylesheets.
> Ah - that's what they named it. I looked for a package called dsssl.
> Where does the package install the files /usr/share, /usr/lib,
> something else?
> Thomas, change step 2 to:
> 2. install the docbook-stylesheets package
>         apt-get install docbook-stylesheets
> drop the unzip package from step 1.

Actually, unless there is an objection I'll add the
docbook-stylesheets package but will retain mention of the Norm Walsh
zip files since these are usually a bit more up to date than those in
a packaged distro. I use them on my Linux box even though there are
rpms available...

                     - Thomas

-- 
Thomas Lockhart				lockhart@alumni.caltech.edu
South Pasadena, California

Re: [DOCS] Re: [HACKERS] Building Documentation under Debian

Peter Eisentraut <peter_e@gmx.net> — 2000-01-23T01:29:16Z

On 2000-01-22, Thomas Lockhart mentioned:

> > > > 2. grab the DSSSL stuff from http://www.nwalsh.com/docbook/dsssl
> > > >        and unzip it somewhere (I chose /usr/share).
> > > FWIW, this stuff is available in a package as as docbook-stylesheets.
> > Ah - that's what they named it. I looked for a package called dsssl.
> > Where does the package install the files /usr/share, /usr/lib,
> > something else?
> > Thomas, change step 2 to:
> > 2. install the docbook-stylesheets package
> >         apt-get install docbook-stylesheets
> > drop the unzip package from step 1.
> 
> Actually, unless there is an objection I'll add the
> docbook-stylesheets package but will retain mention of the Norm Walsh
> zip files since these are usually a bit more up to date than those in
> a packaged distro. I use them on my Linux box even though there are
> rpms available...

I think a lot of people found sgmltools to work for them (and perhaps a
lot more would, if they knew about it). That way you don't have to get
five different things and tune them to each other.

-- 
Peter Eisentraut                  Sernanders väg 10:115
peter_e@gmx.net                   75262 Uppsala
http://yi.org/peter-e/            Sweden

Re: [DOCS] Re: [HACKERS] Building Documentation under Debian

Thomas Lockhart <lockhart@alumni.caltech.edu> — 2000-01-24T15:15:06Z

> I think a lot of people found sgmltools to work for them (and perhaps a
> lot more would, if they knew about it). That way you don't have to get
> five different things and tune them to each other.

Currently, sgmltools is in an essentially unsupported state. Cees De
Groot has tried to enlist additional developers, to no avail, and has
resigned. 

But if someone has a procedure to install sgmltools and can give the
mods for the makefiles we already have I'll be happy to put it in the
docs.

                       - Thomas

-- 
Thomas Lockhart				lockhart@alumni.caltech.edu
South Pasadena, California