Document more scripts (except completely trivial one-liner one) - localbin - leot's localbin (~/bin)
(HTM) hg clone https://bitbucket.org/iamleot/localbin
(DIR) Log
(DIR) Files
(DIR) Refs
---
(DIR) changeset 680a397c3224aa58a7ab3528773b8bdd1da2f8ba
(DIR) parent ac76012a6965593292d572a737449b5d8f51a72e
(HTM) Author: Leonardo Taccari <iamleot@gmail.com>
Date: Sat, 11 May 2019 13:53:38
Document more scripts (except completely trivial one-liner one)
Diffstat:
anmhi-rss | 4 ++++
anmhi-rss-scan | 4 ++++
csi | 4 ++++
dbus-launch | 4 ++++
dia | 4 ++++
dless | 4 ++++
fmtproc | 4 ++++
foram | 4 ++++
forw | 4 ++++
lp | 8 ++++++++
lpq | 8 ++++++++
lpr | 8 ++++++++
lprm | 8 ++++++++
mxterm | 4 ++++
pdfcat | 4 ++++
pdfvi | 4 ++++
pvi | 4 ++++
rss2mh | 4 ++++
sai | 4 ++++
seen | 4 ++++
seen-all | 4 ++++
sfeed_mbox | 5 +++++
slock | 4 ++++
srmenu | 5 +++++
startwm | 4 ++++
tanmhi-rss | 4 ++++
techo | 4 ++++
vimb-editor | 4 ++++
wwwcat | 4 ++++
wwwmh | 4 ++++
30 files changed, 138 insertions(+), 0 deletions(-)
---
diff -r ac76012a6965 -r 680a397c3224 anmhi-rss
--- a/anmhi-rss Sat May 11 12:48:36 2019 +0200
+++ b/anmhi-rss Sat May 11 13:53:38 2019 +0200
@@ -1,4 +1,8 @@
#!/bin/sh
+#
+# Invoke anmhi for feeds.
+#
+
export MH="${HOME}/.mh_rss_profile"
exec anmhi "$@"
diff -r ac76012a6965 -r 680a397c3224 anmhi-rss-scan
--- a/anmhi-rss-scan Sat May 11 12:48:36 2019 +0200
+++ b/anmhi-rss-scan Sat May 11 13:53:38 2019 +0200
@@ -1,4 +1,8 @@
#!/bin/sh
+#
+# Invoke anmhi-scan for feeds.
+#
+
export MH="${HOME}/.mh_rss_profile"
exec anmhi-scan "$@"
diff -r ac76012a6965 -r 680a397c3224 csi
--- a/csi Sat May 11 12:48:36 2019 +0200
+++ b/csi Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# Use rlwrap with csi to ease history editing.
+#
+
exec /usr/pkg/bin/rlwrap --histsize=-1 /usr/pkg/bin/csi "$@"
diff -r ac76012a6965 -r 680a397c3224 dbus-launch
--- a/dbus-launch Sat May 11 12:48:36 2019 +0200
+++ b/dbus-launch Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# Avoid to disturb dbus if present.
+#
+
exit 0
diff -r ac76012a6965 -r 680a397c3224 dia
--- a/dia Sat May 11 12:48:36 2019 +0200
+++ b/dia Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# Run dia in a single window.
+#
+
exec /usr/pkg/bin/dia --integrated
diff -r ac76012a6965 -r 680a397c3224 dless
--- a/dless Sat May 11 12:48:36 2019 +0200
+++ b/dless Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Use dmenu as a pager.
+#
+
font='Droid Sans Mono:size=12'
lines=30
diff -r ac76012a6965 -r 680a397c3224 fmtproc
--- a/fmtproc Sat May 11 12:48:36 2019 +0200
+++ b/fmtproc Sat May 11 13:53:38 2019 +0200
@@ -1,4 +1,8 @@
#!/bin/sh
+#
+# fmtproc used via `repl -fmtproc'
+#
+
cat - > /dev/null
mhshow -noheader -markform /dev/null -form mhl.body -textonly -inlineonly
diff -r ac76012a6965 -r 680a397c3224 foram
--- a/foram Sat May 11 12:48:36 2019 +0200
+++ b/foram Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Run an nmh command for all folders.
+#
+
cmd=$1
shift
diff -r ac76012a6965 -r 680a397c3224 forw
--- a/forw Sat May 11 12:48:36 2019 +0200
+++ b/forw Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# Use repl as forw.
+#
+
exec repl -form forwcomps -filter mhl.forw "$@"
diff -r ac76012a6965 -r 680a397c3224 lp
--- a/lp Sat May 11 12:48:36 2019 +0200
+++ b/lp Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,11 @@
#!/bin/sh
+#
+# Invoke pkgsrc lp if available, falling back to base one.
+#
+
+if [ -x /usr/pkg/bin/lp ]; then
+ exec /usr/pkg/bin/lp "$@"
+fi
+
exec /usr/pkg/bin/lp "$@"
diff -r ac76012a6965 -r 680a397c3224 lpq
--- a/lpq Sat May 11 12:48:36 2019 +0200
+++ b/lpq Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,11 @@
#!/bin/sh
+#
+# Invoke pkgsrc lpq if available, falling back to base one.
+#
+
+if [ -x /usr/pkg/bin/lpq ]; then
+ exec /usr/pkg/bin/lpq "$@"
+fi
+
exec /usr/pkg/bin/lpq "$@"
diff -r ac76012a6965 -r 680a397c3224 lpr
--- a/lpr Sat May 11 12:48:36 2019 +0200
+++ b/lpr Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,11 @@
#!/bin/sh
+#
+# Invoke pkgsrc lpr if available, falling back to base one.
+#
+
+if [ -x /usr/pkg/bin/lpr ]; then
+ exec /usr/pkg/bin/lpr "$@"
+fi
+
exec /usr/pkg/bin/lpr "$@"
diff -r ac76012a6965 -r 680a397c3224 lprm
--- a/lprm Sat May 11 12:48:36 2019 +0200
+++ b/lprm Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,11 @@
#!/bin/sh
+#
+# Invoke pkgsrc lprm if available, falling back to base one.
+#
+
+if [ -x /usr/pkg/bin/lprm ]; then
+ exec /usr/pkg/bin/lprm "$@"
+fi
+
exec /usr/pkg/bin/lprm "$@"
diff -r ac76012a6965 -r 680a397c3224 mxterm
--- a/mxterm Sat May 11 12:48:36 2019 +0200
+++ b/mxterm Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# Run tmux inside an xterm (multiple-xterm-s).
+#
+
exec xterm -e tmux
diff -r ac76012a6965 -r 680a397c3224 pdfcat
--- a/pdfcat Sat May 11 12:48:36 2019 +0200
+++ b/pdfcat Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Extract all text of a PDF.
+#
+
pdfviewer="mutool draw"
pdfviewer_options="-F txt"
diff -r ac76012a6965 -r 680a397c3224 pdfvi
--- a/pdfvi Sat May 11 12:48:36 2019 +0200
+++ b/pdfvi Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# "Edit" a PDF file, extract all its text and open ${EDITOR} against it.
+#
+
pdfvi_file="/tmp/.pdfvi"
if [ -z "$1" ]; then
diff -r ac76012a6965 -r 680a397c3224 pvi
--- a/pvi Sat May 11 12:48:36 2019 +0200
+++ b/pvi Sat May 11 13:53:38 2019 +0200
@@ -1,4 +1,8 @@
#!/bin/sh
+#
+# vi for Python.
+#
+
export NEXINIT="source ${HOME}/.nexrc.py"
exec vi "$@"
diff -r ac76012a6965 -r 680a397c3224 rss2mh
--- a/rss2mh Sat May 11 12:48:36 2019 +0200
+++ b/rss2mh Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Fetch all sfeed feeds and convert them to MH messages.
+#
+
sfeedpath=${HOME}/.sfeed/feeds
mboxpath=${TMPDIR:-/tmp}/sfeed-mboxes
fdmconf=${HOME}/.sfeed/fdm.sfeed.conf
diff -r ac76012a6965 -r 680a397c3224 sai
--- a/sai Sat May 11 12:48:36 2019 +0200
+++ b/sai Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Simple script to ssh-add available keys.
+#
+
: ${SSH_KEYS:="${HOME}/.ssh"}
find_options=""
diff -r ac76012a6965 -r 680a397c3224 seen
--- a/seen Sat May 11 12:48:36 2019 +0200
+++ b/seen Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# Remove unseen sequence.
+#
+
exec mark -sequence unseen -delete "$@"
diff -r ac76012a6965 -r 680a397c3224 seen-all
--- a/seen-all Sat May 11 12:48:36 2019 +0200
+++ b/seen-all Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Mark all MH messages as seen.
+#
+
for f in `flist -all -noshowzero -fast -sequence unseen`; do
show +"$f" last > /dev/null
seen unseen
diff -r ac76012a6965 -r 680a397c3224 sfeed_mbox
--- a/sfeed_mbox Sat May 11 12:48:36 2019 +0200
+++ b/sfeed_mbox Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,10 @@
#!/bin/sh
+#
+# Convert a feed sfeed to mbox, similar to original sfeed_mbox provided by
+# sfeed but also populating the content by converting it to text.
+#
+
feed=$1
if [ -z "${feed}" ]; then
diff -r ac76012a6965 -r 680a397c3224 slock
--- a/slock Sat May 11 12:48:36 2019 +0200
+++ b/slock Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Kill possible running unclutter, launch slock and relaunch unclutter.
+#
+
pkill unclutter
/usr/pkg/bin/slock
unclutter -idle 2 -jitter 20 -grab -root -not tabbed Emacs Firefox Vimb Midori netsurf SDL_App Surf Luakit &
diff -r ac76012a6965 -r 680a397c3224 srmenu
--- a/srmenu Sat May 11 12:48:36 2019 +0200
+++ b/srmenu Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,10 @@
#!/bin/sh
+#
+# dmenu surfraw interface, populate dmenu with list of surfraw elvi-s and invoke
+# surfraw against dmenu input.
+#
+
s=$(surfraw -elvi | awk '(NR >= 2) { print $1 }' | dmenu)
if [ -n "$s" ]; then
diff -r ac76012a6965 -r 680a397c3224 startwm
--- a/startwm Sat May 11 12:48:36 2019 +0200
+++ b/startwm Sat May 11 13:53:38 2019 +0200
@@ -1,3 +1,7 @@
#!/bin/sh
+#
+# "startx"-like one-liner.
+#
+
exec xinit ${HOME}/.xinitrc -- /usr/X11R7/bin/X -nolisten tcp $@
diff -r ac76012a6965 -r 680a397c3224 tanmhi-rss
--- a/tanmhi-rss Sat May 11 12:48:36 2019 +0200
+++ b/tanmhi-rss Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Invoke tanmhi for feeds.
+#
+
tmux split-window -bd -t:.0 -v -l 8 "anmhi-rss-scan ; $SHELL"
tmux rename-window 'rss'
diff -r ac76012a6965 -r 680a397c3224 techo
--- a/techo Sat May 11 12:48:36 2019 +0200
+++ b/techo Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# terminal title echo(1)
+#
+
printf "\033]0;"
echo "$@"
printf "\007"
diff -r ac76012a6965 -r 680a397c3224 vimb-editor
--- a/vimb-editor Sat May 11 12:48:36 2019 +0200
+++ b/vimb-editor Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# ${EDITOR} invoked by vimb.
+#
+
tmux new-window \
"${EDITOR} $1 ; tmux wait-for -S vimb-editor" \; \
wait-for vimb-editor
diff -r ac76012a6965 -r 680a397c3224 wwwcat
--- a/wwwcat Sat May 11 12:48:36 2019 +0200
+++ b/wwwcat Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Convert HTML to text via w3m.
+#
+
export http_proxy="http://localhost:31283128"
browser="/usr/pkg/bin/w3m"
diff -r ac76012a6965 -r 680a397c3224 wwwmh
--- a/wwwmh Sat May 11 12:48:36 2019 +0200
+++ b/wwwmh Sat May 11 13:53:38 2019 +0200
@@ -1,5 +1,9 @@
#!/bin/sh
+#
+# Convert HTML to text via w3m (used by MH).
+#
+
export http_proxy="http://localhost:31283128"
browser="/usr/pkg/bin/w3m"