<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.2 2009/01/10 16:03:15 momjian Exp $ -->

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


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

<xref>
	used to link to a section without supplying text for the link;
	text comes from the link target;  has no close tag
	http://www.oasis-open.org/docbook/documentation/reference/html/xref.html

<link>
	allows link text to be supplied, requires </link>
	http://www.oasis-open.org/docbook/documentation/reference/html/link.html


linkend=
	controls the target of the link/xref

endterm=
        allows the text of the link/xref to be taken from a different 
	link target; endterm in a <link> overrides the supplied text



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


Guidelines
----------

o  Do not use endterm with <link> because the supplied text is ignored;  use
   <xref>
o  Do not use text with <ulink> so the URL appears in printed output