From: Felipe Contreras <firstname.lastname@example.org> To: "brian m. carlson" <email@example.com>, Felipe Contreras <firstname.lastname@example.org> Cc: email@example.com, "Ævar Arnfjörð Bjarmason" <firstname.lastname@example.org>, "Junio C Hamano" <email@example.com>, "Randall S. Becker" <firstname.lastname@example.org> Subject: Re: [PATCH] help: colorize man pages Date: Mon, 17 May 2021 22:22:37 -0500 [thread overview] Message-ID: <email@example.com> (raw) In-Reply-To: <YKMWL0iZLVl1KTrB@camp.crustytoothpaste.net> brian m. carlson wrote: > On 2021-05-18 at 01:01:21, Felipe Contreras wrote: > > Our man pages don't contain many useful colors (just blue links), > > moreover, many people have groff SGR disabled, so they don't see any > > colors with man pages. > > > > We can set LESS_TERMCAP variables to render bold and underlined text > > with colors in the pager; a common trick. > > > > Bold is rendered as red, underlined as blue, and standout (messages and > > highlighted search) as inverse magenta. > > > > This only works when the pager is less, and the color.pager > > configuration is enabled, as well as color.ui. > > I think we should let the user decide whether they want to set this > feature themselves instead of setting it for them. For example, I have > specific colors set up with these environment variables, and I'd like > Git to honor them without having to configure Git independently of less. > I expect other users will expect Git's rendering of the manual pages to > work like other instances of man(1) on their system as well. It does respect them. This would render the man page with the color specified in the environment, not the default of git. LESS_TERMCAP_md=$'\e[1;33m' LESS_TERMCAP_me=$'\e[m' git help git > Additionally, using colors poses accessibility problems. I know someone > who, due to his colorblindness, finds terminal colors distracting and > hard to read, and prefers not to use them at all. git -c color.ui=never help git > Even users who want to use them might find some colors to be too > similar, and this patch doesn't permit them to be configured. Yes it does: LESS_TERMCAP_md=$'\e[01;38;5;33m' git help git > In my particular case, despite having normal color vision, because I use > a transparent terminal which often results in a grey background, I find > the standard terminal red to be difficult to read, and so this patch > would result in a significant decrease in the readability of the manual > pages for me. If you have LESS_TERMCAP_md set in your environment, it won't. -- Felipe Contreras
next prev parent reply other threads:[~2021-05-18 3:22 UTC|newest] Thread overview: 33+ messages / expand[flat|nested] mbox.gz Atom feed top 2021-05-18 1:01 Felipe Contreras 2021-05-18 1:19 ` brian m. carlson 2021-05-18 3:22 ` Felipe Contreras [this message] 2021-05-18 23:49 ` brian m. carlson 2021-05-19 1:08 ` Junio C Hamano 2021-05-19 2:07 ` brian m. carlson 2021-05-19 6:09 ` Junio C Hamano 2021-05-19 8:41 ` Ævar Arnfjörð Bjarmason 2021-05-19 10:36 ` Felipe Contreras 2021-05-21 0:58 ` brian m. carlson 2021-05-21 18:09 ` Felipe Contreras 2021-05-21 19:48 ` Igor Djordjevic 2021-05-21 21:20 ` Felipe Contreras 2021-05-21 22:10 ` Igor Djordjevic 2021-05-21 23:04 ` Felipe Contreras 2021-05-22 18:38 ` Igor Djordjevic 2021-05-22 21:48 ` Felipe Contreras 2021-05-23 11:25 ` Igor Djordjevic 2021-05-23 14:48 ` Felipe Contreras 2021-05-21 22:47 ` Igor Djordjevic 2021-05-21 23:32 ` Junio C Hamano 2021-05-19 9:26 ` Ævar Arnfjörð Bjarmason 2021-05-19 10:10 ` Jeff King 2021-05-19 11:45 ` Felipe Contreras 2021-05-19 11:19 ` Felipe Contreras 2021-05-19 12:21 ` Felipe Contreras 2021-05-20 1:55 ` brian m. carlson 2021-05-20 2:23 ` Junio C Hamano 2021-05-20 3:05 ` Felipe Contreras 2021-05-20 3:28 ` Junio C Hamano 2021-05-20 3:48 ` Felipe Contreras 2021-05-20 2:45 ` Felipe Contreras 2021-05-19 10:25 ` Felipe Contreras
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 * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --subject='Re: [PATCH] help: colorize man pages' \ /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
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 NNTP newsgroup(s).