Doc: CG - clarified usage for @uref syntax

diff --git a/Documentation/contributor/doc-work.itexi b/Documentation/contributor/doc-work.itexi
index c299d47d83f50672a4ab20ac1db15cab82fa3e1a..cdd06f29c9583cad82ebea24706c0a7f1250b082 100644 (file)
--- a/Documentation/contributor/doc-work.itexi
+++ b/Documentation/contributor/doc-work.itexi
@@ -539,7 +539,13 @@ the brackets (eg.@tie{}@w{@samp{@@ref@{Syntax survey@}}}).
 
 @item
 @code{@@uref@{@var{URL}[, @var{link text}]@}} --- link to an
-external url.
+external url.  Use within an @code{@@example ... @@end example}.
+
+@example
+@@example
+@@uref@{URL [, link text ]@}
+@@end example
+@end example
 @end itemize