From: Simon Ruderich <simon@ruderich.org>
Date: Fri, 20 Oct 2023 07:02:55 +0000 (+0200)
Subject: shell: update comment for man wrapper
X-Git-Url: https://ruderich.org/simon/gitweb/?a=commitdiff_plain;h=7eefe68ca1e53cf7e7a5ec3c49f681650daac71e;p=config%2Fdotfiles.git

shell: update comment for man wrapper
---

diff --git a/shell/shell/aliases.in b/shell/shell/aliases.in
index 384d6e5..039c11a 100644
--- a/shell/shell/aliases.in
+++ b/shell/shell/aliases.in
@@ -123,10 +123,12 @@ tree() {
     command tree -C "$@" | less -S
 }
 
-# Modern Groff versions (at least on Debian) don't support LESS_TERMCAP_* to
-# color man pages, set GROFF_NO_SGR as workaround. Also set LANG to C so that
-# hyphens are not replaced with unicode making it impossible to search for
-# options containg "-" or "--" in many man pages.
+# Groff versions >= 1.23 don't support LESS_TERMCAP_* to color man pages, set
+# GROFF_NO_SGR as workaround. Also set LANG to C so that hyphens are not
+# replaced with unicode making it impossible to search for options containg
+# "-" or "--" in many man pages (these are errors in the man page but very
+# common; Debian reverted this behavior in 1.23.0-3 but other distributions
+# might not).
 man() {
     GROFF_NO_SGR=1 LANG=C command man "$@"
 }
diff --git a/shell/shell/env b/shell/shell/env
index 6ad2475..8313a41 100644
--- a/shell/shell/env
+++ b/shell/shell/env
@@ -63,8 +63,8 @@ PAGER=less
 export PAGER
 
 escape=`printf '\033'`
-# Color man pages viewed with less, thanks to [1]. Modern Groff versions (at
-# least in Debian) also need GROFF_NO_SGR=1 for this to work.
+# Color man pages viewed with less, thanks to [1]. Groff versions >= 1.23 also
+# need GROFF_NO_SGR=1 for this to work.
 #
 # [1]: http://nion.modprobe.de/blog/archives/572-less-colors-for-man-pages.html
 #