bug#47529: Make quoted entities stand out more in info

bug#47529: Make quoted entities stand out more in info

[scame via Bug reports for GNU Emacs, the Swiss army knife of text editors]

[-- Attachment #1: Type: text/plain, Size: 278 bytes --]

I usually find the default colors of quoted
symbols not distinctive enough in Info (see
first attachment).

How about giving it some color? (see 2nd
attachment)

The color (firebrick) is just an example
to illustrate the difference.

What do you think? Is it better?

[-- Attachment #2: bw.PNG --]
[-- Type: image/png, Size: 51707 bytes --]

[-- Attachment #3: color.PNG --]
[-- Type: image/png, Size: 52800 bytes --]

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Wed, 31 Mar 2021 19:52:01 +0000
> From:  scame via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
> 
> I usually find the default colors of quoted
> symbols not distinctive enough in Info (see
> first attachment).
> 
> How about giving it some color? (see 2nd
> attachment)

It's a face, and you can customize it if you want.

bug#47529: Make quoted entities stand out more in info

[scame via Bug reports for GNU Emacs, the Swiss army knife of text editors]

>
> It's a face, and you can customize it if you want.

Obviously I can and I do, but in this bug it's about
making  the out of the box experience more appealing.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Thu, 01 Apr 2021 07:32:31 +0000
> From: scame <laszlomail@protonmail.com>
> Cc: "47529@debbugs.gnu.org" <47529@debbugs.gnu.org>
> 
> >
> > It's a face, and you can customize it if you want.
> 
> Obviously I can and I do, but in this bug it's about
> making  the out of the box experience more appealing.

Oh, so you would like to change that face's defaults?  Then my
personal take on this is that (assuming we want to use a non-default
color in this case) the color you propose is too prominent.

bug#47529: Make quoted entities stand out more in info

[scame via Bug reports for GNU Emacs, the Swiss army knife of text editors]

>
> Oh, so you would like to change that face's defaults? Then my
> personal take on this is that (assuming we want to use a non-default
> color in this case) the color you propose is too prominent.

That color was just an example to show the difference.

BTW, how are these things decided? What is the process?

What if, for example, several possible colors are suggested
for this and one has to be chosen?

Who decides? Is there a vote for the most popular choice?

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Thu, 01 Apr 2021 07:54:47 +0000
> From: scame <laszlomail@protonmail.com>
> Cc: "47529@debbugs.gnu.org" <47529@debbugs.gnu.org>
> 
> > Oh, so you would like to change that face's defaults? Then my
> > personal take on this is that (assuming we want to use a non-default
> > color in this case) the color you propose is too prominent.
> 
> That color was just an example to show the difference.

Sure, but to get this moving in some practical direction, you (or
someone else) will have to come up with a color that will fly with
enough people to justify the change in the default definition of the
face.

> BTW, how are these things decided? What is the process?

By a lot of bikeshedding, I'm afraid.  Which is why I personally
consider this kind of discussion a big waste of time, when everyone
can customize the face to their liking.  YMMV, of course.

bug#47529: Make quoted entities stand out more in info

[scame via Bug reports for GNU Emacs, the Swiss army knife of text editors]

>
> By a lot of bikeshedding, I'm afraid. Which is why I personally
> consider this kind of discussion a big waste of time, when everyone
> can customize the face to their liking. YMMV, of course.

True, but first impression matters. Emacs' default appearance is like
it's stuck in the 80s. Emacs is from the 70s, but it doesn't mean it
can't have an appealing, polished default look.

People coming from other tools like VSCode or IntelliJ often put off
by the face Emacs shows them the first time. Of course, we can say
those who judge by first appearance are not worthy to enter the
sanctuary of Emacs, but if can show a prettier face (subjective)
then maybe less people are turned away before giving emacs a serious
try.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Thu, 01 Apr 2021 08:30:33 +0000
> From: scame <laszlomail@protonmail.com>
> Cc: "47529@debbugs.gnu.org" <47529@debbugs.gnu.org>
> 
> True, but first impression matters. Emacs' default appearance is like
> it's stuck in the 80s. Emacs is from the 70s, but it doesn't mean it
> can't have an appealing, polished default look.
> 
> People coming from other tools like VSCode or IntelliJ often put off
> by the face Emacs shows them the first time.

Emacs is unlike those other tools, in that it's infinitely more
customizable than any of them.  It is also unique in that its
development is not hierarchical, and therefore personal UI preferences
get in the way of changing the defaults according to unilateral
decisions of a single manager.  Enough said.

> if can show a prettier face (subjective) then maybe less people are
> turned away before giving emacs a serious try.

I'm skeptical because the likes of Spacemacs and Doom Emacs already
exist to fill that niche.  Given the time it typically takes us to
change the defaults, by the time we do it, those new defaults are
already "stuck in" whatever previous decade you fancy for the kind of
unflattering language people tend to use in these cases.

bug#47529: Make quoted entities stand out more in info

[Glenn Morris]

This has come up several times over the years.
It never goes anywhere. Eg six-year old open reports:
https://debbugs.gnu.org/20721
https://debbugs.gnu.org/18077 

bug#47529: [External] : bug#47529: Make quoted entities stand out more in info

[Drew Adams]

> This has come up several times over the years.
> It never goes anywhere. Eg six-year old open reports:
> https://urldefense.com/v3/__https://debbugs.gnu.org/20721__;!!GqivPVa7Brio!NL
> Gc7PBOr5pJdigXPipQEbGpL4AeTn3gDgkFGadjZOnV49HmdKDSCasujFhT1zEs$
> https://urldefense.com/v3/__https://debbugs.gnu.org/18077__;!!GqivPVa7Brio!NL
> Gc7PBOr5pJdigXPipQEbGpL4AeTn3gDgkFGadjZOnV49HmdKDSCasujHT9fwTo$

Yup.

FWIW, in info+.el I use this for quoted names:

(defface info-quoted-name               ; For '...' and `...'
  ;; But see Emacs bug #44316.  If that gets fixed then
  ;; maybe revisit this default definition somehow.
  '((((background dark))
     (:inherit info-fixed-pitch :foreground "#6B6BFFFF2C2C")) ; ~ bright green
    (((background light))
     (:inherit info-fixed-pitch :foreground "DarkViolet"))
    (t (:foreground "yellow")))
  "Face for quoted names ('...' or `...') in `info'."
  :group 'Info-Plus :group 'faces)

And this is `info-fixed-pitch', which `info-quoted-name' inherits from:

(defface info-fixed-pitch
  `((t (:inherit fixed-pitch
                 ,@(let ((family
                          (catch 'info-fixed-pitch
                            (dolist (fam  info-good-fixed-pitch-font-families)
                              (when (member fam (font-family-list))
                                (throw 'info-fixed-pitch fam))))))
                     (and family `(:family ,family))))))
  "Fixed-pitch face for Info.
