Commit Graph

106 Commits

Author SHA1 Message Date
Peter Eisentraut
5e5c5cd31a Merge documentation into one book. (Build with "make html".) Replace
vague cross-references with real links.
2003-03-25 16:15:44 +00:00
Peter Eisentraut
2160c9177d Add sql_features table to information schema. Generate the features list
in the documentation from that same data.
2003-01-14 23:19:34 +00:00
Bruce Momjian
22a717a18e Update build rules for /HISTORY. 2002-11-26 19:22:16 +00:00
Peter Eisentraut
b327906683 Merge release note updates from 7.3 branch. 2002-11-11 20:06:00 +00:00
Peter Eisentraut
0cd5ce6b11 Compute version number for docs on the fly. 2002-10-12 16:34:28 +00:00
Peter Eisentraut
6f4a9fb119 Add User's Guide chapters on Data Definition and Data Manipulation.
Still needs to be filled with more information, but it gives us a
framework to have a User's Guide with complete coverage of the basic
SQL operations.  Move arrays into data type chapter, inheritance into
DDL chapter (for now).

Make <comment>s show up in the output while the version number ends in
"devel".

Allow cross-book references with entities &cite-user; etc.
2002-08-05 19:43:31 +00:00
Peter Eisentraut
2e32eca8d0 Allow detection of collateindex.pl in stylesheet directory or in path,
which covers some recent installation schemes.

Add Mandrake installation layout to directories to check for stylesheets.

Allow documentation build to proceed if stylesheets were not found, in case
the stylesheets might be found through the SGML catalog mechanism.
2002-04-14 17:23:20 +00:00
Peter Eisentraut
64024d1091 Remove Jade/TeX hack, now that OpenJade 1.3.1 has it fixed. 2002-01-30 21:54:17 +00:00
Thomas G. Lockhart
2d004d7f95 Allow location of index creation perl script be be specified in
Makefile.custom, to allow finding it on Mandrake systems (at least).
2001-12-21 03:53:04 +00:00
Peter Eisentraut
cebfe90f0b Revert breakage 2001-12-10 13:07:16 +00:00
Thomas G. Lockhart
68cb184b56 Update list of currently supported platforms.
Mention SQL9x precision syntax for date/time types.
Use PostgreSQL consistantly throughout docs. Before, usage was split evenly
 between Postgres and PostgreSQL.
2001-12-08 03:24:23 +00:00
Peter Eisentraut
17f0b55d15 Initial round of tweakage for man pages 2001-11-18 20:35:02 +00:00
Peter Eisentraut
306798ded5 Use -f for rm. 2001-11-16 16:29:56 +00:00
Peter Eisentraut
e5fadc78b5 Support for images in jadetex and pdfjadetex. Formatting improvements for
lists, bibliography, index, page numbering.  Add comments.
2001-11-08 23:46:29 +00:00
Peter Eisentraut
ffb8f73890 Bunch of copy fitting and style sheet tweakage to get decent looking print
output (from pdfjadetex).  Also updated instructions to install documentation
processing toolchain.
2001-10-09 18:46:00 +00:00
Peter Eisentraut
255bd588a7 Hack for Jade vs TeX interpretation of "--" 2001-10-04 22:25:48 +00:00
Peter Eisentraut
4e77b4a548 Readd test/regress/README file, this time with a well-defined and simple
rule to remake it when necessary.
2001-09-21 18:37:05 +00:00
Peter Eisentraut
4a4abd4232 Generate index.html as the root file name of the documentation set,
rather than making index.html a symlink to the autogenerated name.
Fixes fatal problems with tar programs that don't handle symlinks
very well (MacOS X).

