<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.1 2009/01/1004:40:08 momjian Exp $ -->

<!-- $PostgreSQL: pgsql/doc/src/sgml/README.links,v 1.2 2009/01/1016: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

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