From c0a2ff474a47216031d1835f5878fa4f445f44fe Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter@eisentraut.org>
Date: Fri, 29 Mar 2019 13:36:24 +0100
Subject: [PATCH] doc: Refine README.links further

suggested by Chapman Flack <chap@anastigmatix.net>
---
 doc/src/sgml/README.links | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links
index 388fdc6ee6..db6577d243 100644
--- a/doc/src/sgml/README.links
+++ b/doc/src/sgml/README.links
@@ -40,6 +40,10 @@ url=
 Guidelines
 ----------
 
-o  If you want to supply text, use <link>, else <xref>
-o  Specific nouns like GUC variables, SQL commands, and contrib modules
-   usually have xreflabels
+- For an internal link, if you want to supply text, use <link>, else
+  <xref>.
+
+- Specific nouns like GUC variables, SQL commands, and contrib modules
+  usually have xreflabels.
+
+- For an external link, use <ulink>, with or without link text.