postgresql/doc/src/sgml
Tom Lane fdf2dbda3f Fix assorted corner-case bugs in contrib/intarray.
The array containment operators now behave per mathematical expectation
for empty arrays (ie, an empty array is contained in anything).
Both these operators and the query_int operators now work as expected in
GiST and GIN index searches, rather than having corner cases where the
index searches gave different answers.

Also, fix unexpected failures where the operators would claim that an array
contained nulls, when in fact there was no longer any null present (similar
to bug #5784).  The restriction to not have nulls is still there, as
removing it would take a lot of added code complexity and probably slow
things down significantly.

Also, remove the arbitrary restriction to 1-D arrays; unlike the other
restriction, this was buying us nothing performance-wise.

Assorted cosmetic improvements and marginal performance improvements, too.
2011-01-09 00:39:21 -05:00
..
ref Remove bogus claims regarding createuser defaults. 2011-01-08 06:12:05 -05:00
.gitignore Add assorted other documentation build targets to documentation gitignore. 2010-09-22 18:08:45 -04:00
acronyms.sgml Fix remaining stray references to CVS. 2010-09-22 19:51:39 -04:00
adminpack.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
advanced.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
arch-dev.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
array.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
auth-delay.sgml New contrib module, auth_delay. 2010-11-27 07:22:25 -05:00
auto-explain.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
backup.sgml Document that a CHECKPOINT before taking a file system snapshot can 2010-11-24 18:41:28 -05:00
biblio.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
bki.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
btree-gin.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
btree-gist.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
catalogs.sgml Remove pg_am.amindexnulls. 2011-01-08 16:08:05 -05:00
charset.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
chkpass.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
citext.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
client-auth.sgml Support suffix matching of host names in pg_hba.conf 2010-10-24 15:54:00 +03:00
config.sgml Force default wal_sync_method to be fdatasync on Linux. 2010-12-08 20:01:09 -05:00
contacts.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
contrib-spi.sgml Allow moddatetime's target column to be of type timestamptz. 2010-11-04 16:34:47 -04:00
contrib.sgml New contrib module, auth_delay. 2010-11-27 07:22:25 -05:00
cube.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
datatype.sgml Minor wordsmithing. 2011-01-01 17:50:31 -05:00
datetime.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
dblink.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
ddl.sgml Make title capitalization consistent with surroundings 2010-10-13 20:05:16 +03:00
dfunc.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
dict-int.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
dict-xsyn.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
diskusage.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
dml.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
docguide.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
dummy-seclabel.sgml Minor corrections to dummy_seclabel documentation. 2010-11-18 10:30:24 -05:00
earthdistance.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
ecpg.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
errcodes.sgml Corrections to patch adding SQL/MED error codes. 2010-12-26 21:35:25 -05:00
extend.sgml Correct spelling: longjump() -> longjmp(). 2010-12-24 22:22:44 -05:00
external-projects.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
features.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
filelist.sgml New contrib module, auth_delay. 2010-11-27 07:22:25 -05:00
fixrtf Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
func.sgml Improve markup of unnest example 2011-01-07 00:12:20 +02:00
fuzzystrmatch.sgml Add levenshtein_less_equal, optimized version for small distances. 2010-10-19 09:51:06 -04:00
generate_history.pl Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
geqo.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
gin.sgml Fix GIN to support null keys, empty and null items, and full index scans. 2011-01-07 19:16:24 -05:00
gist.sgml Rewrite the GiST insertion logic so that we don't need the post-recovery 2010-12-23 16:21:47 +02:00
high-availability.sgml Document pg_stat_replication, bump catversion since that was overlooked. 2011-01-07 11:06:55 -05:00
history.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
hstore.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
indexam.sgml Remove pg_am.amindexnulls. 2011-01-08 16:08:05 -05:00
indices.sgml Add external documentation for KNNGIST. 2010-12-03 23:49:06 -05:00
info.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
information_schema.sgml Implement remaining fields of information_schema.sequences view 2011-01-02 15:15:21 +02:00
install-windows.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
installation.sgml Support for collecting crash dumps on Windows 2010-12-19 16:45:28 +01:00
intagg.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
intarray.sgml Fix assorted corner-case bugs in contrib/intarray. 2011-01-09 00:39:21 -05:00
intro.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
isn.sgml Add some caveats to the contrib/isn docs. 2010-10-19 22:48:19 -04:00
jadetex.cfg Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
keywords.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
legal.sgml Stamp copyrights for year 2011. 2011-01-01 13:18:15 -05:00
libpq.sgml Fix ill-advised placement of PGRES_COPY_BOTH enum value. 2010-12-28 11:02:10 -05:00
lo.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
lobj.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
ltree.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
maintenance.sgml Fix a missed explanation of auto-analyze threshold, per Joe Miller. 2010-09-21 16:40:41 -04:00
Makefile Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
manage-ag.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
mk_feature_tables.pl Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
monitoring.sgml Document pg_stat_replication, bump catversion since that was overlooked. 2011-01-07 11:06:55 -05:00
mvcc.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
nls.sgml Fix remaining stray references to CVS. 2010-09-22 19:51:39 -04:00
notation.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
oid2name.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pageinspect.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
passwordcheck.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
perform.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgarchivecleanup.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
pgbench.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgbuffercache.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgcrypto.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgfreespacemap.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgrowlocks.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgstandby.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgstatstatements.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgstattuple.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
pgtrgm.sgml Add KNNGIST support to contrib/pg_trgm. 2010-12-04 00:16:21 -05:00
pgupgrade.sgml Use "upgrade" in preference over "migrate" in pg_upgrade messages and 2010-12-15 07:11:31 -05:00
planstats.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
plhandler.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
plperl.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
plpgsql.sgml Add new SQL function, format(text). 2010-11-20 22:33:27 -05:00
plpython.sgml plpython has plpy.Error instead of plpy.ERROR 2010-11-09 11:02:17 -03:00
pltcl.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
postgres.sgml Remove anonymous cvs instructions, and replace them with instructions 2010-09-22 20:10:28 +02:00
problems.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
protocol.sgml Fix typo 2010-12-20 12:05:12 -03:00
queries.sgml Allow WITH clauses to be attached to INSERT, UPDATE, DELETE statements. 2010-10-15 19:55:25 -04:00
query.sgml Add index entries for more functions 2010-11-24 00:00:34 +02:00
README.links Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
recovery-config.sgml Improvements to docs about pg_archive_cleanup and use of archives 2010-10-14 19:30:15 +01:00
reference.sgml Basic foreign table support. 2011-01-01 23:48:11 -05:00
regress.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
release-7.4.sgml Use a separate interpreter for each calling SQL userid in plperl and pltcl. 2010-09-30 17:18:51 -04:00
release-8.0.sgml Use a separate interpreter for each calling SQL userid in plperl and pltcl. 2010-09-30 17:18:51 -04:00
release-8.1.sgml Update release notes for releases 9.0.2, 8.4.6, 8.3.13, 8.2.19, and 8.1.23. 2010-12-13 20:22:52 -05:00
release-8.2.sgml Update release notes for releases 9.0.2, 8.4.6, 8.3.13, 8.2.19, and 8.1.23. 2010-12-13 20:22:52 -05:00
release-8.3.sgml Update release notes for releases 9.0.2, 8.4.6, 8.3.13, 8.2.19, and 8.1.23. 2010-12-13 20:22:52 -05:00
release-8.4.sgml Update release notes for releases 9.0.2, 8.4.6, 8.3.13, 8.2.19, and 8.1.23. 2010-12-13 20:22:52 -05:00
release-9.0.sgml Update release notes for releases 9.0.2, 8.4.6, 8.3.13, 8.2.19, and 8.1.23. 2010-12-13 20:22:52 -05:00
release-9.1.sgml No release notes update, just advance the date 2010-12-28 21:19:17 +02:00
release-old.sgml Fix inconsistent capitalization of "PL/pgSQL". 2010-09-22 21:57:37 -04:00
release.sgml Remove anonymous cvs instructions, and replace them with instructions 2010-09-22 20:10:28 +02:00
rowtypes.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
rules.sgml Support triggers on views. 2010-10-10 13:45:07 -04:00
runtime.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
seg.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
sourcerepo.sgml Do some copy-editing on the Git usage docs. 2010-09-22 20:22:26 -04:00
sources.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
spi.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
sql.sgml Be consistent about writing "[, ...]" instead "[,...]" in the docs. 2010-11-29 11:53:27 +02:00
sslinfo.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
standalone-install.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
start.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
storage.sgml Include the first valid listen address in pg_ctl to improve server start 2010-12-31 17:25:02 -05:00
stylesheet-common.xsl
stylesheet-fo.xsl
stylesheet-hh.xsl
stylesheet-man.xsl Extensive ECPG documentation improvements 2010-10-10 13:46:02 +03:00
stylesheet.css Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
stylesheet.dsl Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
stylesheet.xsl
syntax.sgml Prevent invoking I/O conversion casts via functional/attribute notation. 2010-11-07 13:03:19 -05:00
tablefunc.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
test-parser.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
textsearch.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
trigger.sgml Support triggers on views. 2010-10-10 13:45:07 -04:00
tsearch2.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
typeconv.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
unaccent.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
user-manag.sgml Give superusers REPLIACTION permission by default 2011-01-05 14:24:17 +01:00
uuid-ossp.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
vacuumlo.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
wal.sgml Document that BBU's do not allow partial page writes to be safely turned 2010-12-22 21:12:00 -05:00
xaggr.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
xfunc.sgml Prevent invoking I/O conversion casts via functional/attribute notation. 2010-11-07 13:03:19 -05:00
xindex.sgml Add external documentation for KNNGIST. 2010-12-03 23:49:06 -05:00
xml2.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
xoper.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00
xplang.sgml Remove cvs keywords from all files. 2010-09-20 22:08:53 +02:00
xtypes.sgml Remove useless whitespace at end of lines 2010-11-23 22:34:55 +02:00

<!-- doc/src/sgml/README.links -->

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'