<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Documentation</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 8.0.11 Documentation" HREF="index.html"><LINK REL="UP" TITLE="Appendixes" HREF="appendixes.html"><LINK REL="PREVIOUS" TITLE="Getting The Source Via CVSup" HREF="cvsup.html"><LINK REL="NEXT" TITLE="Tool Sets" HREF="docguide-toolsets.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="2007-02-02T03:57:22"></HEAD ><BODY CLASS="APPENDIX" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="5" ALIGN="center" VALIGN="bottom" >PostgreSQL 8.0.11 Documentation</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="cvsup.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="cvs.html" >Fast Backward</A ></TD ><TD WIDTH="60%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="top" ><A HREF="external-projects.html" >Fast Forward</A ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="top" ><A HREF="docguide-toolsets.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="APPENDIX" ><H1 ><A NAME="DOCGUIDE" ></A >Appendix G. Documentation</H1 ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT >G.1. <A HREF="docguide.html#DOCGUIDE-DOCBOOK" >DocBook</A ></DT ><DT >G.2. <A HREF="docguide-toolsets.html" >Tool Sets</A ></DT ><DT >G.3. <A HREF="docguide-build.html" >Building The Documentation</A ></DT ><DT >G.4. <A HREF="docguide-authoring.html" >Documentation Authoring</A ></DT ><DT >G.5. <A HREF="docguide-style.html" >Style Guide</A ></DT ></DL ></DIV ><P > <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > has four primary documentation formats: <P ></P ></P><UL ><LI ><P > Plain text, for pre-installation information </P ></LI ><LI ><P > <ACRONYM CLASS="ACRONYM" >HTML</ACRONYM >, for on-line browsing and reference </P ></LI ><LI ><P > PDF or Postscript, for printing </P ></LI ><LI ><P > man pages, for quick reference. </P ></LI ></UL ><P> Additionally, a number of plain-text <TT CLASS="FILENAME" >README</TT > files can be found throughout the <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > source tree, documenting various implementation issues. </P ><P > <ACRONYM CLASS="ACRONYM" >HTML</ACRONYM > documentation and man pages are part of a standard distribution and are installed by default. PDF and Postscript format documentation is available separately for download. </P ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="DOCGUIDE-DOCBOOK" >G.1. DocBook</A ></H1 ><P > The documentation sources are written in <I CLASS="FIRSTTERM" >DocBook</I >, which is a markup language superficially similar to <ACRONYM CLASS="ACRONYM" >HTML</ACRONYM >. Both of these languages are applications of the <I CLASS="FIRSTTERM" >Standard Generalized Markup Language</I >, <ACRONYM CLASS="ACRONYM" >SGML</ACRONYM >, which is essentially a language for describing other languages. In what follows, the terms DocBook and <ACRONYM CLASS="ACRONYM" >SGML</ACRONYM > are both used, but technically they are not interchangeable. </P ><P > <SPAN CLASS="PRODUCTNAME" >DocBook</SPAN > allows an author to specify the structure and content of a technical document without worrying about presentation details. A document style defines how that content is rendered into one of several final forms. DocBook is maintained by the <A HREF="http://www.oasis-open.org" TARGET="_top" >OASIS</A > group. The <A HREF="http://www.oasis-open.org/docbook" TARGET="_top" >official DocBook site</A > has good introductory and reference documentation and a complete O'Reilly book for your online reading pleasure. The <A HREF="http://www.freebsd.org/docproj/docproj.html" TARGET="_top" >FreeBSD Documentation Project</A > also uses DocBook and has some good information, including a number of style guidelines that might be worth considering. </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="cvsup.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-toolsets.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Getting The Source Via <SPAN CLASS="PRODUCTNAME" >CVSup</SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="appendixes.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Tool Sets</TD ></TR ></TABLE ></DIV ></BODY ></HTML >