postgresql/doc/src/sgml
Peter Eisentraut 93a6be63a5 Revise the permission checking on user mapping DDL commands.
CREATE/ALTER/DROP USER MAPPING are now allowed either by the server owner or
by a user with USAGE privileges for his own user name.  This is more or less
what the SQL standard wants anyway (plus "implementation-defined")

Hide information_schema.user_mapping_options.option_value, unless the current
user is the one associated with the user mapping, or is the server owner and
the mapping is for PUBLIC, or is a superuser.  This is to protect passwords.

Also, fix a bug in information_schema._pg_foreign_servers, which hid servers
using wrappers where the current user did not have privileges on the wrapper.
The correct behavior is to hide servers where the current user has no
privileges on the server.
2009-01-20 09:10:20 +00:00
..
ref Revise the permission checking on user mapping DDL commands. 2009-01-20 09:10:20 +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 Add some basic support for window frame clauses to the window-functions 2008-12-31 00:08:39 +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 Add vacuum_freeze_table_age GUC option, to control when VACUUM should 2009-01-16 13:27:24 +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 Add vacuum_freeze_table_age GUC option, to control when VACUUM should 2009-01-16 13:27:24 +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 Change explanation of pg_switch_xlog()'s return value to match code. 2009-01-15 18:19:58 +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 Make LC_COLLATE and LC_CTYPE database-level settings. Collation and 2008-09-23 09:20:39 +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 Revise the permission checking on user mapping DDL commands. 2009-01-20 09:10:20 +00:00
install-win32.sgml Change chapter titles thus: 2009-01-09 13:37:18 +00:00
installation.sgml Change chapter titles thus: 2009-01-09 13:37:18 +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 Update documentation on may/can/might: 2007-01-31 20:56:20 +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 Modify libpq environment variable documentation to point to the relevant 2009-01-10 20:14:30 +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 Add vacuum_freeze_table_age GUC option, to control when VACUUM should 2009-01-16 13:27:24 +00:00
Makefile Append major version number and for libraries soname major version number 2008-12-11 07:34:09 +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 "Conflicting lock modes" to show as conflict, add 2007-02-18 01:21:49 +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 Modify UPDATE/DELETE WHERE CURRENT OF to use the FOR UPDATE infrastructure to 2008-11-16 17:34:28 +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 Add some basic support for window frame clauses to the window-functions 2008-12-31 00:08:39 +00:00
query.sgml Support window functions a la SQL:2008. 2008-12-28 18:54:01 +00:00
README.links Update link guidelines. 2009-01-10 16:58:39 +00:00
reference.ced Deprecate 'current' for date/time input. 2001-11-21 05:53:41 +00:00
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 release notes for 8.3.5, 8.2.11, and 8.1.15 to mention the need 2009-01-09 01:47:02 +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 Fix executor/spi.h to follow our usual conventions for include files, ie, 2009-01-07 13:44:37 +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 $Header: -> $PostgreSQL Changes ... 2003-11-29 19:52:15 +00:00
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 Throw error if a <window definition> references a window that already has a 2008-12-31 23:42:56 +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

<!-- $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'