From 8a2e1006b3b272126332aa064f3ad95387129544 Mon Sep 17 00:00:00 2001
From: Biswakalyan Bhuyan <biswa@surgot.in>
Date: Thu, 13 Feb 2025 14:13:49 +0530
Subject: new dot files

---
 .../oh-my-zsh/plugins/colored-man-pages/README.md  | 32 +++++++++++++
 .../colored-man-pages/colored-man-pages.plugin.zsh | 53 ++++++++++++++++++++++
 .../zsh/oh-my-zsh/plugins/colored-man-pages/nroff  | 12 +++++
 3 files changed, 97 insertions(+)
 create mode 100644 .config/zsh/oh-my-zsh/plugins/colored-man-pages/README.md
 create mode 100644 .config/zsh/oh-my-zsh/plugins/colored-man-pages/colored-man-pages.plugin.zsh
 create mode 100755 .config/zsh/oh-my-zsh/plugins/colored-man-pages/nroff

(limited to '.config/zsh/oh-my-zsh/plugins/colored-man-pages')

diff --git a/.config/zsh/oh-my-zsh/plugins/colored-man-pages/README.md b/.config/zsh/oh-my-zsh/plugins/colored-man-pages/README.md
new file mode 100644
index 0000000..4cbf64d
--- /dev/null
+++ b/.config/zsh/oh-my-zsh/plugins/colored-man-pages/README.md
@@ -0,0 +1,32 @@
+# Colored man pages plugin
+
+This plugin adds colors to man pages.
+
+To use it, add `colored-man-pages` to the plugins array in your zshrc file:
+
+```zsh
+plugins=(... colored-man-pages)
+```
+
+It will also automatically colorize man pages displayed by `dman` or `debman`,
+from [`debian-goodies`](https://packages.debian.org/stable/debian-goodies).
+
+You can also try to color other pages by prefixing the respective command with `colored`:
+
+```zsh
+colored git help clone
+```
+
+## Customization
+
+The plugin declares global associative array `less_termcap`, which maps termcap capabilities to escape
+sequences for the `less` pager. This mapping can be further customized by the user after the plugin is
+loaded. Check out sources for more.
+
+For example: `less_termcap[md]` maps to `LESS_TERMCAP_md` which is the escape sequence that tells `less`
+how to print something in bold. It's currently shown in bold red, but if you want to change it, you
+can redefine `less_termcap[md]` in your zshrc file, after OMZ is sourced:
+
+```zsh
+less_termcap[md]="${fg_bold[blue]}" # this tells less to print bold text in bold blue
+```
diff --git a/.config/zsh/oh-my-zsh/plugins/colored-man-pages/colored-man-pages.plugin.zsh b/.config/zsh/oh-my-zsh/plugins/colored-man-pages/colored-man-pages.plugin.zsh
new file mode 100644
index 0000000..981992d
--- /dev/null
+++ b/.config/zsh/oh-my-zsh/plugins/colored-man-pages/colored-man-pages.plugin.zsh
@@ -0,0 +1,53 @@
+# Requires colors autoload.
+# See termcap(5).
+
+# Set up once, and then reuse. This way it supports user overrides after the
+# plugin is loaded.
+typeset -AHg less_termcap
+
+# bold & blinking mode
+less_termcap[mb]="${fg_bold[red]}"
+less_termcap[md]="${fg_bold[red]}"
+less_termcap[me]="${reset_color}"
+# standout mode
+less_termcap[so]="${fg_bold[yellow]}${bg[blue]}"
+less_termcap[se]="${reset_color}"
+# underlining
+less_termcap[us]="${fg_bold[green]}"
+less_termcap[ue]="${reset_color}"
+
+# Handle $0 according to the standard:
+# https://zdharma-continuum.github.io/Zsh-100-Commits-Club/Zsh-Plugin-Standard.html
+0="${${ZERO:-${0:#$ZSH_ARGZERO}}:-${(%):-%N}}"
+0="${${(M)0:#/*}:-$PWD/$0}"
+
+# Absolute path to this file's directory.
+typeset -g __colored_man_pages_dir="${0:A:h}"
+
+function colored() {
+  local -a environment
+
+  # Convert associative array to plain array of NAME=VALUE items.
+  local k v
+  for k v in "${(@kv)less_termcap}"; do
+    environment+=( "LESS_TERMCAP_${k}=${v}" )
+  done
+
+  # Prefer `less` whenever available, since we specifically configured
+  # environment for it.
+  environment+=( PAGER="${commands[less]:-$PAGER}" )
+
+  # See ./nroff script.
+  if [[ "$OSTYPE" = solaris* ]]; then
+    environment+=( PATH="${__colored_man_pages_dir}:$PATH" )
+  fi
+
+  command env $environment "$@"
+}
+
+# Colorize man and dman/debman (from debian-goodies)
+function man \
+  dman \
+  debman {
+  colored $0 "$@"
+}
diff --git a/.config/zsh/oh-my-zsh/plugins/colored-man-pages/nroff b/.config/zsh/oh-my-zsh/plugins/colored-man-pages/nroff
new file mode 100755
index 0000000..4ae155d
--- /dev/null
+++ b/.config/zsh/oh-my-zsh/plugins/colored-man-pages/nroff
@@ -0,0 +1,12 @@
+#!/bin/sh
+
+# The whole point of this wrapper is to replace emboldening factor -u0 with
+# -u1 under certain circumstances on Solaris.
+
+if [ "$1,$2,$3" = "-u0,-Tlp,-man" ]; then
+  shift
+  exec /usr/bin/nroff -u1 "$@"
+else
+  # Some other invocation of nroff
+  exec /usr/bin/nroff "$@"
+fi
-- 
cgit v1.2.3-59-g8ed1b