shell: update comment for man wrapper

diff --git a/shell/shell/aliases.in b/shell/shell/aliases.in
index 384d6e5a527098d9038e751e25ac0cd2ff8df09d..039c11a653845f33913302c8cbe268bd575c3af3 100644 (file)
--- 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 6ad2475ebe602ed04ec26d2ad2f39c209dc034fe..8313a41b0f17658d27ee5a2c22b80687bfbf8430 100644 (file)
--- 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
 #