Skip site navigation (1) Skip section navigation (2)

Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches

From: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-docs(at)postgreSQL(dot)org
Subject: Re: [COMMITTERS] pgsql: Use DocBook XSL stylesheets for man page building This switches
Date: 2009-08-05 19:34:45
Message-ID: 20090805193445.GJ6518@alvh.no-ip.org (view raw or flat)
Thread:
Lists: pgsql-committerspgsql-docspgsql-hackers
Tom Lane wrote:
> petere(at)postgresql(dot)org (Peter Eisentraut) writes:
> > Use DocBook XSL stylesheets for man page building
> 
> I tried "make man" on my Fedora 10 machine.  It built stuff, but:
> 
> * I see it claiming to be making manpages for the SPI functions and
> dblink functions, eg
> 
> Note: meta manvol : no refentry/refmeta/manvolnum                  dblink_connect
> Note: meta manvol : see http://docbook.sf.net/el/manvolnum         dblink_connect
> Note: Writing man1/dblink_connect.1
> 
> but no output file actually appears.  And why is it dropping this stuff
> in section 1, wouldn't 3 be more appropriate?

Committed -- the dblink pages are still the same though.

The reason the files they don't show up is that they are being
removed by a "rm" call in the makefile.  And they are in section 1
because they are missing a <manvolnum> tag.

The SPI pages could use some SEE ALSO entries, but I ran out of time
halfway through writing that.  Maybe later.

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

In response to

Responses

pgsql-docs by date

Next:From: Peter EisentrautDate: 2009-08-06 10:20:17
Subject: Re: "make install" in doc/
Previous:From: Alvaro HerreraDate: 2009-08-05 19:17:03
Subject: "make install" in doc/

pgsql-hackers by date

Next:From: Pavel StehuleDate: 2009-08-05 19:38:13
Subject: Re: the case for machine-readable error fields
Previous:From: Tom LaneDate: 2009-08-05 19:29:52
Subject: Re: the case for machine-readable error fields

pgsql-committers by date

Next:From: User BmomjianDate: 2009-08-06 03:27:38
Subject: pg-migrator - pg_migrator: Properly error out for arrays, composites,
Previous:From: Alvaro HerreraDate: 2009-08-05 19:31:50
Subject: pgsql: Fix manpages related to SPI functions.

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group