The default value inherits from face `fixed-pitch'.  And if you have a
font family listed in variable `info-good-fixed-pitch-font-families',
then the face attributes of the first one you have listed there are
merged with those of face `fixed-pitch'.

By default, face `info-fixed-pitch' is inherited by faces
`info-custom-delimited',`info-double-quoted-name',
`info-isolated-quote', `info-quoted-name', `info-reference-item', and
`info-string'."
  :group 'Info-Plus :group 'faces)

bug#47529: Make quoted entities stand out more in info

[Stefan Kangas]

forcemerge 20721 47529
thanks

Glenn Morris <rgm@gnu.org> writes:

> This has come up several times over the years.
> It never goes anywhere. Eg six-year old open reports:
> https://debbugs.gnu.org/20721

Seems like the same issue, so I am merging them now.

> https://debbugs.gnu.org/18077

This might be fixed by commit 36906806cc.  I asked that question in the
bug thread.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Sat, 3 Apr 2021 18:58:43 -0500
> Cc: Eli Zaretskii <eliz@gnu.org>, scame <laszlomail@protonmail.com>, 47529@debbugs.gnu.org
> 
> > This has come up several times over the years.
> > It never goes anywhere. Eg six-year old open reports:
> > https://debbugs.gnu.org/20721
> 
> Seems like the same issue, so I am merging them now.

I don't even understand what bug#20721 is about anymore (the first
part, regarding using a newer Texinfo, was done long ago).

bug#47529: Make quoted entities stand out more in info

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

>> > This has come up several times over the years.
>> > It never goes anywhere. Eg six-year old open reports:
>> > https://debbugs.gnu.org/20721
>>
>> Seems like the same issue, so I am merging them now.
>
> I don't even understand what bug#20721 is about anymore (the first
> part, regarding using a newer Texinfo, was done long ago).

From the original bug report:

    Summary: I want the Info buffer to be colorized, so that I have enough
    visual clues to skim it quickly.  I find the Emacs provided default VERY
    disconcerting.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Sun, 4 Apr 2021 03:50:16 -0500
> Cc: rgm@gnu.org, laszlomail@protonmail.com, 47529@debbugs.gnu.org
> 
> > I don't even understand what bug#20721 is about anymore (the first
> > part, regarding using a newer Texinfo, was done long ago).
> 
> >From the original bug report:
> 
>     Summary: I want the Info buffer to be colorized, so that I have enough
>     visual clues to skim it quickly.  I find the Emacs provided default VERY
>     disconcerting.

But the discussion is about something very different.

bug#47529: Make quoted entities stand out more in info

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

>> > I don't even understand what bug#20721 is about anymore (the first
>> > part, regarding using a newer Texinfo, was done long ago).
>> 
>> >From the original bug report:
>> 
>>     Summary: I want the Info buffer to be colorized, so that I have enough
>>     visual clues to skim it quickly.  I find the Emacs provided default VERY
>>     disconcerting.
>
> But the discussion is about something very different.

Re-skimming this bug report, it seems that most of it's about something
else, and the original issue (about changing default faces) I don't
think we actually want to do anything about, so I'm closing this bug
report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#47529: Make quoted entities stand out more in info

[scame via Bug reports for GNU Emacs, the Swiss army knife of text editors]

>
> I'm skeptical because the likes of Spacemacs and Doom Emacs already
> exist to fill that niche.

Are those variants recommended on the Gnu Emacs homepage? If not
then barebones Emacs should also offer an appealing experience
in case a new user goes there from google.

> Given the time it typically takes us to
> change the defaults, by the time we do it, those new defaults are
> already "stuck in" whatever previous decade you fancy for the kind of
> unflattering language people tend to use in these cases.

The project should just ask a graphical designer from an other
free software project to create a pleasant default theme for
Emacs (including the default colors, customize, info, etc.)

It is not a task for engineers, so it should be done by somebody
who's qualified to do this job.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Thu, 01 Apr 2021 18:41:10 +0000
> From: scame <laszlomail@protonmail.com>
> Cc: "47529@debbugs.gnu.org" <47529@debbugs.gnu.org>
> 
> > I'm skeptical because the likes of Spacemacs and Doom Emacs already
> > exist to fill that niche.
> 
> Are those variants recommended on the Gnu Emacs homepage?

Does it matter?  You are seriously suggesting that people are
following our recommendations, and our recommendations only?

> If not then barebones Emacs should also offer an appealing
> experience in case a new user goes there from google.

We'd love to, but I don't think we can, given our relatively slow
release cycle and the low rate of changing long-standing defaults.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Thu, 01 Apr 2021 18:41:10 +0000
> From: scame <laszlomail@protonmail.com>
> Cc: "47529@debbugs.gnu.org" <47529@debbugs.gnu.org>
> 
> > Given the time it typically takes us to
> > change the defaults, by the time we do it, those new defaults are
> > already "stuck in" whatever previous decade you fancy for the kind of
> > unflattering language people tend to use in these cases.
> 
> The project should just ask a graphical designer from an other
> free software project to create a pleasant default theme for
> Emacs (including the default colors, customize, info, etc.)
> 
> It is not a task for engineers, so it should be done by somebody
> who's qualified to do this job.

You assume that such a person will come up with something that will be
accepted by others much easier and faster?

bug#47529: Make quoted entities stand out more in info

[scame via Bug reports for GNU Emacs, the Swiss army knife of text editors]

>
> You assume that such a person will come up with something that will be
> accepted by others much easier and faster?

If the designer knows his stuff then coming up with a pleasant default
theme is not hard for him. As for acceptance the engineers should accept
the result without much fuss if they tasked the designer with creating the
design in the first place.

This should be no problem for seasoned users, because they don't have to
use the default, they can set their own colors as you pointed out earlier.

And new users then could see appealing defaults when they first encounter
emacs.

bug#47529: Make quoted entities stand out more in info

[Eli Zaretskii]

> Date: Thu, 01 Apr 2021 19:07:49 +0000
> From: scame <laszlomail@protonmail.com>
> Cc: "47529@debbugs.gnu.org" <47529@debbugs.gnu.org>
> 
> > You assume that such a person will come up with something that will be
> > accepted by others much easier and faster?
> 
> If the designer knows his stuff then coming up with a pleasant default
> theme is not hard for him. As for acceptance the engineers should accept
> the result without much fuss if they tasked the designer with creating the
> design in the first place.

Having some experience working with graphical designers, I envy your
optimism.