public inbox for [email protected]help / color / mirror / Atom feed
New 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]> 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-10 16:59 Alvaro Herrera <[email protected]> parent: Peter Eisentraut <[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-10 17:10 Devrim GÜNDÜZ <[email protected]> parent: Alvaro Herrera <[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-26 11:32 Peter Eisentraut <[email protected]> parent: 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-26 14:36 Devrim GÜNDÜZ <[email protected]> parent: Peter Eisentraut <[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