Next: @cite{reference}, Previous: @inforef: Cross-references to Info-only Material, Up: Cross-references [Contents][Index]
@url, @uref{url[, text][, replacement]}@url produces a reference to a uniform resource locator
(url). It takes one mandatory argument, the url, and two optional
arguments which control the text that is displayed. In HTML and PDF
output, @url produces a link you can follow. (To merely
indicate a url without creating a link people can follow, use
@indicateurl, see @indicateurl{uniform-resource-locator}.)
@uref is a synonym for @url.
(Originally, @url had the meaning of @indicateurl
and @uref was required to produce a working link, but
in practice @url was almost always misused. So we’ve changed
the meaning.)
The second argument, if specified, is the text to display (the default is the url itself); in Info, DVI, and PDF output, but not in HTML output, the url is output in addition to this text.
The third argument, if specified, is the text to display, but in this case the url is not output in any format. This is useful when the text is already sufficiently referential, as in a man page. Also, if the third argument is given, the second argument is ignored.