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