Thread (10 messages) 10 messages, 4 authors, 2021-05-22

Re: [PATCH v4] help: colorize man pages

From: Felipe Contreras <hidden>
Date: 2021-05-22 20:51:56

Possibly related (same subject, not in this thread)

Jeff King wrote:
On Fri, May 21, 2021 at 04:40:30PM -0500, Felipe Contreras wrote:
quoted
Jeff King wrote:
quoted
On Fri, May 21, 2021 at 01:01:35PM -0500, Felipe Contreras wrote:
quoted
quoted
I still don't understand what we gain by making this a Git feature,
What do we gain by making `git diff` output color?
Huh? Git is outputting the diff. Who else would output the color?
Do you think our users know or care which binary has the final
connection to the tty?
Yes. If we are telling them that "git help git" is using "man", which we
do, then I think they should expect it to behave like "man".
But we are not telling them.

Software is not in the business of explaining users exactly what it is
doing. Software is in the business of being useful to users, and in
order to do that it must remain as silent as possible while achieving
what the user potentially wants.

Unless we throw an advice("this command runs man"), then we are not
telling them.

If a dilligent user does `git help help` they might learn about this
fact, but we didn't tell them, they found out.
Moreover, I think that if they like colorized manpages, they'd probably
want them when running "man" themselves.
This doesn't matter.

The user might have "configured" man like this:

  man() {
      LESS_TERMCAP_md=$'\e[01;31m' \
      LESS_TERMCAP_me=$'\e[0m' \
      LESS_TERMCAP_so=$'\e[01;44;33m' \
      LESS_TERMCAP_se=$'\e[0m' \
      LESS_TERMCAP_us=$'\e[01;32m' \
      LESS_TERMCAP_ue=$'\e[0m' \
      command man "$@"
  }

Git isn't going utilize that.

Arch Linux recommends the above, and so does many online resources.

So even if it's the case what you said, that they want colorized man
pages, *and* they have man configured, that doesn't matter.

In addition, not everyone is a Linux guru. Some might want colorized man
pages, but not know how to get them.

I myself only learned it was possible to configure that about a year ago
when reading Arch Linux's installation guide. Luckily I clicked "Color
output in console", even though I thought I already had most console
software configured.

I have 20 years of experience using Linux. Some people have less.

You presume too much of our users.

And you still haven't explained how they can properly configure
colorized man pages for both man and git, in a way that works in all
distributions.

[1] https://wiki.archlinux.org/title/Color_output_in_console

-- 
Felipe Contreras
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help