GNU bug report logs - #36368
27.0.50; @uref{} @url{} misusage?

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 36368 in the body.
You can then email your comments to 36368 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Katsumi Yamaoka <yamaoka <at> jpl.org>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.0.50; @uref{} @url{} misusage?
Date: Tue, 25 Jun 2019 10:26:26 +0900

The three texi files auth.texi, cc-mode.texi, and tramp.texi in
the doc/misc/ directory use this kind of markup:

@uref{https://www.example.com/,,description}  ...[1]

This produces only "description", the url nor the link doesn't
appear in the info file.  Shouldn't it use a single "," not ",,"?

[1] in tramp.texi @url is used instead in the @footnote{}.

Message #8 received at 36368 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Katsumi Yamaoka <yamaoka <at> jpl.org>
Cc: 36368 <at> debbugs.gnu.org
Subject: Re: bug#36368: 27.0.50; @uref{} @url{} misusage?
Date: Tue, 25 Jun 2019 18:04:59 +0300

> Date: Tue, 25 Jun 2019 10:26:26 +0900
> From: Katsumi Yamaoka <yamaoka <at> jpl.org>
> 
> The three texi files auth.texi, cc-mode.texi, and tramp.texi in
> the doc/misc/ directory use this kind of markup:
> 
> @uref{https://www.example.com/,,description}  ...[1]
> 
> This produces only "description", the url nor the link doesn't
> appear in the info file.  Shouldn't it use a single "," not ",,"?

Not necessarily.  See the description in the node "@url Examples" of
the Texinfo manual.

If, after reading that, you agree that this is not a bug, please close
it.

Thanks.

Message #13 received at 36368-done <at> debbugs.gnu.org (full text, mbox):

From: Katsumi Yamaoka <yamaoka <at> jpl.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 36368-done <at> debbugs.gnu.org
Subject: Re: bug#36368: 27.0.50; @uref{} @url{} misusage?
Date: Wed, 26 Jun 2019 08:21:20 +0900

On Tue, 25 Jun 2019 18:04:59 +0300, Eli Zaretskii wrote:
[...]
>> @uref{https://www.example.com/,,description}  ...[1]

>> This produces only "description", the url nor the link doesn't
>> appear in the info file.  Shouldn't it use a single "," not ",,"?

> Not necessarily.  See the description in the node "@url Examples" of
> the Texinfo manual.

> If, after reading that, you agree that this is not a bug, please close
> it.

Ok, it's not a bug and I'm closing this.  Why I suspected it not
to be what the author wanted to do (since those urls will never
appear in at least info files) is that such expressions are just
a few cases in the texi files existing in the doc/ directory.
Overwhelming numbers of @uref, @url, and @indicateurl forms show
urls in info files:

175+94+8  @uref{url} @url{url} @indicateurl{url}
  196+20  @uref{url,desc} @url{url,desc}
     7+3  @uref{url,,desc} @url{url,,desc}

Regards,

;; I found it while translating the recent changes in auth.texi
;; into Japanese in gnus-doc-ja.  Though auth-source.el is not
;; a part of Gnus, I've been still keeping to maitain the files
;; that used to be in the Gnus repo that was separated from Emacs.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.