1
0
mirror of https://github.com/postgres/postgres.git synced 2025-07-28 23:42:10 +03:00

Use DocBook XSL stylesheets for man page building

This switches the man page building process to use the DocBook XSL stylesheet
toolchain.  The previous targets for Docbook2X are removed. configure has been
updated to look for the new tools.  The Documentation appendix contains the
new build instructions.  There are also a few isolated tweaks in the
documentation to improve places that came out strangely in the man pages.
This commit is contained in:
Peter Eisentraut
2009-08-04 22:04:37 +00:00
parent b1732111f2
commit c29d7f02c2
10 changed files with 270 additions and 189 deletions

View File

@ -1,4 +1,4 @@
# $PostgreSQL: pgsql/config/docbook.m4,v 1.10 2008/11/26 11:26:54 petere Exp $
# $PostgreSQL: pgsql/config/docbook.m4,v 1.11 2009/08/04 22:04:37 petere Exp $
# PGAC_PROG_JADE
# --------------
@ -97,32 +97,3 @@ if test -n "$DOCBOOKSTYLE"; then
else
AC_PATH_PROGS(COLLATEINDEX, collateindex.pl)
fi])# PGAC_PATH_COLLATEINDEX
# PGAC_PATH_DOCBOOK2MAN
# ---------------------
# Find docbook2man program from the docbook2X package. Upstream calls
# this program docbook2man, but there is also a different docbook2man
# out there from the docbook-utils package. Thus, the program we want
# is called docbook2x-man on Debian and db2x_docbook2man on Fedora.
#
# (Consider rewriting this macro using AC_PATH_PROGS_FEATURE_CHECK
# when switching to Autoconf 2.62+.)
AC_DEFUN([PGAC_PATH_DOCBOOK2MAN],
[AC_CACHE_CHECK([for docbook2man], [ac_cv_path_DOCBOOK2MAN],
[if test -z "$DOCBOOK2MAN"; then
_AS_PATH_WALK([],
[for ac_prog in docbook2x-man db2x_docbook2man docbook2man; do
ac_path="$as_dir/$ac_prog"
AS_EXECUTABLE_P(["$ac_path"]) || continue
if "$ac_path" --version 2>/dev/null | $GREP docbook2x >/dev/null 2>&1; then
ac_cv_path_DOCBOOK2MAN=$ac_path
break
fi
done])
else
ac_cv_path_DOCBOOK2MAN=$DOCBOOK2MAN
fi])
DOCBOOK2MAN=$ac_cv_path_DOCBOOK2MAN
AC_SUBST(DOCBOOK2MAN)
])# PGAC_PATH_DOCBOOK2MAN