From 7eefe68ca1e53cf7e7a5ec3c49f681650daac71e Mon Sep 17 00:00:00 2001 From: Simon Ruderich Date: Fri, 20 Oct 2023 09:02:55 +0200 Subject: [PATCH] shell: update comment for man wrapper --- shell/shell/aliases.in | 10 ++++++---- shell/shell/env | 4 ++-- 2 files changed, 8 insertions(+), 6 deletions(-) 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 # -- 2.43.2