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

2009-08-05 Thread Tom Lane
[email protected] (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?

* The section-7 man pages are back to being created with all-upper-case
file names.  I thought we'd agreed not to do that.

regards, tom lane

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


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

2009-08-05 Thread Alvaro Herrera
Tom Lane wrote:

> * 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?

I'm working on fixing this (the SPI part).

-- 
Alvaro Herrerahttp://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


[DOCS] "make install" in doc/

2009-08-05 Thread Alvaro Herrera
Hi,

I just noticed that "make install" inside the doc/ directory looks for
man.tar.gz in $(srcdir), which is obviously not going be found because
it's put in the builddir.

Am I missing something here, or is it simply that nobody tries this
stuff in VPATH builds?

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

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


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

2009-08-05 Thread Alvaro Herrera
Tom Lane wrote:
> [email protected] (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  tag.

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

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

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs