<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.7, 23 September 2019),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>@url (GNU Texinfo 6.7)</title>
<meta name="description" content="@url (GNU Texinfo 6.7)">
<meta name="keywords" content="@url (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Cross-References.html" rel="up" title="Cross References">
<link href="_0040url-Examples.html" rel="next" title="@url Examples">
<link href="_0040inforef.html" rel="prev" title="@inforef">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="g_t_0040url"></span><div class="header">
<p>
Next: <a href="_0040cite.html" accesskey="n" rel="next"><code>@cite</code></a>, Previous: <a href="_0040inforef.html" accesskey="p" rel="prev"><code>@inforef</code></a>, Up: <a href="Cross-References.html" accesskey="u" rel="up">Cross References</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="g_t_0040url_002c-_0040uref_007burl_005b_002c-text_005d_005b_002c-replacement_005d_007d"></span><h3 class="section">6.10 <code>@url</code>, <code>@uref{<var>url</var>[, <var>text</var>][, <var>replacement</var>]}</code></h3>
<span id="uref"></span><span id="url"></span><span id="index-Uniform-resource-locator_002c-referring-to"></span>
<span id="index-URL_002c-referring-to"></span>
<span id="index-url"></span>
<span id="index-href_002c-producing-HTML"></span>
<p><code>@url</code> 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, <code>@url</code> produces a link you can follow. (To merely
indicate a url without creating a link people can follow, use
<code>@indicateurl</code>, see <a href="_0040indicateurl.html"><code>@indicateurl</code></a>.)
</p>
<span id="index-uref"></span>
<p><code>@uref</code> is a synonym for <code>@url</code>.
(Originally, <code>@url</code> had the meaning of <code>@indicateurl</code>
and <code>@uref</code> was required to produce a working link, but
in practice <code>@url</code> was almost always misused. So we’ve changed
the meaning.)
</p>
<p>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.
</p>
<span id="index-Man-page_002c-reference-to"></span>
<p>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.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="_0040url-Examples.html" accesskey="1"><code>@url</code> Examples</a></td><td> </td><td align="left" valign="top">Examples of using all the forms of <code>@url</code>.
</td></tr>
<tr><td align="left" valign="top">• <a href="URL-Line-Breaking.html" accesskey="2">URL Line Breaking</a></td><td> </td><td align="left" valign="top">How lines are broken within <code>@url</code> text.
</td></tr>
<tr><td align="left" valign="top">• <a href="_0040url-PDF-Output-Format.html" accesskey="3"><code>@url</code> PDF Output Format</a></td><td> </td><td align="left" valign="top">A special option to hide links in PDF output.
</td></tr>
<tr><td align="left" valign="top">• <a href="PDF-Colors.html" accesskey="4">PDF Colors</a></td><td> </td><td align="left" valign="top">Colorizing urls and other links in PDF output.
</td></tr>
</table>
<hr>
<div class="header">
<p>
Next: <a href="_0040cite.html" accesskey="n" rel="next"><code>@cite</code></a>, Previous: <a href="_0040inforef.html" accesskey="p" rel="prev"><code>@inforef</code></a>, Up: <a href="Cross-References.html" accesskey="u" rel="up">Cross References</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>