1
0
mirror of https://github.com/postgres/postgres.git synced 2025-08-24 09:27:52 +03:00
Files
postgres/doc/src/sgml
Tom Lane 447e23737c Fix documentation about joining pg_locks to other views.
The advice to join to pg_prepared_xacts via the transaction column was not
updated when the transaction column was replaced by virtualtransaction.
Since it's not quite obvious how to do that join, give an explicit example.
For consistency also give an example for the adjacent case of joining to
pg_stat_activity.  And link-ify the view references too, just because we
can.  Per bug #9840 from Alexey Bashtanov.

Michael Paquier and Tom Lane
2014-04-03 14:18:41 -04:00
..
2010-09-20 22:08:53 +02:00
2013-10-21 06:23:31 -04:00
2011-08-17 10:05:55 +03:00
2010-09-20 22:08:53 +02:00
2013-11-27 11:15:32 +01:00
2010-09-20 22:08:53 +02:00
2013-07-19 10:54:26 -04:00
2010-09-20 22:08:53 +02:00
2012-10-17 09:20:42 +01:00
2011-09-24 14:34:58 +02:00
2013-01-20 19:38:19 -05:00
2010-09-20 22:08:53 +02:00
2014-01-07 16:05:29 -05:00
2012-01-23 21:08:46 -05:00
2012-12-08 07:38:19 -05:00
2011-02-12 15:55:18 +02:00
2011-06-19 00:39:19 +03:00
2012-03-20 15:41:38 -03:00
2013-02-25 18:00:03 -05: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 chapter/section # from the title of the target
	link, or xreflabel if defined at the target; 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  Specific nouns like GUC variables, SQL commands, and contrib modules
   usually have xreflabels