@uref doc policy

[Mark Polesky]

James Lowe wrote:
>  @item
>  @code{@@address@hidden@var{URL}[, @var{link address@hidden --- link to an
> -external url.
> +external url.  Use within an @code{@@example ... @@end example}.
> +
> address@hidden
> +@@example
> +@@address@hidden [, link text address@hidden
> +@@end example
> address@hidden example
>  @end itemize

Graham,
Is this a new doc policy?
http://git.savannah.gnu.org/gitweb/?p=lilypond.git;a=commitdiff;h=50a5af9

I seem to have missed the discussion.  Anyway, I think that
surrounding @urefs with @examples would disrupt the flow of
the text in many cases, for example here:
http://lilypond.org/doc/v2.13/Documentation/web/productions

- Mark