@@ -7,8 +7,8 @@ Intra-document Linking
77----------------------
88
99<xref>
10- use to getlink text from the title of the target link; has no
11- close tag
10+ use to getchapter/section # from the title of the target
11+ link, or xreflabel if defined at the target; has no close tag
1212http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
1313
1414<link>
@@ -28,7 +28,8 @@ External Linking
2828
2929<ulink>
3030like <link>, but uses a URL (not a document target); requires
31- </ulink>; if no text is specified, the URL appears as the link text
31+ </ulink>; if no text is specified, the URL appears as the link
32+ text
3233http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html
3334
3435url=
@@ -40,4 +41,5 @@ Guidelines
4041
4142o If you want to supply text, use <link>, else <xref>
4243o Do not use text with <ulink> so the URL appears in printed output
43- o You can supply text at the target location with 'xreflabel'
44+ o Specific nouns like GUC variables, SQL commands, and contrib modules
45+ usually have xreflabels