shell: add man wrapper to restore colored and searchable man pages

diff --git a/shell/shell/aliases.in b/shell/shell/aliases.in
index a4db8bfee044f0856faa3238e26d00d252eb294e..384d6e5a527098d9038e751e25ac0cd2ff8df09d 100644 (file)
--- a/shell/shell/aliases.in
+++ b/shell/shell/aliases.in
@@ -123,6 +123,14 @@ 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.
+man() {
+    GROFF_NO_SGR=1 LANG=C command man "$@"
+}
+
 # Better viewer for info pages .. just pipe everything into less.
 info() {
     command info "$@" 2>/dev/null | less

diff --git a/shell/shell/env b/shell/shell/env
index 74715a0eb3196f698556baa87b1211e5a79101af..6ad2475ebe602ed04ec26d2ad2f39c209dc034fe 100644 (file)
--- a/shell/shell/env
+++ b/shell/shell/env
@@ -63,7 +63,8 @@ PAGER=less
 export PAGER
 
 escape=`printf '\033'`
-# Color man pages viewed with less, thanks to [1].
+# 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.
 #
 # [1]: http://nion.modprobe.de/blog/archives/572-less-colors-for-man-pages.html
 #