--- Begin Message ---
Subject: |
27.0.50; @uref{} @url{} misusage? |
Date: |
Tue, 25 Jun 2019 10:26:26 +0900 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (x86_64-pc-cygwin) |
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{}.
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#36368: 27.0.50; @uref{} @url{} misusage? |
Date: |
Wed, 26 Jun 2019 08:21:20 +0900 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (x86_64-pc-cygwin) |
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.
--- End Message ---