First changes for reference pages. Fix markup in the docguide.

doc/src/sgml/postgres.sgml

@@ -6,11 +6,14 @@
 -
 - -->
 <!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+
+<!-- tutorial -->
 <!entity intro    SYSTEM "intro.sgml">
 <!entity arch     SYSTEM "arch.sgml">
 <!entity start    SYSTEM "start.sgml">
 <!entity query    SYSTEM "query.sgml">
 
+<!-- user's guide -->
 <!entity advanced SYSTEM "advanced.sgml">
 <!entity environ  SYSTEM "environ.sgml">
 <!entity manage   SYSTEM "manage.sgml">
@@ -22,6 +25,7 @@
 <!entity psql     SYSTEM "psql.sgml">
 <!entity pgaccess SYSTEM "pgaccess.sgml">
 
+<!-- administrator's guide -->
 <!entity start-ag SYSTEM "start-ag.sgml">
 <!entity install  SYSTEM "install.sgml">
 <!entity recovery SYSTEM "recovery.sgml">
@@ -29,6 +33,7 @@
 <!entity ports    SYSTEM "ports.sgml">
 <!entity release  SYSTEM "release.sgml">
 
+<!-- programmer's guide -->
 <!entity intro-pg SYSTEM "intro-pg.sgml">
 <!entity arch-pg  SYSTEM "arch-pg.sgml">
 <!entity extend   SYSTEM "extend.sgml">
@@ -50,6 +55,12 @@
 <!entity odbc     SYSTEM "odbc.sgml">
 <!entity jdbc     SYSTEM "jdbc.sgml">
 
+<!-- reference pages -->
+<!entity intro-ref  SYSTEM "intro-ref.sgml">
+<!entity % allfiles SYSTEM "allfiles.sgml">
+%allfiles;
+
+<!-- developer's guide -->
 <!entity arch-dev SYSTEM "arch-dev.sgml">
 <!entity geqo     SYSTEM "geqo.sgml">
 <!entity protocol SYSTEM "protocol.sgml">
@@ -198,7 +209,7 @@ Information for extending <ProductName>Postgres</ProductName>.
 </Part>
 
 <Part>
-<Title>Reference</Title>
+<Title>Interfaces</Title>
 <PartIntro>
 <Para>
 User and programmer interfaces.
@@ -213,6 +224,17 @@ User and programmer interfaces.
 &jdbc;
 </Part>
 
+<Part>
+<Title>Reference</Title>
+<PartIntro>
+<Para>
+Command syntax.
+</Para>
+</PartIntro>
+<!-- &intro-ref; -->
+&commands;
+</Part>
+
 <Part>
 <Title>Developer's Guide</Title>
 <PartIntro>
@@ -242,4 +264,3 @@ Additional related information.
 <INDEX> </INDEX>
 
 </Book>
-