public inbox for [email protected]
help / color / mirror / Atom feedNew XML-based man page build
5+ messages / 3 participants
[nested] [flat]
* New XML-based man page build
@ 2008-11-04 15:13 Peter Eisentraut <[email protected]>
2008-11-10 16:59 ` Re: New XML-based man page build Alvaro Herrera <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: Peter Eisentraut @ 2008-11-04 15:13 UTC (permalink / raw)
To: pgsql-docs
Following up to the recent discussion that our man page build is weird,
ancient, and only works with patched tools, I have implemented support
for using a newer toolchain based on docbook2x(.sf.net). You can try it
out by installing docbook2x and running "make manx".
Right now, I can only verify that it works on Debian. Installing this
package from sources might be pretty complicated.
The build works nicely and quickly, and if we fix up a few small
formatting artifacts and sort out the installation issues, we could
switch to using this as our standard build method.
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: New XML-based man page build
2008-11-04 15:13 New XML-based man page build Peter Eisentraut <[email protected]>
@ 2008-11-10 16:59 ` Alvaro Herrera <[email protected]>
2008-11-10 17:10 ` Re: New XML-based man page build Devrim GÜNDÜZ <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: Alvaro Herrera @ 2008-11-10 16:59 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs
Peter Eisentraut wrote:
> Following up to the recent discussion that our man page build is weird,
> ancient, and only works with patched tools, I have implemented support
> for using a newer toolchain based on docbook2x(.sf.net). You can try it
> out by installing docbook2x and running "make manx".
I just tried it and it works great. This is also Debian so I can't say
how hard it is to install docbook2x.
> The build works nicely and quickly, and if we fix up a few small
> formatting artifacts and sort out the installation issues, we could
> switch to using this as our standard build method.
What artifacts do you see? The only one I can find is that in SEE ALSO
the references to other man pages look like this:
SEE ALSO
ALTER TEXT SEARCH CONFIGURATION(), DROP TEXT SEARCH CONFIGURATION()
We should replace the spaces with _ and add the "l" section in parens.
--
Alvaro Herrera http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: New XML-based man page build
2008-11-04 15:13 New XML-based man page build Peter Eisentraut <[email protected]>
2008-11-10 16:59 ` Re: New XML-based man page build Alvaro Herrera <[email protected]>
@ 2008-11-10 17:10 ` Devrim GÜNDÜZ <[email protected]>
2008-11-26 11:32 ` Re: New XML-based man page build Peter Eisentraut <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: Devrim GÜNDÜZ @ 2008-11-10 17:10 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: Alvaro Herrera <[email protected]>; pgsql-docs
On Mon, 2008-11-10 at 13:59 -0300, Alvaro Herrera wrote:
> Peter Eisentraut wrote:
> > Following up to the recent discussion that our man page build is weird,
> > ancient, and only works with patched tools, I have implemented support
> > for using a newer toolchain based on docbook2x(.sf.net). You can try it
> > out by installing docbook2x and running "make manx".
>
> I just tried it and it works great. This is also Debian so I can't say
> how hard it is to install docbook2x.
On Fedora, package is called docbook-2X , and I had to build the docs
with:
make manx DOCBOOK2MAN=/usr/bin/db2x_docbook2man
Regards,
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org
Attachments:
[application/pgp-signature] signature.asc (197B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: New XML-based man page build
2008-11-04 15:13 New XML-based man page build Peter Eisentraut <[email protected]>
2008-11-10 16:59 ` Re: New XML-based man page build Alvaro Herrera <[email protected]>
2008-11-10 17:10 ` Re: New XML-based man page build Devrim GÜNDÜZ <[email protected]>
@ 2008-11-26 11:32 ` Peter Eisentraut <[email protected]>
2008-11-26 14:36 ` Re: New XML-based man page build Devrim GÜNDÜZ <[email protected]>
0 siblings, 1 reply; 5+ messages in thread
From: Peter Eisentraut @ 2008-11-26 11:32 UTC (permalink / raw)
To: Devrim GÜNDÜZ <[email protected]>; +Cc: pgsql-docs
Devrim GÜNDÜZ wrote:
> On Fedora, package is called docbook-2X , and I had to build the docs
> with:
>
> make manx DOCBOOK2MAN=/usr/bin/db2x_docbook2man
I have added a configure check so that this should work out of the box now.
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: New XML-based man page build
2008-11-04 15:13 New XML-based man page build Peter Eisentraut <[email protected]>
2008-11-10 16:59 ` Re: New XML-based man page build Alvaro Herrera <[email protected]>
2008-11-10 17:10 ` Re: New XML-based man page build Devrim GÜNDÜZ <[email protected]>
2008-11-26 11:32 ` Re: New XML-based man page build Peter Eisentraut <[email protected]>
@ 2008-11-26 14:36 ` Devrim GÜNDÜZ <[email protected]>
0 siblings, 0 replies; 5+ messages in thread
From: Devrim GÜNDÜZ @ 2008-11-26 14:36 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs
On Wed, 2008-11-26 at 13:32 +0200, Peter Eisentraut wrote:
> > make manx DOCBOOK2MAN=/usr/bin/db2x_docbook2man
>
> I have added a configure check so that this should work out of the box
> now.
Thanks.
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org
Attachments:
[application/pgp-signature] signature.asc (197B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2008-11-26 14:36 UTC | newest]
Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2008-11-04 15:13 New XML-based man page build Peter Eisentraut <[email protected]>
2008-11-10 16:59 ` Alvaro Herrera <[email protected]>
2008-11-10 17:10 ` Devrim GÜNDÜZ <[email protected]>
2008-11-26 11:32 ` Peter Eisentraut <[email protected]>
2008-11-26 14:36 ` Devrim GÜNDÜZ <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox