pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedBuilding Documentation under Debian
7+ messages / 4 participants
[nested] [flat]
* Building Documentation under Debian
@ 2000-01-21 13:31 Mark Hollomon <mhh@nortelnetworks.com>
0 siblings, 3 replies; 7+ messages in thread
From: Mark Hollomon @ 2000-01-21 13:31 UTC (permalink / raw)
To: pgsql-hackers@postgreSQL.org <pgsql-hackers@postgreSQL.org>
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Building Documentation under Debian
@ 2000-01-21 13:51 Oliver Elphick <olly@lfix.co.uk>
parent: Mark Hollomon <mhh@nortelnetworks.com>
2 siblings, 1 reply; 7+ messages in thread
From: Oliver Elphick @ 2000-01-21 13:51 UTC (permalink / raw)
To: Mark Hollomon <mhh@nortelnetworks.com>; +Cc: pgsql-hackers@postgreSQL.org <pgsql-hackers@postgreSQL.org>; olly@linda.lfix.co.uk
"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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Building Documentation under Debian
@ 2000-01-21 15:06 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Mark Hollomon <mhh@nortelnetworks.com>
2 siblings, 0 replies; 7+ messages in thread
From: Thomas Lockhart @ 2000-01-21 15:06 UTC (permalink / raw)
To: Mark Hollomon <mhh@nortelnetworks.com>; +Cc: pgsql-hackers@postgreSQL.org <pgsql-hackers@postgreSQL.org>
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Building Documentation under Debian
@ 2000-01-21 15:16 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Oliver Elphick <olly@lfix.co.uk>
0 siblings, 0 replies; 7+ messages in thread
From: Thomas Lockhart @ 2000-01-21 15:16 UTC (permalink / raw)
To: Oliver Elphick <olly@lfix.co.uk>; +Cc: Mark Hollomon <mhh@nortelnetworks.com>; pgsql-hackers@postgreSQL.org <pgsql-hackers@postgreSQL.org>; olly@linda.lfix.co.uk
> >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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Building Documentation under Debian
@ 2000-01-22 02:49 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Mark Hollomon <mhh@nortelnetworks.com>
2 siblings, 1 reply; 7+ messages in thread
From: Thomas Lockhart @ 2000-01-22 02:49 UTC (permalink / raw)
To: Mark Hollomon <mhh@nortelnetworks.com>; +Cc: Michael Alan Dorman <mdorman@debian.org>; Postgres Documentation List <docs@postgresql.org>
> > > 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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [DOCS] Re: [HACKERS] Building Documentation under Debian
@ 2000-01-23 01:29 Peter Eisentraut <peter_e@gmx.net>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2000-01-23 01:29 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: Mark Hollomon <mhh@nortelnetworks.com>; Michael Alan Dorman <mdorman@debian.org>; Postgres Documentation List <docs@postgresql.org>
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [DOCS] Re: [HACKERS] Building Documentation under Debian
@ 2000-01-24 15:15 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 7+ messages in thread
From: Thomas Lockhart @ 2000-01-24 15:15 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: Mark Hollomon <mhh@nortelnetworks.com>; Michael Alan Dorman <mdorman@debian.org>; Postgres Documentation List <docs@postgreSQL.org>
> 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
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2000-01-24 15:15 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2000-01-21 13:31 Building Documentation under Debian Mark Hollomon <mhh@nortelnetworks.com>
2000-01-21 13:51 ` Oliver Elphick <olly@lfix.co.uk>
2000-01-21 15:16 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-01-21 15:06 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-01-22 02:49 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-01-23 01:29 ` Peter Eisentraut <peter_e@gmx.net>
2000-01-24 15:15 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox