Commit Graph

207 Commits

Author SHA1 Message Date
Alvaro Herrera 2bb4d09cac Have man page generation work on VPATH builds too. 2008-08-25 15:34:05 +00:00
Alvaro Herrera 96063da99d Make XML building work silently on VPATH builds (untested on regular builds). 2008-06-10 00:19:32 +00:00
Bruce Momjian d54ce518b3 Use clearer error message for gmake postgres.pdf:
Makefile:171: *** Invalid target;  use postgres-A4.pdf or postgres-US.pdf as targets.  Stop.
2007-12-15 10:28:21 +00:00
Peter Eisentraut 21e07f6c94 Make error message more accurate 2007-12-14 14:11:02 +00:00
Bruce Momjian 7b9526154a Add default error rules for making postgres.pdf and postgres.ps,
suggesting proper target names.
2007-12-14 13:20:30 +00:00
Peter Eisentraut a37a0a4180 Remove unused, occasionally confusing graphics building support. 2007-12-05 10:06:08 +00:00
Alvaro Herrera 2816b2cdd2 Clean up the doc makefile for draft HTML generation. It no longer works
to do "make DRAFT=Y html"; you need to use "make draft" (which was also
supported previously).
2007-10-07 00:32:11 +00:00
Alvaro Herrera 4718358fe7 Remove stylesheet.css file on "make clean", created only on VPATH builds. 2007-10-07 00:23:21 +00:00
Bruce Momjian 42e9e26066 Add comment on why SGML -wfully-tagged flag is needed (for older SGML
tool chains).
2007-08-31 16:41:52 +00:00
Bruce Momjian ac20d3dfbe Add openjade warning -wfully-tagged to warn about missing close tags on
older SGML toolchains.
2007-08-31 02:03:02 +00:00
Peter Eisentraut 2f1bf8248a Mark some intermediate targets as .PRECIOUS, to replace the recently removed
.SECONDARY target.  This makes experimentation with the PDF builds easier.
2007-05-18 15:55:03 +00:00
Neil Conway fc7de7c2cb Unbreak the SGML doc build: ":=" is needed to assign to variables if
the RHS of the assignment expands to a reference to the LHS.
2007-02-09 20:40:13 +00:00
Peter Eisentraut c138b966d4 Replace useless uses of := by = in makefiles. 2007-02-09 15:56:00 +00:00
Bruce Momjian 3ec7ae1b67 Modify SGML makefile to allow 'gmake draft' to build draft html ('draft'
is now a target, no longer a modifier).
2007-01-27 22:44:32 +00:00
Bruce Momjian adef25e5ea Control openjade draft-mode by variable DRAFT, rather than whether the
version tag is 'devel'.
2007-01-26 23:51:39 +00:00
Bruce Momjian 320abc3a95 Modify draft SGML instructions to use DRAFT=Y because recursion was
causing html to be called twice --- no way to exit the makefile after
the recursion returns.
2007-01-26 22:23:50 +00:00
Bruce Momjian ebdee66d5f Remove SGML makefile .SECONDARY tag so html rules will work properly;
Documentation/comment improvements.
2007-01-11 00:02:39 +00:00
Bruce Momjian f21d5b61ce Improve SGML build rules for non-HTML output, per Peter. 2007-01-10 19:06:04 +00:00
Bruce Momjian 125d516a7a In SGML Makefile, set proper targets for recursive calls. 2007-01-10 01:57:15 +00:00
Bruce Momjian f3a7068a54 Build SGML documention output several times if necessary to have proper
indexes;  add 'draft' option to disable it.
2007-01-09 22:19:36 +00:00
Peter Eisentraut fe733968ea Indent comments in makefiles better so they don't appear in the output. 2007-01-07 08:49:31 +00:00
Bruce Momjian 421c1ca48d Back out double-run of PDF/PS output. Requires building bookindex.sgml
properly.

Remove SGML docs about openjade performance patch, and instead add
comment in style sheet where indenting code is commented out.

Backpatch to 8.2.X.
2006-12-15 16:50:07 +00:00
Bruce Momjian 6f84d53110 Run Jade twice when outputting Postscript and PDF so the index is
correct, add comments about other multiple runs in the Makefile.

Backpatch to 8.2.X.
2006-12-15 01:20:59 +00:00
Peter Eisentraut 314c7b642b Make separate targets for building printable documentation in A4 and
US letter paper formats.
2006-12-10 20:46:03 +00:00
Peter Eisentraut 5f1f30d136 Reorganize XSLT stylesheet support. Put common things into a separate
file (instead of repeating), add XSL-FO stylesheet and appropriate make
rules.
2006-12-10 16:01:06 +00:00
Peter Eisentraut c605441c79 Generalize Texinfo rules. Prevent them from overriding the PostScript
build rules.
2006-12-10 01:53:15 +00:00
Peter Eisentraut 579c58761c Wording refinement for external references in man pages. 2006-12-02 01:26:19 +00:00
Bruce Momjian aa198e5f14 Simplify <link> regex cleanup code. 2006-10-07 23:48:52 +00:00
Bruce Momjian dc1e047baf Allow HISTORY/history.html to be generated by removing <link> elements,
per suggestion from Peter.  Without this, the main doc links prevent
those files from being built.
2006-10-07 23:28:04 +00:00
Bruce Momjian b680a1d9ad Update DB2X texinfo example code.
Andreas Seltenreich
2006-10-05 02:04:32 +00:00
Bruce Momjian 756d450313 Add experimental support for db2x texinfo
Andreas Seltenreich
2006-10-03 21:13:17 +00:00
Peter Eisentraut 0bc2a8ca65 Build src/test/regress/README during tarball making like the other
generated text files.  Fix build of that file, too.

Put the text files in the right place during make dist, so there are no
extra manual steps required anymore.
2006-04-06 18:54:37 +00:00
Peter Eisentraut 10e5a759aa Add some post-processing to the man page generation to fix up external/
dangling cross-references.
2005-01-04 21:03:30 +00:00
Peter Eisentraut fab33917f4 Clean files generated by htmlhelp target. 2004-11-23 21:41:24 +00:00
Peter Eisentraut a4cf1ba6a1 Add htmlhelp stylesheet and build target. 2004-11-23 16:27:59 +00:00
Bruce Momjian 832e6df893 Remove blank line in Makefile. 2004-03-09 20:10:10 +00:00
Bruce Momjian 66cb7e2e99 Add HISTORY/INSTALL clean target to 7.4.X. 2004-03-09 20:08:10 +00:00
Bruce Momjian e0bed412a2 Have SGML make clean remove text files output as well 2004-03-08 23:59:23 +00:00
Bruce Momjian 565b4f2de5 Use lynx -stdin and regenerate HISTORY 2004-03-06 02:52:46 +00:00
Bruce Momjian 39042637dd Oops, '-' doesn't work for my lynx either.
Change back to /dev/stdin, even though it isn't portable.  Let's wait for
someone to complain they don't have /dev/stdin.
2004-03-05 19:50:55 +00:00
Bruce Momjian 8fc7522cad Use '-' for stdin on lynx, my lynx version doesn't support -stdin. 2004-03-05 19:48:03 +00:00
Tom Lane 3811d7a08f Replace unportable use of /dev/stdin with lynx's -stdin switch. 2004-03-02 00:03:02 +00:00
Neil Conway 4a43b24cec Enable some additional warnings when running openjade and onsgmls. 2004-03-01 16:08:58 +00:00
Peter Eisentraut b89744198e Some refinement of XSLT processing: The result now looks just about as good
as the result of the SGML-based tool chain.
2004-01-15 23:51:32 +00:00
Peter Eisentraut e27d500235 Make rule and stylesheet to try out XSLT for DocBook processing 2004-01-13 18:45:19 +00:00
Bruce Momjian 34cb0f7b46 Update HISTORY and release notes for 7.4.1. 2003-12-15 22:24:59 +00:00
Peter Eisentraut 42610b1b8a Fix for vpath build 2003-12-11 22:10:51 +00:00
PostgreSQL Daemon 969685ad44 $Header: -> $PostgreSQL Changes ... 2003-11-29 19:52:15 +00:00
Peter Eisentraut cf8e916968 Set LC_ALL=C when running collateindex.pl to get predictable sort order. 2003-08-31 17:28:39 +00:00
Peter Eisentraut 3722226070 Add "override" for make variable JADEFLAGS, since upper directory passes
this variable on the command line.
2003-08-27 22:58:54 +00:00
Peter Eisentraut a6554df4f7 In an effort to reduce the total number of chapters, combine the small
chapters on extending types, operators, and aggregates into the extending
functions chapter.  Move the information on how to call table functions
into the queries chapter.  Remove some outdated information that is
already present in a better form in other parts of the documentation.
2003-04-10 01:22:45 +00:00
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