@@ -7,8 +7,8 @@ Intra-document Linking
7
7
----------------------
8
8
9
9
<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
12
12
http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
13
13
14
14
<link>
@@ -28,7 +28,8 @@ External Linking
28
28
29
29
<ulink>
30
30
like <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
32
33
http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html
33
34
34
35
url=
@@ -40,4 +41,5 @@ Guidelines
40
41
41
42
o If you want to supply text, use <link>, else <xref>
42
43
o 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