rc/README.md

## obligatory personal dotfiles repository

_(plus some little shell scripts)_

### quick install

this archive is always up-to-date with git.

```sh
# with curl:
cd && curl -L https://github.com/notwa/rc/archive/master.tar.gz | tar zx && mv rc-master rc && rc/install
# with wget:
cd && wget -O - https://github.com/notwa/rc/archive/master.tar.gz | tar zx && mv rc-master rc && rc/install
```

### experimental install

this archive is only updated once a day.

```sh
# one time:
gpg --locate-key rc@glorp.wang
# many times:
cd && curl rc.glorp.wang | gpg --yes -o rc.tar -d - && tar xf rc.tar && rc/install
```

`curl` can be replaced by `wget -O-` or [`http`][httpie] or even [`burl`](#burl).
note that you can't pipe gpg directly into tar, because
because doing so would skip the signature being checked.

[httpie]: https://httpie.io/docs/cli

### compatibility

the following shells are taken into consideration, ordered from most to least compatible:

* zsh
* bash
* dash
* ash (busybox)

refer to the [compatibility table](#compatibility) for specifics.

**NOTE:** everything below this line is overwritten and automatically [regenerated.](/regenerate)

<!-- DOCUMENT -->

## shell functions

### [archive](/sh/archive#L4)

create an archive file in one of a few formats.

borrowed from [prezto.](https://github.com/sorin-ionescu/prezto)

### [argc](/sh/argc#L4)

validate the number of arguments in a function.

```sh
# usage: myfunc() { argc $# -(eq|le|ge) [0-9] "$0" || return; }

myfunc() {
    # use one of the following:
    argc $# -eq N "$0" || return
    argc $# -le N "$0" || return
    argc $# -ge N "$0" || return
    # where N is an integer between 0 and 9.
}
```

### [arith](/sh/arith#L7)

perform arithmetic using the shell and display the result.
see also [`hex`](#hex) and [`bin`](#bin).
this example requires zsh:

```
% db=6
% noglob arith 10**(db/20.)
1.9952623149688795
```

### [autosync](/sh/autosync#L6)

combine `inotifywait` and `rsync`.
this is sometimes nicer than `ssh`-ing into a server and running `vim` remotely.

### [bak](/sh/bak#L4)

backup files by creating copies and appending ".bak" to their names.
this calls itself recursively to avoid clobbering existing backups.

```
$ touch -d '2001-12-25 16:30:00' butts
$ bak butts
$ touch butts
$ bak butts
$ ls -l
total 0
-rw-r--r-- 1 notwa None 0 Aug  1 08:02 butts
-rw-r--r-- 1 notwa None 0 Aug  1 08:02 butts.bak
-rw-r--r-- 1 notwa None 0 Dec 25  2001 butts.bak.bak
```

### [baknow](/sh/baknow#L4)

backup files by appending their timestamps given by [`now`.](#now)

```
$ touch -d '2001-12-25 16:30:00' butts
$ baknow butts
$ baknow butts
cp: overwrite 'butts.2001-12-26_01800000.bak'? n
$ ls -l
total 0
-rw-r--r-- 1 notwa None 0 Dec 25  2001 butts
-rw-r--r-- 1 notwa None 0 Dec 25  2001 butts.2001-12-26_01800000.bak
```

### [baks](/sh/baks#L5)

backup files by copying each and appending *the current* date-time,
irrespective of when the files were modified or created.

```
$ touch -d '2001-12-25 16:30:00' butts
$ baks butts
$ baks butts
$ ls -l
total 0
-rw-r--r-- 1 notwa None 0 Dec 25  2001 butts
-rw-r--r-- 1 notwa None 0 Dec 25  2001 butts.21-08-01_14-54-07.bak
-rw-r--r-- 1 notwa None 0 Dec 25  2001 butts.21-08-01_14-54-09.bak
```

### [bin](/sh/bin#L7)

perform arithmetic using the shell and display the result as
an unsigned 8-bit integer in binary.
see also [`arith`](#arith) and [`hex`](#hex).

```
$ bin 123
01111011
```

### [burl](/sh/burl#L4)

turn bash into a makeshift HTTP client.
inspired by [hackshell.sh.](https://thc.org/hs)
also works in most other shells thanks to netcat.

minimal/minified version: https://eaguru.guru/t/burl.sh (469 bytes)

```
$ burl httpbin.org/get

HTTP/1.1 200 OK
Date: Tue, 01 Jul 2024 00:00:00 GMT
Content-Type: application/json
Content-Length: 192
Connection: close
Server: gunicorn/19.9.0
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true

{
  "args": {},
  "headers": {
    "Host": "httpbin.org",
    "X-Amzn-Trace-Id": "Root=1-12345678-deadfadefeedfacebeefcafe"
  },
  "origin": "0.0.0.0",
  "url": "http://httpbin.org/get"
}
```

### [busiest](/sh/busiest#L4)

list directories in descending order by the number of files in them,
counted recursively.

```
$ cd && busiest | head -n3
144181 src
48840 work
21042 play
```

### [clash](/sh/clash#L4)

run a command through 9 different shells.

only returns false when no arguments are given.

### [colors](/sh/colors#L4)

display all combinations of foreground and background terminal colors.
this only includes the basic 16-color palette.
excluding boilerplate, this script is a mere 67 characters long!

![terminal colors](https://eaguru.guru/t/terminal-colors-2024.png)

### [setup_clang_ubuntu (sh/compile)](/sh/compile#L4)

print (but don't execute) the commands necessary to install
a fairly recent version of clang on ubuntu-based distros.

```sh
$ setup_clang_ubuntu noble
wget -O- http://apt.llvm.org/llvm-snapshot.gpg.key | apt-key add -
echo > "/etc/apt/sources.list.d/llvm-toolchain-noble.list" \
"
deb http://apt.llvm.org/noble/ llvm-toolchain-noble main
# deb-src http://apt.llvm.org/noble/ llvm-toolchain-noble main
# 18
deb http://apt.llvm.org/noble/ llvm-toolchain-noble-18 main
# deb-src http://apt.llvm.org/noble/ llvm-toolchain-noble-18 main"
export DEBIAN_FRONTEND=noninteractive NEEDRESTART_SUSPEND=1
apt-get update -y && apt-get install -y clang-18 lld-18
update-alternatives --install /usr/bin/clang clang /usr/bin/clang-18 1800
update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-18 1800
update-alternatives --install /usr/bin/llvm-symbolizer llvm-symbolizer /usr/bin/llvm-symbolizer-18 1800
```

### [compile](/sh/compile#L47)

compile single-file C and C++ programs, messily.

supports gcc and clang on \*nix, and mingw64 gcc, msvc clang,
and regular msvc on Windows. tested on x86\_64 and on ARMv7 as well.
does not support MacOS, maybe someday…

defaults to gnu11 and gnu++1z as C and C++ standards respectively.
defaults to clang, gcc, and msvc in that order.

`compile` attempts to guess the most sane switches for any program, so that compilation may reduce to:

```sh
# debug build
compile rd.c
compile debug rd.c
# debug build with warning/error flags defined in ~/sh/arrays
# (requires .zshrc for global alias expansion)
compile WHOA rd.c
# likewise for C++
compile WHOA WELP rd.cc
compile WHOA WELP rd.cpp
# "derelease" build (release build with debug information)
compile derelease WHOA rd.c
# release build (with symbols stripped)
compile release WHOA rd.c
# hardened build (only useful on *nix)
compile hardened WHOA rd.c
# specifying compiler
compile gcc WHOA rd.c
compile msvc WHOA rd.c
compile release clang WHOA rd.c
# compile and execute (FIXME: writing to /tmp is a security concern)
compile derelease rd.c && /tmp/rd
```

### [confirm](/sh/confirm#L4)

display a simple yes-or-no prompt and return 0-or-1 respectively.

```
$ confirm && echo yay || echo nay
Continue? [y/N] y
yay
$ confirm && echo yay || echo nay
Continue? [y/N] n
nay
```

a real world example:

```
$ g1 && confirm && git commit -a --amend --no-edit
daf84e3 document a ton of stuff
Continue? [y/N] y
[master 92bdf76] document a ton of stuff
 Date: Sun Aug 1 09:27:25 2021 -0700
 20 files changed, 406 insertions(+), 29 deletions(-)
```

### [countdiff](/sh/countdiff#L4)

count the number of lines changed between two files.

**TODO:** don't use git for this. also, use patience algorithm.

```
$ countdiff README-old.md README.md
739
```

### [days](/sh/days#L4)

compute the number of days since a given date.

```
$ days 'January 1 1970'
18838
```

### [decently](/sh/decently#L6)

given a list of directories, update the last-modified timestamp
of each argument to that of the most recent file that it contains.

note that *files* are found recursively, but only the
*outermost directory* (the one specified by argument)
has its timestamp updated. symlinks are followed.
`.git` subdirectories are skipped over.
the timestamps of subdirectories are ignored.

### [dedupe](/sh/dedupe#L4)

copy a directory, but make hard/softlinks for identical files.

### [dfu](/sh/dfu#L4)

pretty-print `df` in GiB.

```
$ dfu
Filesystem              Used     Max    Left    Misc
/dev                    0.00    0.46    0.46    0.00
/                      17.20   23.22    6.01    1.27
```

### [disowned](/sh/disowned#L4)

find files in system directories that aren't associated with any pacman packages.

### [document](/sh/document#L147)

generate a markdown file out of docstrings in shell scripts.

**TODO:** describe. i have a rough outline written in my scrap file.

### [e](/sh/e#L4)

wrap around `$EDITOR` to run it as root if necessary.
this still needs some work to detect root-owned directories.

```
$ e /etc/sudoers
[sudo] password for notwa: 
```

**NOTE:** there also exists an e(1) program provided by
the *e-wrapper* package that i don't use.

### [ea](/sh/ea#L24)

**TODO:** document.

### [echo2](/sh/echo2#L4)

print arguments joined by spaces to stderr without parsing anything.

```
$ echo -e 'this\nthat' those
this
that those
$ echo2 -e 'this\nthat' those
-e this\nthat those
```

### [explore](/sh/explore#L4)

open a single directory in `explorer.exe`, defaulting to `$PWD`.

### [feud](/sh/feud#L4)

parse command-line arguments, mapping short-flags to variable names.

**NOTE:** the API is still experimental and will undergo major changes.

### [ff](/sh/ff#L4)

select a file from a given or current directory using
[`fzy`.](https://github.com/jhawthorn/fzy)

### [ghmd](/sh/ghmd#L7)

convert a markdown file to HTML in the style of GitHub.
note that this uses GitHub's API, so it requires internet connectivity.

this script utilizes the CSS provided at
[sindresorhus/github-markdown-css.](https://github.com/sindresorhus/github-markdown-css)

```
~/sh/ghmd < ~/rc/README.md > ~/rc/README.html
```

### [grab](/sh/grab#L4)

download a file from my site and verify its integrity by its [minisign](https://github.com/jedisct1/minisign/) signature.

### [grop](/sh/grop#L5)

invoke grep with `-oP`.

**NOTE:** there also exists a grop(1) program provided by
the *grop* package that i don't use.

### [grop4](/sh/grop4#L4)

[`grop`](#grop) for IPv4s.

### [has](/sh/has#L4)

[`have`,](#have) silently.

### [have](/sh/have#L4)

print the result of `which` if the program is found, else simply return 1.

```
export SOLVER="$(have kissat || have picosat || have cadical || have minisat)"
```

### [hex](/sh/hex#L7)

perform arithmetic using the shell and display the result as
an unsigned 32-bit integer in hexadecimal.
see also [`arith`](#arith) and [`bin`](#bin).

```
$ hex 0x221EA8-0x212020
0000FE88
```

**NOTE:** there also exists a hex(1) program provided by
the *basez* package that i don't use.

### [ify](/sh/ify#L4)

pipe one command through another, so you can still pass arguments to the former.

this is mainly useful for aliases. 99% of the time you'll use this with `less`.

```
$ alias ll="ify less ls -ACX --group-directories-first --color=force"
$ ll /etc
```

### [is_empty](/sh/is_empty#L4)

return 0 if the directory given by argument is empty.

### [isup](/sh/isup#L4)

return 0 if a given website returns a 2xx HTTP code.

```
$ isup google.com && echo yay || echo nay
yay
$ isup fdhafdslkjgfjs.com && echo yay || echo nay
nay
```

### [join2](/sh/join2#L4)

join every other line.

### [lsarchive](/sh/lsarchive#L4)

list the contents of an archive file in one of many formats.

borrowed from [prezto.](https://github.com/sorin-ionescu/prezto)

### [maybesudo](/sh/maybesudo#L4)

mimic certain features of `sudo` for systems without it installed.
as it stands, this mostly just handles some environment variables.

try this: `maybesudo_ -u "$USER" printenv`

### [minutemaid](/sh/minutemaid#L4)

check if the current minute is divisible by a given number,
and optionally execute a command if it is. if a command is given,
either execute the command and return its exit value,
or execute nothing and return 0. if a command is omitted,
either return 0 on the minute, or return 1.

note that a "minute" is relative to the seconds since the epoch,
not the minute of the hour. this ensures that commands will run
roughly every N minutes, regardless of the minute hand on the clock.

note that `minutemaid 1` will always return 0,
and `minutemaid 1 command` will always execute the command,
since every integral interval is evenly divisible by 1.
`minutemaid 0`, and any negative interval, is an error.

```
# crontab usage:
* * * * * minutemaid 9 ~/work/do_my_bidding # runs every nine minutes
# loop usage:
until minutemaid 9; do sleep 5; done
echo the wait is finally over; date
# improper usage:
while minutemaid 1; do sleep 1; done
echo this will never happen
```

### [monitor](/sh/monitor#L4)

this is [watch(1)](https://www.man7.org/linux/man-pages/man1/watch.1.html)
loosely reimplemented as a shell script.

```
usage: monitor [-fs] [-n {period}] {command} [{args...}]
```

**NOTE:** there also exists monitor(1) programs provided by
the *389-ds-base* and *dmucs* packages that i don't use.

### [morecolors](/sh/morecolors#L4)

print all 256 colors that are available on most terminals.

### [noccom](/sh/noccom#L6)

strip C-like comments; both multi-line and single-line.

### [note](/sh/note#L4)

act like [`echo2`,](#echo2) but use a bright color to stand out more.

**NOTE:** there also exists a [note(1)](https://www.daemon.de/projects/note/)
program provided by the *note* package that i don't use.

### [now](/sh/now#L4)

print a date-time (UTC) in a sortable format.
this takes a date or file as an argument,
else it defaults to the current time.
```
$ now
2019-05-27_35083906
$ now ~/sh/monitor
2017-03-14_82387259
$ now '@1234567890'
2009-02-13_84690000
```

### [oshi](/sh/oshi#L4)

upload files (or stdin) to [oshi.at.](https://oshi.at)
this script exits with the number of failed uploads; up to 255 at once.
directories are skipped. for now, file expiry is hard-coded at 2 weeks.

```
$ echo test | oshi
MANAGE: https://oshi.at/a/7809e5e8a8b5c28555b1e8cadc99b069d08a5d09
DL: https://oshi.at/ReTn/Dxzy

$ oshi ~/play/{hey,you,fake,empty}
MANAGE: https://oshi.at/a/9b56e4c5843006d491fabe859ea5746a8f36760c
DL: https://oshi.at/obFf/hey
oshi: expires in 14 days: /home/notwa/play/hey
MANAGE: https://oshi.at/a/f2dc46ae900ca7465a377d7a7942e722f87ff483
DL: https://oshi.at/JLBc/you
oshi: expires in 14 days: /home/notwa/play/you
oshi: no such file: /home/notwa/play/fake
oshi: skipping directory: /home/notwa/play/empty
oshi: successfully uploaded 2/4 files
oshi: failed to upload 2/4 files
```

### [oxo](/sh/oxo#L14)

upload files (or stdin) to [0x0.st.](https://0x0.st)
this script exits with the number of failed uploads; up to 255 at once.
file retention period (30 to 365 days) is only computed for arguments.
directories are skipped. please review the terms of service
[on the website](https://0x0.st) before uploading files.

```
$ echo test | oxo
https://0x0.st/sj2.txt
oxo: successfully uploaded 1/1 file

$ oxo ~/play/{hey,you,fake,empty}
https://0x0.st/-3rz.txt
oxo: expires in 365 days: /home/notwa/play/hey
https://0x0.st/-3ri.txt
oxo: expires in 365 days: /home/notwa/play/you
oxo: no such file: /home/notwa/play/fake
oxo: skipping empty file: /home/notwa/play/empty
oxo: successfully uploaded 2/4 files
oxo: failed to upload 2/4 files
```

### [pacbm](/sh/pacbm#L6)

display and order installed pacman packages by their filesize ascending,
and their sum. requires `expac`.

```
$ pacbm | head -n -1 | tail -2
  204.78M clang
  235.44M linux-firmware
```

### [pause](/sh/pause#L4)

pause — the companion script of [`confirm`.](#confirm)

```
$ pause
Press any key to continue
$ 
```

### [pegg](/sh/pegg#L4)

download and (pip) install a Python "egg" from a project on GitHub,
defaulting to the master branch. this uses [`pippy`](#pippy) internally.

```sh
# install the development version of https://github.com/rthalley/dnspython
$ pegg rthalley dnspython
# or instead install the latest stable version (as of writing)
$ pegg rthalley dnspython 3933b49
```

### [permit](/sh/permit#L13)

conditionally set executable permissions on each of its arguments.

flags:
* `-a` -- automatic: skip any files whose contents do not begin with
          with one of several signatures. this does not affect directories.
* `-m` -- manual: turn off automatic mode. (default)
* `-e` -- everything: consider both regular files and directories. (default)
* `-f` -- files: skip any arguments that are not regular files.
* `-d` -- directories: skip any arguments that are not directories.
* `-n` -- dry-run: don't actually change anything.
* `-v` -- verbose: print changes before doing them.

the `-e`, `-f`, and `-d` flags all override one another, and any of them
can be combined with `-a`. arguments that are neither regular files nor
directories (such as symlinks) are always skipped. arguments that are
already executable by the current user are skipped. arguments that do
not appear to refer to an existing file are passed through to chmod.
directories are never recursed.

### [pippy](/sh/pippy#L4)

install Python packages using pip,
but only update their dependencies as required.
this uses [`maybesudo`](#maybesudo) internally.

### [pre](/sh/pre#L4)

dump all the `#define`s that `$CC $CPPFLAGS $CFLAGS $LDFLAGS` would result in.

```
$ pre | shuf | head -n10
#define __GNUC_MINOR__ 3
#define __SIZEOF_LONG__ 4
#define __UINT_LEAST16_TYPE__ short unsigned int
#define __ORDER_BIG_ENDIAN__ 4321
#define __SIZEOF_FLOAT__ 4
#define __INTMAX_MAX__ 0x7fffffffffffffffLL
#define __INT64_C(c) c ## LL
#define __UINT16_MAX__ 0xffff
#define __DEC64_MANT_DIG__ 16
#define __DBL_HAS_INFINITY__ 1
```

### [preload](/sh/preload#L7)

handle dependencies within the [`~/sh/`](/sh) directory.

this function contains more comments than code, so you should read it.

### [psbm](/sh/psbm#L4)

display and order processes by their memory usage ascending, and their sum.

```
$ psbm | head -n -1 | tail -2
  185.08M    1163 chromium
  199.95M    1060 chromium
```

### [randir](/sh/randir#L6)

display a random directory in the current working directory.

```
$ randir
./sh
```

### [rot13](/sh/rot13#L6)

rot13 with numbers rotated as well.

```
$ rot13 <<< abc123
nop678
```

**NOTE:** there also exists rot13(1) programs provided by
the *bsdgames* and *hxtools* packages that i don't use.

### [rs](/sh/rs#L4)

record screen. does not record audio.
currently only works on Windows (gdigrab).
i'm sure there's something equivalent for Linux.

**TODO:** consider renaming because rs(1) already exists.

### [running](/sh/running#L6)

WIP

### [scount](/sh/scount#L4)

perform `sort | uniq -c | sort -n`, preferring GNU awk when available.

### [scramble](/sh/scramble#L6)

scrambles text in a predictable way using regex.

sacbremls ttex in a pdrceailtbe way unsig reegx.

**TODO:** consider renaming because scramble(1) already exists.

### [scropt](/sh/scropt#L4)

run `scrot` through `optipng` and save the result to `~/play/$(now).png`.

### [shcom](/sh/shcom#L4)

comment out text from stdin and wrap it in a markdown blockquote
for docstrings. this contains some extra logic for
handling already-commented and already-quoted text.
this allows `shcom` to be used with vim's visual selections
to update existing code examples.

as a simple example, `echo hey | shcom` produces, verbatim:

```
hey
```

### [shelly](/sh/shelly#L2)

(perl 5) invoke the first shell found from a list of shells
as an interactive, non-login shell. arguments are ignored.

### [similar](/sh/similar#L4)

highlight adjacent lines up to the first inequivalent character.

### [slit](/sh/slit#L6)

view specific columns of text.

### [slitt](/sh/slitt#L6)

view specific columns of text.
this version of `slit` uses tabs for its field separators.

### [sortip](/sh/sortip#L4)

sort lines numerically by IPv4 segments.

### [sram](/sh/sram#L4)

convert between a couple saveram formats for N64 emulators.

### [stfu](/sh/stfu#L4)

invoke a command, silencing stdout and stderr *unless* the command fails.

**NOTE:** don't use `stfu` for handling sensitive data or commands!
use it for 7zip.

note that the tail commands in the example below are from `stfu` itself;
they are echoed to reveal the temp paths for any further investigation.

```
$ touch butts
$ STFU_TAIL=5
$ stfu 7z a butts.7z butts
$ stfu 7z a butts.7z asses
command failed with exit status 1:
7z a butts.7z asses

$ tail -n 5 /tmp/stfu.CoJ0vmJsqA/out_1627942118
Scan WARNINGS for files and folders:

asses : The system cannot find the file specified.
----------------
Scan WARNINGS: 1

$ tail -n 5 /tmp/stfu.CoJ0vmJsqA/err_1627942118

WARNING: The system cannot find the file specified.
asses


```

### [subdue](/sh/subdue#L4)

reconfigure your terminal's color scheme using a preset for [recolor.](#recolor)

### [sum](/sh/sum#L4)

compute the summation of its arguments without forking processes.
this relies on the shell's built-in arithmetic operators.

```
$ sum 1 2 3
6
```

**TODO:** consider renaming because sum(1) already exists.

### [sv](/sh/sv#L4)

collect the lastmost value of every key.
the field separator can be given as its sole argument,
it defaults to a single space otherwise.

```
$ echo "alpha=first\nbeta=second\nalpha=third" | sv =
alpha=third
beta=second
```

this next example uses `sv` to only print the lastmost line
matching a pattern in each file. in other words, it uses
the filename printed by grep as the key in its key-value pairs.

```
$ cd ~/play/hash && grep -r 'ing$' . | sv :
./dic_win32.txt:WriteProfileString
./cracklib-small.txt:zoning
./english-words.txt:zooming
./usernames-125k.txt:flats_gaming
./cain.txt:zoografting
./pokemon.txt:Fletchling
./pokemon8.txt:Fletchling
```

**TODO:** rename because busybox(1) sv already exists.

### [trash](/sh/trash#L4)

output a given number of bytes from `/dev/random`.

```
$ trash 10 | xxp
3A A5 4F C7 6D 89 E7 D7 F7 0C
```

**TODO:** consider renaming because trash(1) already exists.

### [trunc](/sh/trunc#L4)

truncate text to fit within your terminal using the unicode character `…`.

```
$ echo $COLUMNS
84
$ seq 1 100 | tr '\n' ' ' | trunc
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31…
```

### [unarchive](/sh/unarchive#L4)

extract the contents of an archive file in one of many formats.

borrowed from [prezto.](https://github.com/sorin-ionescu/prezto)

### [unwrap](/sh/unwrap#L4)

join paragraphs into one line each.

### [v_lower](/sh/v_lower#L4)

transform the contents of a variable to lowercase.

### [v_upper](/sh/v_upper#L4)

transform the contents of a variable to uppercase.

### [wat](/sh/wat#L6)

wat — a better and recursive which/whence. for zsh only.

written by [leah2.](https://leahneukirchen.org/)

### [wipe](/sh/wipe#L4)

clear the screen and its scrollback, then print a high-contrast horizontal line.
using this, you'll know with absolute certainty that you're looking at the top of your history,
and that your terminal's scrollback didn't cap out and eat text.

**TODO:** rename because wipe(1) already exists.

### [witch](/sh/witch#L3)

this is a personal rewrite of `which` from Debian.
the original version didn't run on certain shells,
and inherited inconsistent behaviors from getopts.
the silent (`-s`) flag from Ubuntu has been added.

### [xxp](/sh/xxp#L4)

act like `xxd -p`, but nicely formatted.

**TODO:** support `-r` (reverse) argument.

```
$ xxd -p ~/rc/install | head -n2
23212f7573722f62696e2f656e762073680a232074686973207363726970
7420697320636f6d70617469626c65207769746820666f6c6c6f77696e67
$ xxp ~/rc/install | head -n2
23 21 2F 75 73 72 2F 62 69 6E 2F 65 6E 76 20 73
68 0A 23 20 74 68 69 73 20 73 63 72 69 70 74 20
```

## miscellaneous

### [dummy (zshrc)](/home/zshrc#L82)

return 0, ignoring arguments.

### [dirprev (zshrc)](/home/zshrc#L87)

rotate and change to the previous directory in the directory stack
without consuming the prompt.

### [dirnext (zshrc)](/home/zshrc#L94)

rotate and change to the next directory in the directory stack
without consuming the prompt.

### [dirup (zshrc)](/home/zshrc#L101)

change to the parent directory of the current working directory
without consuming the prompt.

### [dirview (zshrc)](/home/zshrc#L108)

use a fuzzy finder to select a recent directory in the directory stack
and change to it without consuming the prompt.

### [OMFG (zshrc)](/home/zshrc#L213)

silence stdout.

### [STFU (zshrc)](/home/zshrc#L214)

silence stderr.

### [SWAP (zshrc)](/home/zshrc#L215)

swap stdout and stderr. uses fd 3 as an intermediary.

### [WHOA (zshrc)](/home/zshrc#L216)

expand to several C/C++ flags to ease development.

### [WHEE (zshrc)](/home/zshrc#L217)

WHOA but for C++ (specifically g++) only.

### [WELP (zshrc)](/home/zshrc#L218)

expand to C++ flags to enable a C++-as-C facade.

### [reload (zshrc)](/home/zshrc#L267)

reload zsh by wiping temp files, recompiling rc files,
and replacing the current process with a new zsh process.

### [dummy (bashrc)](/home/bashrc#L52)

return 0, ignoring arguments.

### [reload (bashrc)](/home/bashrc#L57)

**TODO:** respect initctl like in `.zshrc`.

### [ADDPATH (shrc)](/home/shrc#L14)

append a directory to `$PATH` if it isn't already present.

### [refresh (shrc)](/home/shrc#L91)

invoke `hash -r`.

### [pl (shrc)](/home/shrc#L94)

print each argument on its own line.

### [ll (shrc)](/home/shrc#L97)

list files verbosely, fancily, ordered, but not recursively.

### [gdp (shrc)](/home/shrc#L111)

invoke `gd` to diff a commit from its parent. the commit defaults to "HEAD".

### [gd (shrc)](/home/shrc#L117)

invoke git's diff subcommand with fewer lines of context.

### [rgn (shrc)](/home/shrc#L120)

invoke ripgrep without respecting `.gitignore` files.

### [curls (shrc)](/home/shrc#L126)

invoke curl with less noise.

### [revend (shrc)](/home/shrc#L138)

reverse the 4-byte endianness of a single file. *this is an in-place operation!*

### [clone (shrc)](/home/shrc#L141)

invoke rsync suitably for creating virtually indistinguishable copies of files.

### [aligntabs (shrc)](/home/shrc#L144)

align tab-delimited fields in stdin.

### [crawla (shrc)](/home/shrc#L155)

play Dungeon Crawl: Stone Soup through ssh on the akrasiac server.

### [crawlz (shrc)](/home/shrc#L158)

play Dungeon Crawl: Stone Soup through ssh on the develz server.

### [diff (shrc)](/home/shrc#L161)

use git's diff subcommand for general diffing.

### [gc (shrc)](/home/shrc#L164)

columnize text by using git's column subcommand.

**TODO:** consider renaming because gc(1) already exists.

### [counts (shrc)](/home/shrc#L168)

count files in the current directory, including files found recursively.

### [exts (shrc)](/home/shrc#L171)

count and sort file extensions in the current directory, including files found recursively.

### [nocom (shrc)](/home/shrc#L174)

strip single-line C-like and shell-like comments.

### [jrep (shrc)](/home/shrc#L177)

extract strings comprised of basic ASCII or Japanese codepoints.

### [bomb (shrc)](/home/shrc#L180)

add a Byte-Order Mark to a file.

### [cleanse (shrc)](/home/shrc#L183)

strip unprintable and non-ASCII characters.

### [double (shrc)](/home/shrc#L186)

print every line twice. <br/> print every line twice.

**NOTE:** there also exists a double(1) program provided by
the *plotutils* package that i don't use.

### [katagana (shrc)](/home/shrc#L191)

convert katakana codepoints to their equivalent hiragana.

this is occasionally useful when translating [debug text from ancient games.](https://tcrf.net/)

### [makepkgf (shrc)](/home/shrc#L195)

make the freakin' package!

### [rakef (shrc)](/home/shrc#L198)

make the freakin' gem!

### [relog (shrc)](/home/shrc#L201)

log on again to refresh your unix groups, etc.

### [carry (shrc)](/home/shrc#L204)

copy files in a plain way using rsync. affected by umask.

## compatibility

| script                                        | preference | zsh  | bash | dash | ash  |
| --------------------------------------------- | ---------- | ---- | ---- | ---- | ---- |
| [archive](#archive)                           |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [argc](#argc)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [arith](#arith)                               |        zsh | ✔️    | ✔️    | ✔️    | ✔️    |
| [arrays](#arrays)                             |  **false** | ✔️    | ✔️    | ⭕    | ⭕    |
| [askey](#askey)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [autosync](#autosync)                         |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [bak](#bak)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [baknow](#baknow)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [baks](#baks)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [bin](#bin)                                   |        zsh | ✔️    | ✔️    | ✔️    | ✔️    |
| [burl](#burl)                                 |       bash | ✔️    | ✔️    | ✔️    | ✔️    |
| [busiest](#busiest)                           |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [clash](#clash)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [colors](#colors)                             |       bash | ✔️    | ✔️    | ⭕    | ⭕    |
| [colors2](#colors2)                           |       bash | ✔️    | ✔️    | ✔️    | ✔️    |
| [compile](#compile)                           |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [confirm](#confirm)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [countdiff](#countdiff)                       |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [cutv](#cutv)                                 |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [dated](#dated)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [days](#days)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [decently](#decently)                         |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [dedupe](#dedupe)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [dfu](#dfu)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [disowned](#disowned)                         |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [document](#document)                         |       dash | ✔️    | ✔️    | ✔️    | ✔️    |
| [e](#e)                                       |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [ea](#ea)                                     |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [echo2](#echo2)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [explore](#explore)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [feud](#feud)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [ff](#ff)                                     |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [ghmd](#ghmd)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [glug](#glug)                                 |       dash | ✔️    | ✔️    | ✔️    | ✔️    |
| [grab](#grab)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [grop](#grop)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [grop4](#grop4)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [has](#has)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [have](#have)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [hex](#hex)                                   |        zsh | ✔️    | ✔️    | ✔️    | ✔️    |
| [ify](#ify)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [is_empty](#is_empty)                         |       bash | ✔️    | ✔️    | ⭕    | ⭕    |
| [isup](#isup)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [join2](#join2)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [lsarchive](#lsarchive)                       |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [maybesudo](#maybesudo)                       |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [minutemaid](#minutemaid)                     |       dash | ✔️    | ✔️    | ✔️    | ✔️    |
| [monitor](#monitor)                           |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [morecolors](#morecolors)                     |       bash | ✔️    | ✔️    | ⭕    | ⭕    |
| [noccom](#noccom)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [note](#note)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [notice](#notice)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [now](#now)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [obtain](#obtain)                             |       *sh* | ❔    | ❔    | ❔    | ❔    |
| [oshi](#oshi)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [oxo](#oxo)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [pacbm](#pacbm)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [pause](#pause)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [pegg](#pegg)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [permit](#permit)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [pippy](#pippy)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [pre](#pre)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [preload](#preload)                           |  **false** | ✔️    | ✔️    | ✔️    | ✔️    |
| [psbm](#psbm)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [randir](#randir)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [recolor](#recolor)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [rot13](#rot13)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [rs](#rs)                                     |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [running](#running)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [scount](#scount)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [scramble](#scramble)                         |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [scropt](#scropt)                             |       bash | ✔️    | ✔️    | ✔️    | ✔️    |
| [shcom](#shcom)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [shelly](#shelly)                             |   **perl** | *n/a*    | *n/a*    | *n/a*    | *n/a*    |
| [similar](#similar)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [slit](#slit)                                 |       dash | ✔️    | ✔️    | ✔️    | ✔️    |
| [slitt](#slitt)                               |       dash | ✔️    | ✔️    | ✔️    | ✔️    |
| [sortip](#sortip)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [sram](#sram)                                 |        zsh | ✔️    | ✔️    | ⭕    | ⭕    |
| [stfu](#stfu)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [streamcrap](#streamcrap)                     |  **false** | ✔️    | ✔️    | ⭕    | ⭕    |
| [subdue](#subdue)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [sum](#sum)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [sv](#sv)                                     |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [trash](#trash)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [trunc](#trunc)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [unarchive](#unarchive)                       |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [unwrap](#unwrap)                             |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [v_domap](#v_domap)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [v_lower](#v_lower)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [v_upper](#v_upper)                           |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [wat](#wat)                                   |        zsh | ✔️    | ⭕    | ⭕    | ⭕    |
| [wipe](#wipe)                                 |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [witch](#witch)                               |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |
| [xxp](#xxp)                                   |       *sh* | ✔️    | ✔️    | ✔️    | ✔️    |