From: Eli Zaretskii <eliz@gnu.org>
To: scame <laszlomail@protonmail.com>
Cc: 46926@debbugs.gnu.org, larsi@gnus.org, stefan@marxist.se, rms@gnu.org
Subject: bug#46926: Remove the quotes from highlighted/linked symbols when displaying docs
Date: Sat, 13 Mar 2021 09:43:29 +0200 [thread overview]
Message-ID: <83czw3jy72.fsf@gnu.org> (raw)
In-Reply-To: <pzzWqk9uP1eKgl-08VIMD02hiA7SZMYD0EZ5EH10oWeq5JJ_sJKK69x43yhjMiuWdPRsnVegQqYCd9ZtPqNezbWMyCIV773uqlCHAHAmStg=@protonmail.com> (bug-gnu-emacs@gnu.org)
> Cc: "46926@debbugs.gnu.org" <46926@debbugs.gnu.org>,
> "larsi@gnus.org" <larsi@gnus.org>, Stefan Kangas <stefan@marxist.se>
> Date: Sat, 13 Mar 2021 06:08:31 +0000
> From: scame via "Bug reports for GNU Emacs,
> the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
>
> >
> > The purpose of quotes in Texinfo output is to make semantic
> > distinctions. In other words, to show what kind of role that text
> > plays in the program being documented.
>
> In the main body of the Help text only symbols are linked AFAIK. Is
> that right?
>
> So the quotes don't convey any extra meaning and the symbols are linked,
> so they can be clicked to instantly see their documentation. The quotes
> are just extra noise in the rendered output, breaking the visual flow of
> the text unnecessarily.
Help buffers are not directly related to Texinfo. However, we had
already some complaints in the past about the differences between
those two, so I think it would make sense not to make them diverge any
further.
Your opinion that the quotes are visual noise is noted (you expressed
it several times already), but it doesn't mean we must accept it.
Since the quotes are present in the original doc strings (and will
stay there, for sure), the implementation of your proposal would be to
remove them when we generate the "buttons" (a.k.a. "links") for them
in the Help buffer. So, if people feel that removing the quotes could
be desired by some users, how about making it optional, by default
off?
next prev parent reply other threads:[~2021-03-13 7:43 UTC|newest]
Thread overview: 49+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-03-04 16:57 bug#46926: Remove the quotes from highlighted/linked symbols when displaying docs scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-04 17:19 ` Eli Zaretskii
2021-03-04 17:50 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-04 18:36 ` Eli Zaretskii
2021-03-04 19:08 ` bug#46926: [External] : " Drew Adams
2021-03-04 20:23 ` Lars Ingebrigtsen
2021-03-04 21:40 ` bug#46926: [External] : " Drew Adams
2021-03-12 1:38 ` Stefan Kangas
2021-03-13 5:50 ` Richard Stallman
2021-03-13 6:08 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-13 7:02 ` Stefan Kangas
2021-03-13 7:44 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-13 7:43 ` Eli Zaretskii [this message]
2021-03-13 7:51 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-13 8:39 ` Eli Zaretskii
2021-03-13 16:24 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-13 16:36 ` Eli Zaretskii
2021-03-13 17:05 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-13 17:08 ` Eli Zaretskii
2021-03-15 17:28 ` Dmitry Gutov
2021-03-15 17:51 ` Eli Zaretskii
2021-03-15 23:20 ` Dmitry Gutov
2021-03-16 2:37 ` Stefan Kangas
2021-03-16 3:36 ` Eli Zaretskii
2021-03-16 3:51 ` Stefan Kangas
2021-03-16 12:36 ` Eli Zaretskii
2021-03-16 13:01 ` Gregory Heytings
2021-03-16 13:28 ` Eli Zaretskii
2021-03-16 16:27 ` Gregory Heytings
2021-03-16 23:12 ` Lars Ingebrigtsen
2021-03-17 6:00 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-17 13:09 ` Eli Zaretskii
2021-03-17 15:53 ` bug#46926: [External] : " Drew Adams
2021-03-16 15:41 ` Dmitry Gutov
2021-03-16 18:44 ` Eli Zaretskii
2021-03-16 3:32 ` Eli Zaretskii
2021-03-16 15:45 ` Dmitry Gutov
2021-03-16 15:49 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-06-20 0:25 ` Lars Ingebrigtsen
2021-03-13 17:06 ` Stefan Kangas
2021-03-13 18:27 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-14 6:02 ` Richard Stallman
2021-03-04 20:31 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-04 17:58 ` bug#46926: [External] : " Drew Adams
2021-03-04 18:40 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-04 19:26 ` Drew Adams
2021-03-04 20:36 ` scame via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-03-06 5:11 ` Richard Stallman
2021-03-14 20:36 ` bug#46926: Remove quotes from the highlighted symbols list Aleksandr Petrosyan
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=83czw3jy72.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=46926@debbugs.gnu.org \
--cc=larsi@gnus.org \
--cc=laszlomail@protonmail.com \
--cc=rms@gnu.org \
--cc=stefan@marxist.se \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).