(The names user.html, admin.html, etc. are still available as make
targets, but they aren't packaged anymore.)

Use the manifest file that the stylesheets generate as the file list
for packaging.  Put graphics in the right place while building, not
while packaging, so you can actually look at them after building.
2001-09-18 12:08:27 +00:00
Peter Eisentraut
b1a38a4380 Install the SQL command man pages into a section appropriate for each
system.  Some systems did not understand the 'l' section, and in general
it wasn't entirely appropriate.

On SCO OpenServer, the man pages won't be installed at all until someone
figures out their man system.
2001-08-29 19:14:40 +00:00
Peter Eisentraut
01839df6dd Add index. Only some parts of the manual set have index entries so far... 2001-05-12 22:51:36 +00:00
Thomas G. Lockhart
e6767a3205 Final markup for 7.1 hardcopy release. Mostly typo and table-fitting
adjustments. Note that many tables are being abused with *really* long
 description columns. Should probably shrink those columns to be more
 concise, and move some of the info to follow-on reference notes.
2001-04-20 15:52:33 +00:00
Peter Eisentraut
b67e7bb1f7 Allow building documentation outside source tree.
from Ian Lance Taylor
2001-03-25 08:32:24 +00:00
Peter Eisentraut
7ad278817c Eliminate some hackery when creating text files (INSTALL) with a few lines
of DSSSL.
2001-03-10 16:05:35 +00:00
Peter Eisentraut
4eaa654bd6 Sync rule for making INSTALL file. 2001-03-06 20:41:06 +00:00
Peter Eisentraut
ab66098841 Didn't work when Makefile.custom is missing. 2001-02-13 21:51:17 +00:00
Peter Eisentraut
702f1235b9 Custom DSSSL stylesheet. Style changes included here:
HTML:
* make .html the default extension
* allow use of CSS stylesheet ("stylesheet.css", not included)
* make <set> TOC two levels deep
* put time of creation into meta header
Print:
* make print output justified by default
* footnotes at bottom of each page
* allow TeX to hyphenate
2001-02-13 21:27:05 +00:00
Peter Eisentraut
72813984da Must run jadetex three times to get correct page numbers. Add support for
pdfjadetex.
2001-02-04 12:23:11 +00:00
Peter Eisentraut
7c164dca0b Update, polish, consistencify preface/intro sections. 2001-02-03 19:03:27 +00:00
Peter Eisentraut
8c3d7715bc Simplify rules to build man pages so they run a lot faster and create less
noise.
2001-01-06 16:54:16 +00:00
Peter Eisentraut
c3641483c3 Merge functions and operators chapters. Lots of updates. 2000-12-14 22:30:56 +00:00
Peter Eisentraut
b2e76d570b Revive Reference Manual, remove reference pages from User's Guide.
Make version.sgml the central place for updating version numbers in the
documentation.  Document titles now contain the version number of the
release they belong to.

filelist.sgml is the central (and only) place to declare system entities
(i.e., sgml files).  No longer a need to declare them in each document
header.

There is no longer any need to maintain duplicate chapter lists in
postgres.sgml and user/admin/etc.sgml, everything is build from the same
sources.  Some parameter entities allow for different text to be included
when the integrated or a single doc set is generated, which eliminates the
problems that had caused this to fail in the past.
2000-11-24 17:44:22 +00:00
Peter Eisentraut
7267fdd7a3 Add some configure checks for DocBook and related tools. With a somewhat
standard installation layout it should be possible to build the HTML
and print documentation without additional manual setup.
2000-11-05 21:04:07 +00:00
Peter Eisentraut
0db3cb253d * doc/src/sgml/regress.sgml: Update for new driver script.
* doc/src/sgml/installation.sgml: ditto.

* src/test/regress/README: Regenerate.

* doc/src/sgml/docguide.sgml: Explain how it was done.  Explain how
INSTALL and HISTORY are (now) generated.

* doc/src/sgml/Makefile: Implement HISTORY generation to be analoguous
to INSTALL.
2000-10-17 15:26:40 +00:00
Bruce Momjian
78f69862af Rename pg-config to pg_config to be consistent with other pg commands. 2000-10-10 22:01:55 +00:00
Bruce Momjian
b32685a999 Add proofreader's changes to docs.
Fix misspelling of disbursion to dispersion.
2000-10-05 19:48:34 +00:00
Peter Eisentraut
5292637f52 Allow overriding HSTYLE and PSTYLE from environment 2000-10-05 16:57:23 +00:00
Thomas G. Lockhart
e7ac7dc689 Update to refer to more recent stylesheets in my home directory.
These stylesheets are pretty old, but the 15x series crashes FreeBSD jade.
2000-09-12 05:36:06 +00:00
Peter Eisentraut
424f0edcb8 Fix relative path references so that make knowns which dependencies refer
to one another. Sort out builddir vs srcdir variable namings. Remove some
now obsoleted make variables.
2000-08-31 16:12:35 +00:00
Peter Eisentraut
9314141116 Add pg-config utility that stores some configuration parameters other
packages can use to configure their build.

E.g.,
$ pg-config --libdir
/usr/local/pgsql/lib

`pg-config --configure' stores the configure command line.
2000-08-26 13:08:16 +00:00
Peter Eisentraut
8004bcf00e Update installation instructions to new realities. Combined into one file.
Improved automation of INSTALL file generation.
2000-07-21 00:44:13 +00:00
Peter Eisentraut
0d59dad770 Automatic dependency tracking
The .DEFAULT rule in backend/Makefile is harmful -- removed.
Replace `::' rules by `:'.
2000-07-16 14:50:44 +00:00
Peter Eisentraut
2c0edb3c86 Separated set constraints and set transaction reference pages, revised set
reference page to new configuration system. Big update to administrator's
guide, chapters Runtime environment, Client authentication, and User
management, the latter two were part of the old Security chapter.
2000-06-18 21:24:54 +00:00
Thomas G. Lockhart
45f79cae14 Fixups in content and markup for 7.0 release. 2000-05-02 20:02:03 +00:00
Peter Eisentraut
4ceb2d0cb6 * User management commands no longer user pg_exec_query_dest -> more robust
* Let unprivileged users change their own passwords.

* The password is now an Sconst in the parser, which better reflects its text datatype and also
forces users to quote them.

* If your password is NULL you won't be written to the password file, meaning you can't connect
until you have a password set up (if you use password authentication).

* When you drop a user that owns a database you get an error. The database is not gone.
2000-01-14 22:11:38 +00:00
Bruce Momjian
d7857e5713 Update. 1999-12-05 20:22:00 +00:00
Bruce Momjian
240e4c98f5 New scripts for create/drop user/db from Peter Eisentraut 1999-12-04 04:53:22 +00:00
Thomas G. Lockhart
f11bdb9db5 Allow nsgmls to validate input by defining the document type.
Use refentry.sgml as a generic header for man pages through nsgmls.
1999-08-08 04:18:29 +00:00
Thomas G. Lockhart
777a4f71f0 Remove explicit references to ref/ path in file names; use vpath instead.
Fix rules for man pages to ensure double-pass to get cross references.
Add a few new man pages.
1999-08-06 13:46:17 +00:00
Thomas G. Lockhart
07c0de7d9d Update makefile to generate man pages.
Include first cut at instructions for man pages in docguide.sgml.
Fix markup.
1999-07-06 17:19:42 +00:00
Thomas G. Lockhart
f1f9ec3344 Minor editing and markup changes as a result of preparing the Postscript
documentation for v6.4.
Bigger updates to the installation instructions (install and config).
1998-10-30 19:37:19 +00:00
Thomas G. Lockhart
2d73585028 Clean up pages. Add information for operator precedence.
Split introduction sections into separate files to allow the legal notice
 and notation sections appear in all documents without having the history
 show up everplace too.
Add full list of reserved and non-reserved key words in syntax.sgml.
Add a separate chapter to the admin guide on security.
1998-09-30 05:41:54 +00:00
Thomas G. Lockhart
dcff8232c1 Include the graphics directory in build lookup path. 1998-09-25 13:41:25 +00:00
Thomas G. Lockhart
32de56e817 Use option to jade to produce html file names from id field in tag. 1998-07-29 06:29:04 +00:00
Thomas G. Lockhart
2608ec8169 First changes for reference pages. Fix markup in the docguide. 1998-05-13 05:33:32 +00:00
Thomas G. Lockhart
68a297aad4 Try a fancier makefile. Allows real building of html and rtf output
rather than just executing ../Makefile.
1998-03-01 20:44:37 +00:00
Thomas G. Lockhart
13b2557df4 Stopgap makefile for new sgml source documentation.
Should redo this before v6.3 release if possible.
1998-03-01 08:18:09 +00:00