Add guidelines section.
authorBruce Momjian
Sat, 10 Jan 2009 16:03:15 +0000 (16:03 +0000)
committerBruce Momjian
Sat, 10 Jan 2009 16:03:15 +0000 (16:03 +0000)
doc/src/sgml/README.links

index 961f86ea7ca4c61f8f9540c2b872a24b292b84ed..c3a93680abaaacf5bd877d670dce16806cdc8b43 100644 (file)
@@ -1,10 +1,11 @@
-
+
 
 Linking within SGML documents can be confusing, so here is a summary:
 
 
 Intra-document Linking
 ----------------------
+
 
    used to link to a section without supplying text for the link;
    text comes from the link target;  has no close tag
@@ -23,8 +24,10 @@ endterm=
    link target; endterm in a  overrides the supplied text
 
 
+
 External Linking
 ----------------
+
 
    like , but uses a URL (not a document target);  requires
    ; if no text is specified, the URL appears as the link text
@@ -32,3 +35,11 @@ External Linking
 
 url=
    used by  to specify the URL
+
+
+Guidelines
+----------
+
+o  Do not use endterm with  because the supplied text is ignored;  use
+   
+o  Do not use text with  so the URL appears in printed output