| Server IP : 103.119.228.120 / Your IP : 18.219.207.11 Web Server : Apache System : Linux v8.techscape8.com 3.10.0-1160.119.1.el7.tuxcare.els2.x86_64 #1 SMP Mon Jul 15 12:09:18 UTC 2024 x86_64 User : nobody ( 99) PHP Version : 5.6.40 Disable Function : shell_exec,symlink,system,exec,proc_get_status,proc_nice,proc_terminate,define_syslog_variables,syslog,openlog,closelog,escapeshellcmd,passthru,ocinum cols,ini_alter,leak,listen,chgrp,apache_note,apache_setenv,debugger_on,debugger_off,ftp_exec,dl,dll,myshellexec,proc_open,socket_bind,proc_close,escapeshellarg,parse_ini_filepopen,fpassthru,exec,passthru,escapeshellarg,escapeshellcmd,proc_close,proc_open,ini_alter,popen,show_source,proc_nice,proc_terminate,proc_get_status,proc_close,pfsockopen,leak,apache_child_terminate,posix_kill,posix_mkfifo,posix_setpgid,posix_setsid,posix_setuid,dl,symlink,shell_exec,system,dl,passthru,escapeshellarg,escapeshellcmd,myshellexec,c99_buff_prepare,c99_sess_put,fpassthru,getdisfunc,fx29exec,fx29exec2,is_windows,disp_freespace,fx29sh_getupdate,fx29_buff_prepare,fx29_sess_put,fx29shexit,fx29fsearch,fx29ftpbrutecheck,fx29sh_tools,fx29sh_about,milw0rm,imagez,sh_name,myshellexec,checkproxyhost,dosyayicek,c99_buff_prepare,c99_sess_put,c99getsource,c99sh_getupdate,c99fsearch,c99shexit,view_perms,posix_getpwuid,posix_getgrgid,posix_kill,parse_perms,parsesort,view_perms_color,set_encoder_input,ls_setcheckboxall,ls_reverse_all,rsg_read,rsg_glob,selfURL,dispsecinfo,unix2DosTime,addFile,system,get_users,view_size,DirFiles,DirFilesWide,DirPrintHTMLHeaders,GetFilesTotal,GetTitles,GetTimeTotal,GetMatchesCount,GetFileMatchesCount,GetResultFiles,fs_copy_dir,fs_copy_obj,fs_move_dir,fs_move_obj,fs_rmdir,SearchText,getmicrotime MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/local/ssl/share/doc/postgresql-9.2.24/html/ |
Upload File : |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Tool Sets</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REV="MADE"
HREF="mailto:pgsql-docs@postgresql.org"><LINK
REL="HOME"
TITLE="PostgreSQL 9.2.24 Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="Documentation"
HREF="docguide.html"><LINK
REL="PREVIOUS"
TITLE="DocBook"
HREF="docguide-docbook.html"><LINK
REL="NEXT"
TITLE="Building The Documentation"
HREF="docguide-build.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="stylesheet.css"><META
HTTP-EQUIV="Content-Type"
CONTENT="text/html; charset=ISO-8859-1"><META
NAME="creation"
CONTENT="2017-11-06T22:43:11"></HEAD
><BODY
CLASS="SECT1"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="5"
ALIGN="center"
VALIGN="bottom"
><A
HREF="index.html"
>PostgreSQL 9.2.24 Documentation</A
></TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="top"
><A
TITLE="DocBook"
HREF="docguide-docbook.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="top"
><A
HREF="docguide.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="60%"
ALIGN="center"
VALIGN="bottom"
>Appendix J. Documentation</TD
><TD
WIDTH="20%"
ALIGN="right"
VALIGN="top"
><A
TITLE="Building The Documentation"
HREF="docguide-build.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="DOCGUIDE-TOOLSETS"
>J.2. Tool Sets</A
></H1
><P
> The following tools are used to process the documentation. Some
might be optional, as noted.
<P
></P
></P><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
HREF="http://www.oasis-open.org/docbook/"
TARGET="_top"
>DocBook DTD</A
></DT
><DD
><P
> This is the definition of DocBook itself. We currently use
version 4.2; you cannot use later or earlier versions. You
need the <ACRONYM
CLASS="ACRONYM"
>SGML</ACRONYM
> variant of the DocBook DTD,
but to build man pages you also need the <ACRONYM
CLASS="ACRONYM"
>XML</ACRONYM
>
variant of the same version.
</P
></DD
><DT
><A
HREF="http://www.oasis-open.org/cover/ISOEnts.zip"
TARGET="_top"
>ISO 8879 character entities</A
></DT
><DD
><P
> These are required by DocBook but are distributed separately
because they are maintained by ISO.
</P
></DD
><DT
><A
HREF="http://wiki.docbook.org/DocBookDssslStylesheetDocs"
TARGET="_top"
>DocBook DSSSL Stylesheets</A
></DT
><DD
><P
> These contain the processing instructions for converting the
DocBook sources to other formats, such as
<ACRONYM
CLASS="ACRONYM"
>HTML</ACRONYM
>.
</P
></DD
><DT
><A
HREF="http://wiki.docbook.org/DocBookXslStylesheets"
TARGET="_top"
>DocBook XSL Stylesheets</A
></DT
><DD
><P
> This is another stylesheet for converting DocBook to other
formats. We currently use this to produce man pages and
optionally HTMLHelp. You can also use this toolchain to
produce HTML or PDF output, but official PostgreSQL releases
use the DSSSL stylesheets for that.
</P
><P
> The minimum required version is currently 1.74.0.
</P
></DD
><DT
><A
HREF="http://openjade.sourceforge.net"
TARGET="_top"
>OpenJade</A
></DT
><DD
><P
> This is the base package of <ACRONYM
CLASS="ACRONYM"
>SGML</ACRONYM
> processing.
It contains an <ACRONYM
CLASS="ACRONYM"
>SGML</ACRONYM
> parser, a
<ACRONYM
CLASS="ACRONYM"
>DSSSL</ACRONYM
> processor (that is, a program to
convert <ACRONYM
CLASS="ACRONYM"
>SGML</ACRONYM
> to other formats using
<ACRONYM
CLASS="ACRONYM"
>DSSSL</ACRONYM
> stylesheets), as well as a number of
related tools. <SPAN
CLASS="PRODUCTNAME"
>Jade</SPAN
> is now being
maintained by the OpenJade group, no longer by James Clark.
</P
></DD
><DT
><A
HREF="http://xmlsoft.org/XSLT/"
TARGET="_top"
>Libxslt</A
> for <TT
CLASS="COMMAND"
>xsltproc</TT
></DT
><DD
><P
> This is the processing tool to use with the XSLT stylesheets
(like <TT
CLASS="COMMAND"
>jade</TT
> is the processing tool for DSSSL
stylesheets).
</P
></DD
><DT
><A
HREF="http://jadetex.sourceforge.net"
TARGET="_top"
>JadeTeX</A
></DT
><DD
><P
> If you want to, you can also install
<SPAN
CLASS="PRODUCTNAME"
>JadeTeX</SPAN
> to use
<SPAN
CLASS="PRODUCTNAME"
>TeX</SPAN
> as a formatting backend for
<SPAN
CLASS="PRODUCTNAME"
>Jade</SPAN
>.
<SPAN
CLASS="APPLICATION"
>JadeTeX</SPAN
> can create PostScript or
<ACRONYM
CLASS="ACRONYM"
>PDF</ACRONYM
> files (the latter with bookmarks).
</P
><P
> However, the output from <SPAN
CLASS="APPLICATION"
>JadeTeX</SPAN
> is
inferior to what you get from the <ACRONYM
CLASS="ACRONYM"
>RTF</ACRONYM
>
backend. Particular problem areas are tables and various
artifacts of vertical and horizontal spacing. Also, there is
no opportunity to manually polish the results.
</P
></DD
></DL
></DIV
><P>
</P
><P
> We have documented experience with several installation methods for
the various tools that are needed to process the documentation.
These will be described below. There might be some other packaged
distributions for these tools. Please report package status to the
documentation mailing list, and we will include that information
here.
</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN155009"
>J.2.1. <SPAN
CLASS="PRODUCTNAME"
>Linux</SPAN
> <ACRONYM
CLASS="ACRONYM"
>RPM</ACRONYM
> Installation</A
></H2
><P
> Most vendors provide a complete RPM set for DocBook processing in
their distribution. Look for an <SPAN
CLASS="QUOTE"
>"SGML"</SPAN
> option while
installing, or the following packages:
<TT
CLASS="FILENAME"
>sgml-common</TT
>, <TT
CLASS="FILENAME"
>docbook</TT
>,
<TT
CLASS="FILENAME"
>stylesheets</TT
>, <TT
CLASS="FILENAME"
>openjade</TT
>
(or <TT
CLASS="FILENAME"
>jade</TT
>). Possibly
<TT
CLASS="FILENAME"
>sgml-tools</TT
> will be needed as well. If your
distributor does not provide these then you should be able to make
use of the packages from some other, reasonably compatible vendor.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN155021"
>J.2.2. FreeBSD Installation</A
></H2
><P
> The FreeBSD Documentation Project is itself a heavy user of
DocBook, so it comes as no surprise that there is a full set of
<SPAN
CLASS="QUOTE"
>"ports"</SPAN
> of the documentation tools available on
FreeBSD. The following ports need to be installed to build the
documentation on FreeBSD.
<P
></P
></P><UL
><LI
><P
><TT
CLASS="FILENAME"
>textproc/sp</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>textproc/openjade</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>textproc/iso8879</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>textproc/dsssl-docbook-modular</TT
></P
></LI
><LI
><P
><TT
CLASS="FILENAME"
>textproc/docbook-420</TT
></P
></LI
></UL
><P>
</P
><P
> A number of things from <TT
CLASS="FILENAME"
>/usr/ports/print</TT
>
(<TT
CLASS="FILENAME"
>tex</TT
>, <TT
CLASS="FILENAME"
>jadetex</TT
>) might
also be of interest.
</P
><P
> It's possible that the ports do not update the main catalog file
in <TT
CLASS="FILENAME"
>/usr/local/share/sgml/catalog.ports</TT
> or that the
order isn't proper. Be sure to have the following lines in the beginning
of the file:
</P><PRE
CLASS="PROGRAMLISTING"
>CATALOG "openjade/catalog"
CATALOG "iso8879/catalog"
CATALOG "docbook/dsssl/modular/catalog"
CATALOG "docbook/4.2/catalog"</PRE
><P>
If you do not want to edit the file you can also set the
environment variable <TT
CLASS="ENVAR"
>SGML_CATALOG_FILES</TT
> to a
colon-separated list of catalog files (such as the one above).
</P
><P
> More information about the FreeBSD documentation tools can be
found in the <A
HREF="http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/tools.html"
TARGET="_top"
> FreeBSD Documentation Project's instructions</A
>.
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN155051"
>J.2.3. Debian Packages</A
></H2
><P
> There is a full set of packages of the documentation tools
available for <SPAN
CLASS="PRODUCTNAME"
>Debian GNU/Linux</SPAN
>.
To install, simply use:
</P><PRE
CLASS="PROGRAMLISTING"
>apt-get install docbook docbook-dsssl docbook-xsl openjade1.3 opensp xsltproc</PRE
><P>
</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN155056"
>J.2.4. Manual Installation from Source</A
></H2
><P
> The manual installation process of the DocBook tools is somewhat
complex, so if you have pre-built packages available, use them.
We describe here only a standard setup, with reasonably standard
installation paths, and no <SPAN
CLASS="QUOTE"
>"fancy"</SPAN
> features. For
details, you should study the documentation of the respective
package, and read <ACRONYM
CLASS="ACRONYM"
>SGML</ACRONYM
> introductory material.
</P
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN155061"
>J.2.4.1. Installing OpenJade</A
></H3
><DIV
CLASS="PROCEDURE"
><OL
TYPE="1"
><LI
CLASS="STEP"
><P
> The installation of OpenJade offers a GNU-style
<TT
CLASS="LITERAL"
>./configure; make; make install</TT
> build
process. Details can be found in the OpenJade source
distribution. In a nutshell:
</P><PRE
CLASS="SYNOPSIS"
>./configure --enable-default-catalog=/usr/local/share/sgml/catalog
make
make install</PRE
><P>
Be sure to remember where you put the <SPAN
CLASS="QUOTE"
>"default
catalog"</SPAN
>; you will need it below. You can also leave
it off, but then you will have to set the environment variable
<TT
CLASS="ENVAR"
>SGML_CATALOG_FILES</TT
> to point to the file
whenever you use <SPAN
CLASS="APPLICATION"
>jade</SPAN
> later on.
(This method is also an option if OpenJade is already
installed and you want to install the rest of the toolchain
locally.)
</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
> Some users have reported encountering a segmentation fault using
OpenJade 1.4devel to build the PDFs, with a message like:
</P><PRE
CLASS="SCREEN"
>openjade:./stylesheet.dsl:664:2:E: flow object not accepted by port; only display flow objects accepted
make: *** [postgres-A4.tex-pdf] Segmentation fault</PRE
><P>
Downgrading to OpenJade 1.3 should get rid of this error.
</P
></BLOCKQUOTE
></DIV
></LI
><LI
CLASS="STEP"
><A
NAME="DOC-OPENJADE-INSTALL"
></A
><P
> Additionally, you should install the files
<TT
CLASS="FILENAME"
>dsssl.dtd</TT
>, <TT
CLASS="FILENAME"
>fot.dtd</TT
>,
<TT
CLASS="FILENAME"
>style-sheet.dtd</TT
>, and
<TT
CLASS="FILENAME"
>catalog</TT
> from the
<TT
CLASS="FILENAME"
>dsssl</TT
> directory somewhere, perhaps into
<TT
CLASS="FILENAME"
>/usr/local/share/sgml/dsssl</TT
>. It's
probably easiest to copy the entire directory:
</P><PRE
CLASS="SYNOPSIS"
>cp -R dsssl /usr/local/share/sgml</PRE
><P>
</P
></LI
><LI
CLASS="STEP"
><P
> Finally, create the file
<TT
CLASS="FILENAME"
>/usr/local/share/sgml/catalog</TT
> and add
this line to it:
</P><PRE
CLASS="PROGRAMLISTING"
>CATALOG "dsssl/catalog"</PRE
><P>
(This is a relative path reference to the file installed in
<A
HREF="docguide-toolsets.html#DOC-OPENJADE-INSTALL"
>step 2</A
>. Be sure to adjust it
if you chose your installation layout differently.)
</P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN155088"
>J.2.4.2. Installing the <SPAN
CLASS="PRODUCTNAME"
>DocBook</SPAN
> <ACRONYM
CLASS="ACRONYM"
>DTD</ACRONYM
> Kit</A
></H3
><DIV
CLASS="PROCEDURE"
><OL
TYPE="1"
><LI
CLASS="STEP"
><P
> Obtain the <A
HREF="http://www.docbook.org/sgml/4.2/docbook-4.2.zip"
TARGET="_top"
> DocBook V4.2 distribution</A
>.
</P
></LI
><LI
CLASS="STEP"
><P
> Create the directory
<TT
CLASS="FILENAME"
>/usr/local/share/sgml/docbook-4.2</TT
> and change
to it. (The exact location is irrelevant, but this one is
reasonable within the layout we are following here.)
</P><PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>$ </SAMP
><KBD
CLASS="USERINPUT"
>mkdir /usr/local/share/sgml/docbook-4.2</KBD
>
<SAMP
CLASS="PROMPT"
>$ </SAMP
><KBD
CLASS="USERINPUT"
>cd /usr/local/share/sgml/docbook-4.2</KBD
></PRE
><P>
</P
></LI
><LI
CLASS="STEP"
><P
> Unpack the archive:
</P><PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>$ </SAMP
><KBD
CLASS="USERINPUT"
>unzip -a ...../docbook-4.2.zip</KBD
></PRE
><P>
(The archive will unpack its files into the current directory.)
</P
></LI
><LI
CLASS="STEP"
><P
> Edit the file
<TT
CLASS="FILENAME"
>/usr/local/share/sgml/catalog</TT
> (or whatever
you told jade during installation) and put a line like this
into it:
</P><PRE
CLASS="PROGRAMLISTING"
>CATALOG "docbook-4.2/docbook.cat"</PRE
><P>
</P
></LI
><LI
CLASS="STEP"
><P
> Download the <A
HREF="http://www.oasis-open.org/cover/ISOEnts.zip"
TARGET="_top"
> ISO 8879 character entities archive</A
>, unpack it, and put the
files in the same directory you put the DocBook files in:
</P><PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>$ </SAMP
><KBD
CLASS="USERINPUT"
>cd /usr/local/share/sgml/docbook-4.2</KBD
>
<SAMP
CLASS="PROMPT"
>$ </SAMP
><KBD
CLASS="USERINPUT"
>unzip ...../ISOEnts.zip</KBD
></PRE
><P>
</P
></LI
><LI
CLASS="STEP"
><P
> Run the following command in the directory with the DocBook and ISO files:
</P><PRE
CLASS="PROGRAMLISTING"
>perl -pi -e 's/iso-(.*).gml/ISO\1/g' docbook.cat</PRE
><P>
(This fixes a mixup between the names used in the DocBook
catalog file and the actual names of the ISO character entity
files.)
</P
></LI
></OL
></DIV
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN155124"
>J.2.4.3. Installing the DocBook <ACRONYM
CLASS="ACRONYM"
>DSSSL</ACRONYM
> Style Sheets</A
></H3
><P
> To install the style sheets, unzip and untar the distribution and
move it to a suitable place, for example
<TT
CLASS="FILENAME"
>/usr/local/share/sgml</TT
>. (The archive will
automatically create a subdirectory.)
</P><PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>gunzip docbook-dsssl-1.<TT
CLASS="REPLACEABLE"
><I
>xx</I
></TT
>.tar.gz</KBD
>
<SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>tar -C /usr/local/share/sgml -xf docbook-dsssl-1.<TT
CLASS="REPLACEABLE"
><I
>xx</I
></TT
>.tar</KBD
></PRE
><P>
</P
><P
> The usual catalog entry in
<TT
CLASS="FILENAME"
>/usr/local/share/sgml/catalog</TT
> can also be
made:
</P><PRE
CLASS="PROGRAMLISTING"
>CATALOG "docbook-dsssl-1.<TT
CLASS="REPLACEABLE"
><I
>xx</I
></TT
>/catalog"</PRE
><P>
Because stylesheets change rather often, and it's sometimes
beneficial to try out alternative versions,
<SPAN
CLASS="PRODUCTNAME"
>PostgreSQL</SPAN
> doesn't use this catalog
entry. See <A
HREF="docguide-toolsets.html#DOCGUIDE-TOOLSETS-CONFIGURE"
>Section J.2.5</A
> for
information about how to select the stylesheets instead.
</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN155142"
>J.2.4.4. Installing <SPAN
CLASS="PRODUCTNAME"
>JadeTeX</SPAN
></A
></H3
><P
> To install and use <SPAN
CLASS="PRODUCTNAME"
>JadeTeX</SPAN
>, you will
need a working installation of <SPAN
CLASS="PRODUCTNAME"
>TeX</SPAN
> and
<SPAN
CLASS="PRODUCTNAME"
>LaTeX2e</SPAN
>, including the supported
<SPAN
CLASS="PRODUCTNAME"
>tools</SPAN
> and
<SPAN
CLASS="PRODUCTNAME"
>graphics</SPAN
> packages,
<SPAN
CLASS="PRODUCTNAME"
>Babel</SPAN
>,
<SPAN
CLASS="PRODUCTNAME"
><ACRONYM
CLASS="ACRONYM"
>AMS</ACRONYM
> fonts</SPAN
> and
<SPAN
CLASS="PRODUCTNAME"
>AMS-LaTeX</SPAN
>, the
<SPAN
CLASS="PRODUCTNAME"
><ACRONYM
CLASS="ACRONYM"
>PSNFSS</ACRONYM
></SPAN
> extension
and companion kit of <SPAN
CLASS="QUOTE"
>"the 35 fonts"</SPAN
>, the
<SPAN
CLASS="PRODUCTNAME"
>dvips</SPAN
> program for generating
<SPAN
CLASS="PRODUCTNAME"
>PostScript</SPAN
>, the macro packages
<SPAN
CLASS="PRODUCTNAME"
>fancyhdr</SPAN
>,
<SPAN
CLASS="PRODUCTNAME"
>hyperref</SPAN
>,
<SPAN
CLASS="PRODUCTNAME"
>minitoc</SPAN
>,
<SPAN
CLASS="PRODUCTNAME"
>url</SPAN
> and
<SPAN
CLASS="PRODUCTNAME"
>ot2enc</SPAN
>. All of these can be found on
your friendly neighborhood <A
HREF="http://www.ctan.org"
TARGET="_top"
> <ACRONYM
CLASS="ACRONYM"
>CTAN</ACRONYM
> site</A
>.
The installation of the <SPAN
CLASS="APPLICATION"
>TeX</SPAN
> base
system is far beyond the scope of this introduction. Binary
packages should be available for any system that can run
<SPAN
CLASS="APPLICATION"
>TeX</SPAN
>.
</P
><P
> Before you can use <SPAN
CLASS="APPLICATION"
>JadeTeX</SPAN
> with the
<SPAN
CLASS="PRODUCTNAME"
>PostgreSQL</SPAN
> documentation sources, you
will need to increase the size of
<SPAN
CLASS="APPLICATION"
>TeX</SPAN
>'s internal data structures.
Details on this can be found in the <SPAN
CLASS="APPLICATION"
>JadeTeX</SPAN
>
installation instructions.
</P
><P
> Once that is finished you can install <SPAN
CLASS="APPLICATION"
>JadeTeX</SPAN
>:
</P><PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>gunzip jadetex-<TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>.tar.gz</KBD
>
<SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>tar xf jadetex-<TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>.tar</KBD
>
<SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>cd jadetex</KBD
>
<SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>make install</KBD
>
<SAMP
CLASS="PROMPT"
>$</SAMP
> <KBD
CLASS="USERINPUT"
>mktexlsr</KBD
></PRE
><P>
The last two need to be done as <SPAN
CLASS="SYSTEMITEM"
>root</SPAN
>.
</P
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="DOCGUIDE-TOOLSETS-CONFIGURE"
>J.2.5. Detection by <TT
CLASS="COMMAND"
>configure</TT
></A
></H2
><P
> Before you can build the documentation you need to run the
<TT
CLASS="FILENAME"
>configure</TT
> script as you would when building
the <SPAN
CLASS="PRODUCTNAME"
>PostgreSQL</SPAN
> programs themselves.
Check the output near the end of the run, it should look something
like this:
</P><PRE
CLASS="SCREEN"
><SAMP
CLASS="COMPUTEROUTPUT"
>checking for onsgmls... onsgmls
checking for openjade... openjade
checking for DocBook V4.2... yes
checking for DocBook stylesheets... /usr/share/sgml/docbook/stylesheet/dsssl/modular
checking for collateindex.pl... /usr/bin/collateindex.pl
checking for xsltproc... xsltproc
checking for osx... osx</SAMP
></PRE
><P>
If neither <TT
CLASS="FILENAME"
>onsgmls</TT
> nor
<TT
CLASS="FILENAME"
>nsgmls</TT
> were found then some of the following tests
will be skipped. <TT
CLASS="FILENAME"
>nsgmls</TT
> is part of the Jade
package. You can pass the environment variables
<TT
CLASS="ENVAR"
>JADE</TT
> and <TT
CLASS="ENVAR"
>NSGMLS</TT
> to configure to point
to the programs if they are not found automatically. If
<SPAN
CLASS="QUOTE"
>"DocBook V4.2"</SPAN
> was not found then you did not install
the DocBook DTD kit in a place where Jade can find it, or you have
not set up the catalog files correctly. See the installation hints
above. The DocBook stylesheets are looked for in a number of
relatively standard places, but if you have them some other place
then you should set the environment variable
<TT
CLASS="ENVAR"
>DOCBOOKSTYLE</TT
> to the location and rerun
<TT
CLASS="FILENAME"
>configure</TT
> afterwards.
</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="docguide-docbook.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="docguide-build.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>DocBook</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="docguide.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Building The Documentation</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>