postgresql/doc/src/sgml
Alvaro Herrera 834a6da4f7 Update autovacuum to use reloptions instead of a system catalog, for
per-table overrides of parameters.

This removes a whole class of problems related to misusing the catalog,
and perhaps more importantly, gives us pg_dump support for the parameters.

Based on a patch by Euler Taveira de Oliveira, heavily reworked by me.
2009-02-09 20:57:59 +00:00
..
ref Update autovacuum to use reloptions instead of a system catalog, for 2009-02-09 20:57:59 +00:00
Makefile Append major version number and for libraries soname major version number 2008-12-11 07:34:09 +00:00
README.links Update link guidelines. 2009-01-10 16:58:39 +00:00
acronyms.sgml Rewrite the FSM. Instead of relying on a fixed-size shared memory segment, the 2008-09-30 10:52:14 +00:00
adminpack.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
advanced.sgml Fix some SGML-compiler warnings on -wxml mode. 2009-02-04 21:30:41 +00:00
arch-dev.sgml Change 'merge sort join', a phrase we use nowhere else, to the more 2007-12-12 06:23:27 +00:00
array.sgml array_length() function, and for SQL compatibility also cardinality() 2008-11-12 13:09:28 +00:00
auto-explain.sgml Tweak guc.c to allow underscores in the names of custom variable classes, 2009-01-02 01:16:02 +00:00
backup.sgml Document how pglesslog can be used to reduce the storage requirements of PITR. 2009-01-13 00:54:11 +00:00
biblio.sgml Update URL for "Generalized Partial Indexes" paper to point to a cached 2007-02-08 04:31:37 +00:00
bki.sgml Consistenly use colons before '<programlisting>' blocks, where 2007-02-01 00:28:19 +00:00
btree-gist.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
catalogs.sgml Update autovacuum to use reloptions instead of a system catalog, for 2009-02-09 20:57:59 +00:00
charset.sgml Fix markup tag error, envvar -> envar. 2008-09-24 16:30:26 +00:00
chkpass.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
citext.sgml Update citext's documentation to match the recently-applied patch, 2008-09-12 18:29:49 +00:00
client-auth.sgml Make krb_realm and krb_server_hostname be pg_hba options only, and remove 2009-01-09 10:13:19 +00:00
config.sgml Update autovacuum to use reloptions instead of a system catalog, for 2009-02-09 20:57:59 +00:00
contacts.sgml Make $PostgreSQL CVS tags consistent for SGML files. 2006-03-10 19:10:50 +00:00
contrib-spi.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
contrib.sgml Add contrib/pg_stat_statements for server-wide tracking of statement execution 2009-01-04 22:19:59 +00:00
cube.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
cvs.sgml Fix typo, noted by Stefan Kaltenbrunner. 2008-04-21 11:06:13 +00:00
datatype.sgml Add a couple of cross-references to the docs about enum types, per a 2008-12-19 01:34:19 +00:00
datetime.sgml Update docs to reflect the fact that we can now deal with DST rules 2008-02-16 21:51:04 +00:00
dblink.sgml Add refentrytitle elements to refentry pages. Their absence confused the 2008-11-12 15:52:44 +00:00
ddl.sgml Add note that not all SQL commands support ONLY in the same way. 2009-01-08 12:47:58 +00:00
dfunc.sgml Consistenly use colons before '<programlisting>' blocks, where 2007-02-01 00:28:19 +00:00
dict-int.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
dict-xsyn.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
diskusage.sgml Update documentation on may/can/might: 2007-01-31 20:56:20 +00:00
dml.sgml Entity-ify a passel of & < > characters. Per gripe from Devrim. 2007-12-03 23:49:51 +00:00
docguide.sgml Update URL to Docbook DSSSL stylesheets, per Gabriele Bartolini. 2008-11-03 15:39:38 +00:00
earthdistance.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
ecpg.sgml Desultorily enclose programlisting tags in CDATA, to get rid of some obnoxious 2008-12-07 23:46:39 +00:00
errcodes.sgml Support window functions a la SQL:2008. 2008-12-28 18:54:01 +00:00
extend.sgml Support "variadic" functions, which can accept a variable number of arguments 2008-07-16 01:30:23 +00:00
external-projects.sgml Clean up some now-obsolete references to GBorg. 2007-11-14 01:58:18 +00:00
features.sgml SQL/MED catalog manipulation facilities 2008-12-19 16:25:19 +00:00
filelist.sgml Add contrib/pg_stat_statements for server-wide tracking of statement execution 2009-01-04 22:19:59 +00:00
fixrtf Add CVS tag lines to files that were lacking them. 2006-03-11 04:38:42 +00:00
func.sgml Fix to_timestamp() to not require upper/lower case matching for meridian 2009-02-07 14:16:46 +00:00
fuzzystrmatch.sgml Add a variant of the Levenshtein string-distance function that lets the user 2008-04-03 21:13:07 +00:00
geqo.sgml Provide a bit more high-level documentation for the GEQO planner. 2007-07-21 04:02:41 +00:00
gin.sgml Update link to Oleg and Teodor's GIN page. 2008-07-22 22:05:24 +00:00
gist.sgml Push index operator lossiness determination down to GIST/GIN opclass 2008-04-14 17:05:34 +00:00
high-availability.sgml Add "Most Common Implementation" row to high availablity table so the 2008-11-19 04:46:37 +00:00
history.sgml Add note on PostgreSQL vs. Postgres. 2007-10-30 23:06:06 +00:00
hstore.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
indexam.sgml Add a new column to pg_am to specify whether an index AM supports backward 2008-10-17 22:10:30 +00:00
indices.sgml Remove documentation mention that hash indexes perform no better than 2009-02-07 20:05:44 +00:00
info.sgml Remove mention of /contrib README files from documentation because files 2008-01-09 02:37:45 +00:00
information_schema.sgml Clean up some loose ends from the column privileges patch: add 2009-02-06 21:15:12 +00:00
install-win32.sgml Change chapter titles thus: 2009-01-09 13:37:18 +00:00
installation.sgml Fix some SGML-compiler warnings on -wxml mode. 2009-02-04 21:30:41 +00:00
intagg.sgml Reduce contrib/intagg to a thin wrapper around the new core functions 2008-11-14 19:58:45 +00:00
intarray.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-10 05:32:51 +00:00
intro.sgml Revert updatable views 2009-01-27 12:40:15 +00:00
isn.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-10 05:32:51 +00:00
keywords.sgml SQL/MED catalog manipulation facilities 2008-12-19 16:25:19 +00:00
legal.sgml Update copyright for 2009. 2009-01-01 17:24:05 +00:00
libpq.sgml Fix typo in docs. 2009-02-06 19:24:12 +00:00
lo.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
lobj.sgml Desultorily enclose programlisting tags in CDATA, to get rid of some obnoxious 2008-12-07 23:46:39 +00:00
ltree.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-10 05:32:51 +00:00
maintenance.sgml Update autovacuum to use reloptions instead of a system catalog, for 2009-02-09 20:57:59 +00:00
manage-ag.sgml Move NFS section into "Creating Cluster" documentation section because 2007-11-08 15:21:03 +00:00
mk_feature_tables.pl Update feature list for SQL:2008. 2008-10-18 00:35:32 +00:00
monitoring.sgml Mention the tup_fetched column in pg_stat_database. 2008-11-11 20:06:21 +00:00
mvcc.sgml Update read committed documentation to better explain undesirable 2009-02-04 16:05:50 +00:00
nls.sgml Rewrite update-po target, so that it works less like a shell script and more 2009-01-09 10:54:08 +00:00
notation.sgml Make $PostgreSQL CVS tags consistent for SGML files. 2006-03-10 19:10:50 +00:00
oid2name.sgml Remove the -P options of oid2name and pgbench, as they are security 2007-12-11 02:31:49 +00:00
pageinspect.sgml Use fork names instead of numbers in the file names for additional 2008-10-06 14:13:17 +00:00
perform.sgml Increase the default value of default_statistics_target from 10 to 100, 2008-12-13 19:13:44 +00:00
pgbench.sgml Add a duration option to pgbench, so that test length can be specified in seconds 2008-09-11 23:52:48 +00:00
pgbuffercache.sgml pg_buffercache needs to be taught about relation forks, as Greg Stark 2008-08-14 12:56:41 +00:00
pgcrypto.sgml Typo fix. 2008-01-17 14:34:45 +00:00
pgfreespacemap.sgml Make the blkno arguments bigints instead of int4s. A signed int4 is not 2008-10-02 12:20:50 +00:00
pgrowlocks.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-10 05:32:51 +00:00
pgstandby.sgml Add documentation that pg_standby sleeps on Win32 because of 'copy' behavior. 2008-12-15 22:08:35 +00:00
pgstatstatements.sgml Add contrib/pg_stat_statements for server-wide tracking of statement execution 2009-01-04 22:19:59 +00:00
pgstattuple.sgml Adjust pgstatindex() to give correct answers for indexes larger than 2008-03-21 03:23:30 +00:00
pgtrgm.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-10 05:32:51 +00:00
planstats.sgml Update examples in planstats.sgml for 8.3, and improve some aspects of 2007-12-28 21:03:31 +00:00
plhandler.sgml Remove emacs info from footer of SGML files. 2006-09-16 00:30:20 +00:00
plperl.sgml Remove mention of DBD::PgSPI, which is unmaintained and generally unnecessary. 2008-04-10 15:16:46 +00:00
plpgsql.sgml Add PL/PgSQL FOUND and GET DIAGNOSTICS support for RETURN QUERY 2009-02-05 15:25:49 +00:00
plpython.sgml Support statement-level ON TRUNCATE triggers. Simon Riggs 2008-03-28 00:21:56 +00:00
pltcl.sgml Support statement-level ON TRUNCATE triggers. Simon Riggs 2008-03-28 00:21:56 +00:00
postgres.sgml Move Client Authentication right after Server Configuration in docs. 2008-05-07 16:36:43 +00:00
problems.sgml Remove references to pgsql-ports and pgsql-patches mailing lists from 2009-01-06 17:27:06 +00:00
protocol.sgml Add a new GUC variable called "IntervalStyle" that decouples interval output 2008-11-09 00:28:35 +00:00
queries.sgml Document that LIMIT NULL is the same as no LIMIT clause. 2009-02-07 20:11:16 +00:00
query.sgml Support window functions a la SQL:2008. 2008-12-28 18:54:01 +00:00
reference.ced
reference.sgml SQL/MED catalog manipulation facilities 2008-12-19 16:25:19 +00:00
regress.sgml Code coverage testing with gcov. Documentation is in the regression test 2008-09-05 12:11:18 +00:00
release.sgml Update back-branch release notes. 2009-01-30 00:37:29 +00:00
rowtypes.sgml Consistenly use colons before '<programlisting>' blocks, where 2007-02-01 00:28:19 +00:00
rules.sgml Fix wording of section comparing triggers and rules; old wording as 2008-12-16 03:12:08 +00:00
runtime.sgml Change chapter titles thus: 2009-01-09 13:37:18 +00:00
seg.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
sources.sgml Install a more robust solution for the problem of infinite error-processing 2008-10-27 19:37:22 +00:00
spi.sgml Add new SPI_OK_REWRITTEN return code to SPI_execute and friends, for the 2009-01-21 11:02:40 +00:00
sql.sgml Allow AS to be omitted when specifying an output column name in SELECT 2008-02-15 22:17:06 +00:00
sslinfo.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
standalone-install.sgml
start.sgml Update SELECT version() to show whether it is a 32 or 64-bit backend binary. 2009-01-06 03:05:23 +00:00
storage.sgml Use fork names instead of numbers in the file names for additional 2008-10-06 14:13:17 +00:00
stylesheet-common.xsl Reorganize XSLT stylesheet support. Put common things into a separate 2006-12-10 16:01:06 +00:00
stylesheet-fo.xsl Reorganize XSLT stylesheet support. Put common things into a separate 2006-12-10 16:01:06 +00:00
stylesheet-hh.xsl Reorganize XSLT stylesheet support. Put common things into a separate 2006-12-10 16:01:06 +00:00
stylesheet-man.xsl Experimental new support for building man pages via docbook2x, an XSL-based 2008-11-04 14:58:22 +00:00
stylesheet.css Override upstream DSSSL style sheet formatting changes 2004-06-29 20:44:34 +00:00
stylesheet.dsl Disable LOT for the time being because of TeX problems 2007-12-28 11:14:19 +00:00
stylesheet.xsl Reorganize XSLT stylesheet support. Put common things into a separate 2006-12-10 16:01:06 +00:00
syntax.sgml Fix some SGML-compiler warnings on -wxml mode. 2009-02-04 21:30:41 +00:00
tablefunc.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
test-parser.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
textsearch.sgml Create a third option named "partition" for constraint_exclusion, and make it 2009-01-07 22:40:49 +00:00
trigger.sgml Change a couple of ill-advised uses of INFO elog level to WARNINGs; in 2009-01-06 16:39:52 +00:00
tsearch2.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
typeconv.sgml Code review for function default parameters patch. Fix numerous problems as 2008-12-18 18:20:35 +00:00
user-manag.sgml Remove support for (insecure) crypt authentication. 2008-10-28 12:10:44 +00:00
uuid-ossp.sgml Make an editorial pass over the newly SGML-ified contrib documentation. 2007-12-06 04:12:10 +00:00
vacuumlo.sgml Make documentation of -W options more accurate and uniform. 2007-12-11 19:57:32 +00:00
wal.sgml Add documentation mention that full page writes have to be enabled for 2009-01-15 00:34:25 +00:00
xaggr.sgml Support window functions a la SQL:2008. 2008-12-28 18:54:01 +00:00
xfunc.sgml Code review for function default parameters patch. Fix numerous problems as 2008-12-18 18:20:35 +00:00
xindex.sgml Desultorily enclose programlisting tags in CDATA, to get rid of some obnoxious 2008-12-07 23:46:39 +00:00
xml2.sgml Fix contrib/xml2 makefile to not override CFLAGS, and in passing make it 2008-05-08 16:49:37 +00:00
xoper.sgml spell checker run 2007-11-28 15:42:31 +00:00
xplang.sgml Consistenly use colons before '<programlisting>' blocks, where 2007-02-01 00:28:19 +00:00
xtypes.sgml Desultorily enclose programlisting tags in CDATA, to get rid of some obnoxious 2008-12-07 23:46:39 +00:00

README.links

<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.3 2009/01/10 16:58:39 momjian Exp $ -->

Linking within SGML documents can be confusing, so here is a summary:


Intra-document Linking
----------------------

<xref>
	use to get link text from the title of the target link; has no
	close tag
	http://www.oasis-open.org/docbook/documentation/reference/html/xref.html

<link>
	use to supply text for the link, requires </link>
	http://www.oasis-open.org/docbook/documentation/reference/html/link.html

linkend=
	controls the target of the link/xref, required

endterm=
	for <xref>, allows the text of the link/xref to be taken from a
	different link target title


External Linking
----------------

<ulink>
	like <link>, but uses a URL (not a document target);  requires
	</ulink>; if no text is specified, the URL appears as the link text
	http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html

url=
	used by <ulink> to specify the URL, required


Guidelines
----------

o  If you want to supply text, use <link>, else <xref>
o  Do not use text with <ulink> so the URL appears in printed output
o  You can supply text at the target location with 'xreflabel'