On Tue, Feb 19, 2019 at 07:29:10PM +0100, Akim Demaille wrote: > Hi guys! > > The version of Texinfo I have (and the current source according to > http://git.savannah.gnu.org/cgit/texinfo.git/tree/doc/texinfo.texi) are > confusing about @url: > > > > 6.10.1 '@url' Examples > > ---------------------- > > > > First, here is an example of the simplest form of '@url', with just one > > argument. The given url is both the target and the visible text of the > > link: > > > > The official GNU ftp site is @uref{http://ftp.gnu.org/gnu}. > > > > produces: > > The official GNU ftp site is <http://ftp.gnu.org/gnu>. > > > > Two-argument form of '@url' > > ........................... > > > > Here is an example of the two-argument form: > > The official @uref{http://ftp.gnu.org/gnu, GNU ftp site} > > holds programs and texts. > > There is a continuous mix between @url and @uref. Eventually, it's unclear > which one is recommended. The source file says > > @node @code{@@url} > @section @code{@@url}, @code{@@uref@{@var{url}[, @var{text}][, > @var{replacement}]@}} > > @anchor{uref}@c old name > @findex uref > @cindex Uniform resource locator, referring to > @cindex URL, referring to > > so I guess we are expected to prefer @url to @uref (according to the @c > comment), but it's not very clearly stated.
Yes, this is confusion. I propose we mainly document it as @url and mention that @uref is a synonym.
