diff options
author | Tom Ryder <tom@sanctum.geek.nz> | 2016-08-26 12:13:03 +1200 |
---|---|---|
committer | Tom Ryder <tom@sanctum.geek.nz> | 2016-08-26 12:50:25 +1200 |
commit | cde1926a3c65830bceed5e8e76cd94e81b19386c (patch) | |
tree | 5abe782d2c9567f3d7c3affa8fc077fb3d5d5e5c /man | |
parent | Add notifications to dmp(1) (diff) | |
download | dotfiles-cde1926a3c65830bceed5e8e76cd94e81b19386c.tar.gz dotfiles-cde1926a3c65830bceed5e8e76cd94e81b19386c.zip |
Put dotfiles manuals into their own section
This probably contains a few mistakes
Diffstat (limited to 'man')
-rw-r--r-- | man/man1/apf.1df (renamed from man/man1/apf.1) | 2 | ||||
-rw-r--r-- | man/man1/ax.1df (renamed from man/man1/ax.1) | 2 | ||||
-rw-r--r-- | man/man1/bel.1df (renamed from man/man1/bel.1) | 2 | ||||
-rw-r--r-- | man/man1/br.1df (renamed from man/man1/br.1) | 4 | ||||
-rw-r--r-- | man/man1/ca.1df (renamed from man/man1/ca.1) | 2 | ||||
-rw-r--r-- | man/man1/cf.1df (renamed from man/man1/cf.1) | 2 | ||||
-rw-r--r-- | man/man1/clrd.1df (renamed from man/man1/clrd.1) | 6 | ||||
-rw-r--r-- | man/man1/clwr.1df (renamed from man/man1/clwr.1) | 6 | ||||
-rw-r--r-- | man/man1/d2u.1df (renamed from man/man1/d2u.1) | 4 | ||||
-rw-r--r-- | man/man1/dmp.1df (renamed from man/man1/dmp.1) | 2 | ||||
-rw-r--r-- | man/man1/dub.1df (renamed from man/man1/dub.1) | 2 | ||||
-rw-r--r-- | man/man1/edda.1df (renamed from man/man1/edda.1) | 2 | ||||
-rw-r--r-- | man/man1/eds.1df (renamed from man/man1/eds.1) | 2 | ||||
-rw-r--r-- | man/man1/fgscr.1df (renamed from man/man1/fgscr.1) | 8 | ||||
-rw-r--r-- | man/man1/fnl.1df (renamed from man/man1/fnl.1) | 6 | ||||
-rw-r--r-- | man/man1/gms.1df (renamed from man/man1/gms.1) | 8 | ||||
-rw-r--r-- | man/man1/grc.1df (renamed from man/man1/grc.1) | 4 | ||||
-rw-r--r-- | man/man1/gscr.1df (renamed from man/man1/gscr.1) | 4 | ||||
-rw-r--r-- | man/man1/han.1df (renamed from man/man1/han.1) | 2 | ||||
-rw-r--r-- | man/man1/hurl.1df (renamed from man/man1/hurl.1) | 4 | ||||
-rw-r--r-- | man/man1/igex.1df (renamed from man/man1/igex.1) | 2 | ||||
-rw-r--r-- | man/man1/isgr.1df (renamed from man/man1/isgr.1) | 4 | ||||
-rw-r--r-- | man/man1/jfc.1df (renamed from man/man1/jfc.1) | 4 | ||||
-rw-r--r-- | man/man1/jfcd.1df (renamed from man/man1/jfcd.1) | 6 | ||||
-rw-r--r-- | man/man1/maybe.1df (renamed from man/man1/maybe.1) | 6 | ||||
-rw-r--r-- | man/man1/mkcp.1df (renamed from man/man1/mkcp.1) | 4 | ||||
-rw-r--r-- | man/man1/mkmv.1df (renamed from man/man1/mkmv.1) | 4 | ||||
-rw-r--r-- | man/man1/mktd.1df (renamed from man/man1/mktd.1) | 4 | ||||
-rw-r--r-- | man/man1/motd.1df (renamed from man/man1/motd.1) | 2 | ||||
-rw-r--r-- | man/man1/murl.1df (renamed from man/man1/murl.1) | 8 | ||||
-rw-r--r-- | man/man1/pa.1df (renamed from man/man1/pa.1) | 4 | ||||
-rw-r--r-- | man/man1/paz.1df (renamed from man/man1/paz.1) | 4 | ||||
-rw-r--r-- | man/man1/pit.1df (renamed from man/man1/pit.1) | 2 | ||||
-rw-r--r-- | man/man1/plmu.1df (renamed from man/man1/plmu.1) | 2 | ||||
-rw-r--r-- | man/man1/rfcf.1df (renamed from man/man1/rfcf.1) | 4 | ||||
-rw-r--r-- | man/man1/rfcr.1df (renamed from man/man1/rfcr.1) | 8 | ||||
-rw-r--r-- | man/man1/rfct.1df (renamed from man/man1/rfct.1) | 4 | ||||
-rw-r--r-- | man/man1/rmrej.1df (renamed from man/man1/rmrej.1) | 2 | ||||
-rw-r--r-- | man/man1/rnda.1df (renamed from man/man1/rnda.1) | 6 | ||||
-rw-r--r-- | man/man1/rndf.1df (renamed from man/man1/rndf.1) | 6 | ||||
-rw-r--r-- | man/man1/rndi.1df (renamed from man/man1/rndi.1) | 4 | ||||
-rw-r--r-- | man/man1/rndl.1 | 22 | ||||
-rw-r--r-- | man/man1/rndl.1df | 22 | ||||
-rw-r--r-- | man/man1/rnds.1df (renamed from man/man1/rnds.1) | 6 | ||||
-rw-r--r-- | man/man1/sd2u.1df (renamed from man/man1/sd2u.1) | 4 | ||||
-rw-r--r-- | man/man1/shb.1df (renamed from man/man1/shb.1) | 2 | ||||
-rw-r--r-- | man/man1/sls.1df (renamed from man/man1/sls.1) | 9 | ||||
-rw-r--r-- | man/man1/slsf.1df (renamed from man/man1/slsf.1) | 6 | ||||
-rw-r--r-- | man/man1/spr.1df (renamed from man/man1/spr.1) | 2 | ||||
-rw-r--r-- | man/man1/sra.1df (renamed from man/man1/sra.1) | 8 | ||||
-rw-r--r-- | man/man1/sshi.1df (renamed from man/man1/sshi.1) | 2 | ||||
-rw-r--r-- | man/man1/sta.1df (renamed from man/man1/sta.1) | 8 | ||||
-rw-r--r-- | man/man1/stbl.1df (renamed from man/man1/stbl.1) | 4 | ||||
-rw-r--r-- | man/man1/stex.1df (renamed from man/man1/stex.1) | 2 | ||||
-rw-r--r-- | man/man1/stws.1df (renamed from man/man1/stws.1) | 4 | ||||
-rw-r--r-- | man/man1/su2d.1df (renamed from man/man1/su2d.1) | 4 | ||||
-rw-r--r-- | man/man1/td.1df (renamed from man/man1/td.1) | 2 | ||||
-rw-r--r-- | man/man1/tl.1df (renamed from man/man1/tl.1) | 4 | ||||
-rw-r--r-- | man/man1/tlcs.1df (renamed from man/man1/tlcs.1) | 6 | ||||
-rw-r--r-- | man/man1/try.1df (renamed from man/man1/try.1) | 4 | ||||
-rw-r--r-- | man/man1/u2d.1df (renamed from man/man1/u2d.1) | 4 | ||||
-rw-r--r-- | man/man1/unf.1df (renamed from man/man1/unf.1) | 2 | ||||
-rw-r--r-- | man/man1/urlc.1df (renamed from man/man1/urlc.1) | 4 | ||||
-rw-r--r-- | man/man1/urlh.1df (renamed from man/man1/urlh.1) | 4 | ||||
-rw-r--r-- | man/man1/urlmt.1df (renamed from man/man1/urlmt.1) | 6 | ||||
-rw-r--r-- | man/man1/xgo.1df (renamed from man/man1/xgo.1) | 4 | ||||
-rw-r--r-- | man/man1/xgoc.1df (renamed from man/man1/xgoc.1) | 6 | ||||
-rw-r--r-- | man/man1/xrbg.1df (renamed from man/man1/xrbg.1) | 10 | ||||
-rw-r--r-- | man/man6/aaf.6df (renamed from man/man6/aaf.6) | 2 | ||||
-rw-r--r-- | man/man6/acq.6df (renamed from man/man6/acq.6) | 2 | ||||
-rw-r--r-- | man/man6/dr.6df (renamed from man/man6/dr.6) | 4 | ||||
-rw-r--r-- | man/man6/kvlt.6df (renamed from man/man6/kvlt.6) | 2 | ||||
-rw-r--r-- | man/man6/rndn.6df (renamed from man/man6/rndn.6) | 6 | ||||
-rw-r--r-- | man/man6/xyzzy.6df (renamed from man/man6/xyzzy.6) | 2 | ||||
-rw-r--r-- | man/man6/zs.6df (renamed from man/man6/zs.6) | 2 | ||||
-rw-r--r-- | man/man7/dotfiles.7df | 730 | ||||
-rw-r--r-- | man/man7/dotfiles.7df.header (renamed from man/man7/dotfiles.7.header) | 2 | ||||
-rw-r--r-- | man/man8/sue.8df (renamed from man/man8/sue.8) | 2 |
78 files changed, 904 insertions, 175 deletions
diff --git a/man/man1/apf.1 b/man/man1/apf.1df index 7cb2ab28..6f8804e0 100644 --- a/man/man1/apf.1 +++ b/man/man1/apf.1df @@ -1,4 +1,4 @@ -.TH APF 1 "August 2016" "Manual page for apf" +.TH APF 1df "August 2016" "Manual page for apf" .SH NAME .B apf \- add arguments to a command from a file diff --git a/man/man1/ax.1 b/man/man1/ax.1df index 2e8d7179..b3218d37 100644 --- a/man/man1/ax.1 +++ b/man/man1/ax.1df @@ -1,4 +1,4 @@ -.TH AX 1 "July 2016" "Manual page for ax" +.TH AX 1df "July 2016" "Manual page for ax" .SH NAME .B ax \- evaluate an awk expression diff --git a/man/man1/bel.1 b/man/man1/bel.1df index 36b568fd..e55ae517 100644 --- a/man/man1/bel.1 +++ b/man/man1/bel.1df @@ -1,4 +1,4 @@ -.TH BEL 1 "August 2016" "Manual page for bel" +.TH BEL 1df "August 2016" "Manual page for bel" .SH NAME .B bel \- ring the terminal bell diff --git a/man/man1/br.1 b/man/man1/br.1df index 5f6de5f7..b20cfc70 100644 --- a/man/man1/br.1 +++ b/man/man1/br.1df @@ -1,4 +1,4 @@ -.TH BR 1 "August 2016" "Manual page for br" +.TH BR 1df "August 2016" "Manual page for br" .SH NAME .B br \- launch "$BROWSER" @@ -18,6 +18,6 @@ arguments. That's it. It was written to have a clean way to launch $BROWSER from ~/.xbindkeysrc. It has no other reason to exist. .SH SEE ALSO -xgo(1), xgoc(1) +xgo(1df), xgoc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/ca.1 b/man/man1/ca.1df index 1d79d62e..06f3e100 100644 --- a/man/man1/ca.1 +++ b/man/man1/ca.1df @@ -1,4 +1,4 @@ -.TH CA 1 "July 2016" "Manual page for ca" +.TH CA 1df "July 2016" "Manual page for ca" .SH NAME .B ca \- print a count of the given arguments diff --git a/man/man1/cf.1 b/man/man1/cf.1df index 0bedb19f..8d6e3edc 100644 --- a/man/man1/cf.1 +++ b/man/man1/cf.1df @@ -1,4 +1,4 @@ -.TH CF 1 "July 2016" "Manual page for cf" +.TH CF 1df "July 2016" "Manual page for cf" .SH NAME .B cf \- print a count of entries in a directory diff --git a/man/man1/clrd.1 b/man/man1/clrd.1df index 696b3303..25e7e677 100644 --- a/man/man1/clrd.1 +++ b/man/man1/clrd.1df @@ -1,4 +1,4 @@ -.TH CLRD 1 "August 2016" "Manual page for clrd" +.TH CLRD 1df "August 2016" "Manual page for clrd" .SH NAME .B clrd \- clear the screen and run tail on the arguments @@ -9,8 +9,8 @@ file .B clrd clears the screen and runs tail -f on the given file. It will not run if stdout is not a terminal. This is for use in minimal socket-network programs like -ii(1), along with clwr(1). +ii(1), along with clwr(1df). .SH SEE ALSO -clwr(1), ii(1) +clwr(1df), ii(1) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/clwr.1 b/man/man1/clwr.1df index ecb29f5c..e8fa1ea9 100644 --- a/man/man1/clwr.1 +++ b/man/man1/clwr.1df @@ -1,4 +1,4 @@ -.TH CLWR 1 "August 2016" "Manual page for clwr" +.TH CLWR 1df "August 2016" "Manual page for clwr" .SH NAME .B clwr \- clear screen, read line from terminal, write line to file @@ -9,8 +9,8 @@ file .B clwr clears the screen, accepts a line of input from stdin, writes it to the given file, and loops. This is for use in minimal socket-network programs like ii(1), -along with clrd(1). +along with clrd(1df). .SH SEE ALSO -clrd(1), ii(1) +clrd(1df), ii(1) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/d2u.1 b/man/man1/d2u.1df index d42b87b9..18c27829 100644 --- a/man/man1/d2u.1 +++ b/man/man1/d2u.1df @@ -1,4 +1,4 @@ -.TH D2U 1 "August 2016" "Manual page for d2u" +.TH D2U 1df "August 2016" "Manual page for d2u" .SH NAME .B d2u \- change text files from DOS to UNIX format @@ -8,6 +8,6 @@ Applies ed(1) to change DOS \\r\\n (CRLF) line endings to UNIX \\n line endings. Files already in UNIX format should be unchanged. .SH SEE ALSO -ed(1), u2d(1), sd2u(1), su2d(1) +ed(1), u2d(1df), sd2u(1df), su2d(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/dmp.1 b/man/man1/dmp.1df index 33dde9b8..b9f11bf8 100644 --- a/man/man1/dmp.1 +++ b/man/man1/dmp.1df @@ -1,4 +1,4 @@ -.TH DMP 1 "August 2016" "Manual page for dmp" +.TH DMP 1df "August 2016" "Manual page for dmp" .SH NAME .B dmp \- pick a pass(1) password with dmenu(1) diff --git a/man/man1/dub.1 b/man/man1/dub.1df index 7a2098ec..52900a36 100644 --- a/man/man1/dub.1 +++ b/man/man1/dub.1df @@ -1,4 +1,4 @@ -.TH DUB 1 "July 2016" "Manual page for dub" +.TH DUB 1df "July 2016" "Manual page for dub" .SH NAME .B dub \- list the biggest files in the given directory diff --git a/man/man1/edda.1 b/man/man1/edda.1df index 3123c0ce..521c329b 100644 --- a/man/man1/edda.1 +++ b/man/man1/edda.1df @@ -1,4 +1,4 @@ -.TH EDDA 1 "August 2016" "Manual page for edda" +.TH EDDA 1df "August 2016" "Manual page for edda" .SH NAME .B edda \- run ed(1) over multiple files diff --git a/man/man1/eds.1 b/man/man1/eds.1df index 545f90fc..5dc1674d 100644 --- a/man/man1/eds.1 +++ b/man/man1/eds.1df @@ -1,4 +1,4 @@ -.TH VIS 1 "November 2015" "Manual page for eds" +.TH VIS 1df "November 2015" "Manual page for eds" .SH NAME .B eds \- create and edit personal scripts diff --git a/man/man1/fgscr.1 b/man/man1/fgscr.1df index f75ed2d8..80da3798 100644 --- a/man/man1/fgscr.1 +++ b/man/man1/fgscr.1df @@ -1,7 +1,7 @@ -.TH GSCR 1 "July 2016" "Manual page for fgscr" +.TH GSCR 1df "July 2016" "Manual page for fgscr" .SH NAME .B fgscr -\- find Git repositories and scrub them with gscr(1) +\- find Git repositories and scrub them with gscr(1df) .SH SYNOPSIS .B fgscr .br @@ -9,8 +9,8 @@ .SH DESCRIPTION .B fgscr searches for Git repositories recursively with the given ancestor directory -(defaults to the current directory), and runs gscr(1) over them. +(defaults to the current directory), and runs gscr(1df) over them. .SH SEE ALSO -git(1), gscr(1), isgr(1) +git(1), gscr(1df), isgr(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/fnl.1 b/man/man1/fnl.1df index a578dbf4..6c34f19c 100644 --- a/man/man1/fnl.1 +++ b/man/man1/fnl.1df @@ -1,4 +1,4 @@ -.TH FNL 1 "August 2016" "Manual page for fnl" +.TH FNL 1df "August 2016" "Manual page for fnl" .SH NAME .B fnl \- list the biggest files in the given directory @@ -8,9 +8,9 @@ command arg1 ... .SH DESCRIPTION .B fnl runs the command specifies in its arguments, writing any stdout and stderr to -separate temporary files created with mktd(1), and then runs wc(1) over them to +separate temporary files created with mktd(1df), and then runs wc(1) over them to show their statistics and full paths. .SH SEE ALSO -igex(1) +igex(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/gms.1 b/man/man1/gms.1df index 34b1ece0..b6b0f716 100644 --- a/man/man1/gms.1 +++ b/man/man1/gms.1df @@ -1,4 +1,4 @@ -.TH GMS 1 "June 2016" "Manual page for gms" +.TH GMS 1df "June 2016" "Manual page for gms" .SH NAME .B gms \- run getmail(1) requests in parallel over multiple getmailrc.* files @@ -11,14 +11,14 @@ doing much the same thing as the getmails(1) script included in the Getmail distribution. It differs from that script in a few ways: .IP \[bu] 4 It includes per-rc-file locking so that at most one getmail(1) process runs for -the same account, but allows multiple instances of gms(1) to run at the same +the same account, but allows multiple instances of gms(1df) to run at the same time. .IP \[bu] It runs the requests in parallel using fork(2)/wait(2). .IP \[bu] -It uses try(1) to attempt each fetch three times, with 15 seconds between each +It uses try(1df) to attempt each fetch three times, with 15 seconds between each attempt, and only prints errors if all three attempts fail. .SH SEE ALSO -getmail(1), try(1) +getmail(1), try(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/grc.1 b/man/man1/grc.1df index dffe75e6..3eab5d0b 100644 --- a/man/man1/grc.1 +++ b/man/man1/grc.1df @@ -1,4 +1,4 @@ -.TH GRC 1 "June 2016" "Manual page for grc" +.TH GRC 1df "June 2016" "Manual page for grc" .SH NAME .B grc \- return whether dir is a Git repository with pending changes @@ -12,6 +12,6 @@ checks whether the given directory (defaulting to the working directory) is a Git repository and has pending changes. Normally this emits no output. .SH SEE ALSO -git(1), isgr(1) +git(1), isgr(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/gscr.1 b/man/man1/gscr.1df index d5495929..93683681 100644 --- a/man/man1/gscr.1 +++ b/man/man1/gscr.1df @@ -1,4 +1,4 @@ -.TH GSCR 1 "July 2016" "Manual page for gscr" +.TH GSCR 1df "July 2016" "Manual page for gscr" .SH NAME .B gscr \- scrub a Git repository to pack it and reduce its size @@ -16,6 +16,6 @@ runs the git fsck, reflog --expire, and gc commands to get rid of dangling commit objects in a repository and pack the repository down as small as possible. Each command will only run if the one before it exited non-zero. .SH SEE ALSO -git(1), fgscr(1), isgr(1) +git(1), fgscr(1df), isgr(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/han.1 b/man/man1/han.1df index efa72645..1372fd90 100644 --- a/man/man1/han.1 +++ b/man/man1/han.1df @@ -1,4 +1,4 @@ -.TH HAN 1 "May 2015" "Manual page for han" +.TH HAN 1df "May 2015" "Manual page for han" .SH NAME .B han \- try running builtin help, then man(1) diff --git a/man/man1/hurl.1 b/man/man1/hurl.1df index 23a73085..548b03b8 100644 --- a/man/man1/hurl.1 +++ b/man/man1/hurl.1df @@ -1,4 +1,4 @@ -.TH HURL 1 "June 2016" "Manual page for hurl" +.TH HURL 1df "June 2016" "Manual page for hurl" .SH NAME .B hurl \- parse contents of href attributes of <a> elements from HTML pages @@ -19,6 +19,6 @@ order. .SH SEE ALSO [1] pup: https://github.com/ericchiang/pup .br -murl(1), urlc(1) +murl(1df), urlc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/igex.1 b/man/man1/igex.1df index 731041c6..d2920c05 100644 --- a/man/man1/igex.1 +++ b/man/man1/igex.1df @@ -1,4 +1,4 @@ -.TH IGEX 1 "August 2016" "Manual page for igex" +.TH IGEX 1df "August 2016" "Manual page for igex" .SH NAME .B igex \- run a command, ignoring specified error exit values diff --git a/man/man1/isgr.1 b/man/man1/isgr.1df index 06d089ac..0f313579 100644 --- a/man/man1/isgr.1 +++ b/man/man1/isgr.1df @@ -1,4 +1,4 @@ -.TH ISGR 1 "August 2016" "Manual page for isgr" +.TH ISGR 1df "August 2016" "Manual page for isgr" .SH NAME .B isgr \- print a count of entries in a directory @@ -13,6 +13,6 @@ exits with 0 if the given directory (or the current directory if one is not given) appears to be a working copy of a Git repository. It exits 1 otherwise. All output from the git(1) commands used to check this is suppressed. .SH SEE ALSO -git(1), gscr(1), fgscr(1), grc(1) +git(1), gscr(1df), fgscr(1df), grc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/jfc.1 b/man/man1/jfc.1df index 12be2f61..135fefa8 100644 --- a/man/man1/jfc.1 +++ b/man/man1/jfc.1df @@ -1,4 +1,4 @@ -.TH JFC 1 "June 2016" "Manual page for jfc" +.TH JFC 1df "June 2016" "Manual page for jfc" .SH NAME .B jfc \- add all and commit quietly to a Git repository with a stock message @@ -16,6 +16,6 @@ author uses it for his ~/.remind files. .SH NOTES Can you guess what it stands for? .SH SEE ALSO -git(1), jfcd(1), isgr(1), grc(1) +git(1), jfcd(1df), isgr(1df), grc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/jfcd.1 b/man/man1/jfcd.1df index 9efa9d07..5ca631b3 100644 --- a/man/man1/jfcd.1 +++ b/man/man1/jfcd.1df @@ -1,4 +1,4 @@ -.TH JFCD 1 "June 2016" "Manual page for jfcd" +.TH JFCD 1df "June 2016" "Manual page for jfcd" .SH NAME .B jfcd \- watch a directory and automatically commit changes to it @@ -8,9 +8,9 @@ .SH DESCRIPTION .B jfcd watches a directory recursively with inotifywait(1) and commits all changes -with jfc(1) as it detects them. It logs its output and errors to syslog using +with jfc(1df) as it detects them. It logs its output and errors to syslog using logger(1). .SH SEE ALSO -git(1), inotifywait(1), jfc(1), logger(1) +git(1), inotifywait(1), jfc(1df), logger(1) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/maybe.1 b/man/man1/maybe.1df index 3d27901b..5a94a59e 100644 --- a/man/man1/maybe.1 +++ b/man/man1/maybe.1df @@ -1,5 +1,3 @@ -.TH MAYBE 1 "August 2016" "Manual page for maybe" -.SH NAME .B maybe \- possibly exit with success .SH USAGE @@ -16,12 +14,12 @@ probability. Good for using in tests. Exits with 2 rather than 1 on usage errors. .P The numerator default to 1 and the denominator to 2 for a roughly equal chance -of success or failure. rndi(1) is used for the randomness. +of success or failure. rndi(1df) is used for the randomness. .P $ maybe $ maybe 3 $ maybe 2 5 .SH SEE ALSO -true(1), false(1), try(1), rndi(1) +true(1), false(1), try(1df), rndi(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/mkcp.1 b/man/man1/mkcp.1df index 6db6ec1f..1beae4a8 100644 --- a/man/man1/mkcp.1 +++ b/man/man1/mkcp.1df @@ -1,4 +1,4 @@ -.TH MKCP 1 "July 2016" "Manual page for mkcp" +.TH MKCP 1df "July 2016" "Manual page for mkcp" .SH NAME .B mkcp \- create last argument as directory and copy remaining arguments into it @@ -14,6 +14,6 @@ combines mkdir(1) and cp(1) into one call, creating the last argument as a directory and recursively copying the remaining arguments into it. If the directory creation fails, the script stops before attempting the copy. .SH SEE ALSO -mkdir(1), cp(1), mkmv(1) +mkdir(1), cp(1), mkmv(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/mkmv.1 b/man/man1/mkmv.1df index 28056021..f00fe266 100644 --- a/man/man1/mkmv.1 +++ b/man/man1/mkmv.1df @@ -1,4 +1,4 @@ -.TH MKMV 1 "August 2016" "Manual page for mkmv" +.TH MKMV 1df "August 2016" "Manual page for mkmv" .SH NAME .B mkmv \- create last argument as directory and move remaining arguments into it @@ -14,6 +14,6 @@ combines mkdir(1) and mv(1) into one call, creating the last argument as a directory and moving the remaining arguments into it. If the directory creation fails, the script stops before attempting the move. .SH SEE ALSO -mkdir(1), mv(1), mkmv(1) +mkdir(1), mv(1), mkmv(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/mktd.1 b/man/man1/mktd.1df index 680cbd61..8224d2d7 100644 --- a/man/man1/mktd.1 +++ b/man/man1/mktd.1df @@ -1,4 +1,4 @@ -.TH MKTD 1 "August 2016" "Manual page for mktd" +.TH MKTD 1df "August 2016" "Manual page for mktd" .SH NAME .B mktd \- try hard to safely create a temporary directory in a POSIX-compliant way @@ -31,7 +31,7 @@ You could use it in a script like this: done td=$(mktd myprogram) || exit .SH SEE ALSO -rndi(1) +rndi(1df) .br <http://mywiki.wooledge.org/BashFAQ/062> .SH AUTHOR diff --git a/man/man1/motd.1 b/man/man1/motd.1df index 50350a52..6e8725ce 100644 --- a/man/man1/motd.1 +++ b/man/man1/motd.1df @@ -1,4 +1,4 @@ -.TH MOTD 1 "August 2016" "Manual page for motd" +.TH MOTD 1df "August 2016" "Manual page for motd" .SH NAME .B motd \- show the system MOTD file diff --git a/man/man1/murl.1 b/man/man1/murl.1df index ecff8623..f022152b 100644 --- a/man/man1/murl.1 +++ b/man/man1/murl.1df @@ -1,7 +1,7 @@ -.TH MURL 1 "June 2016" "Manual page for murl" +.TH MURL 1df "June 2016" "Manual page for murl" .SH NAME .B murl -\- convert Markdown to HTML with pandoc(1) and extract URLs from it with hurl(1) +\- convert Markdown to HTML with pandoc(1) and extract URLs from it with hurl(1df) .SH SYNOPSIS .B murl README.markdown @@ -14,10 +14,10 @@ find -type f -name '*.markdown' -exec cat {} \\; | .SH DESCRIPTION .B murl renders its Markdown input into HTML using pandoc(1), and passes that to -hurl(1) which in turn prints the links from the rendered content. +hurl(1df) which in turn prints the links from the rendered content. .SH SEE ALSO [1] pup: https://github.com/ericchiang/pup .br -hurl(1), urlc(1) +hurl(1df), urlc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/pa.1 b/man/man1/pa.1df index 51eedacd..4800c085 100644 --- a/man/man1/pa.1 +++ b/man/man1/pa.1df @@ -1,4 +1,4 @@ -.TH PA 1 "July 2016" "Manual page for pa" +.TH PA 1df "July 2016" "Manual page for pa" .SH NAME .B pa \- print the given arguments one per line @@ -10,6 +10,6 @@ arg1 arg2 arg3 prints each of its arguments followed by a newline. If there are no arguments, it does nothing. .SH SEE ALSO -paz(1) +paz(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/paz.1 b/man/man1/paz.1df index 531552f6..b34fa6c4 100644 --- a/man/man1/paz.1 +++ b/man/man1/paz.1df @@ -1,4 +1,4 @@ -.TH PAZ 1 "July 2016" "Manual page for paz" +.TH PAZ 1df "July 2016" "Manual page for paz" .SH NAME .B paz \- print the given arguments null-terminated @@ -10,6 +10,6 @@ arg1 arg2 arg3 prints each of its arguments followed by a null character. If there are no arguments, it does nothing. .SH SEE ALSO -pa(1) +pa(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/pit.1 b/man/man1/pit.1df index 34a00aff..f4165845 100644 --- a/man/man1/pit.1 +++ b/man/man1/pit.1df @@ -1,4 +1,4 @@ -.TH PIT 1 "July 2016" "Manual page for pit" +.TH PIT 1df "July 2016" "Manual page for pit" .SH NAME .B pit \- show arguments or output in a pager if stdout looks like a terminal diff --git a/man/man1/plmu.1 b/man/man1/plmu.1df index b92bff3b..4cae1d85 100644 --- a/man/man1/plmu.1 +++ b/man/man1/plmu.1df @@ -1,4 +1,4 @@ -.TH PLMU 1 "June 2016" "Manual page for plmu" +.TH PLMU 1df "June 2016" "Manual page for plmu" .SH NAME .B plmu \- upgrade plenv[1] modules with cpanm(1) diff --git a/man/man1/rfcf.1 b/man/man1/rfcf.1df index 2e60ee82..1f6a77c8 100644 --- a/man/man1/rfcf.1 +++ b/man/man1/rfcf.1df @@ -1,4 +1,4 @@ -.TH RFCF 1 "July 2016" "Manual page for rfcf" +.TH RFCF 1df "July 2016" "Manual page for rfcf" .SH NAME .B rfcf \- fetch an RFC from the IETF site and write it to stdout @@ -10,6 +10,6 @@ retrieves the RFC with the given number from the IETF website and writes its contents to stdout. .SH SEE ALSO -rfct(1), rfcr(1) +rfct(1df), rfcr(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rfcr.1 b/man/man1/rfcr.1df index 00dcb219..d4255207 100644 --- a/man/man1/rfcr.1 +++ b/man/man1/rfcr.1df @@ -1,4 +1,4 @@ -.TH RFCR 1 "July 2016" "Manual page for rfcr" +.TH RFCR 1df "July 2016" "Manual page for rfcr" .SH NAME .B rfcr \- fetch and format an RFC from the IETF website and view it on a terminal @@ -7,10 +7,10 @@ 1918 .SH DESCRIPTION .B rfcr -retrieves the RFC with the given number from the IETF website with rfcf(1), -formats it with rfct(1), and passes the output to pit(1) for either pager +retrieves the RFC with the given number from the IETF website with rfcf(1df), +formats it with rfct(1df), and passes the output to pit(1df) for either pager display or simple output. .SH SEE ALSO -rfcf(1), rfct(1) +rfcf(1df), rfct(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rfct.1 b/man/man1/rfct.1df index 60d9d3d4..1ef76011 100644 --- a/man/man1/rfct.1 +++ b/man/man1/rfct.1df @@ -1,4 +1,4 @@ -.TH RFCT 1 "July 2016" "Manual page for rfct" +.TH RFCT 1df "July 2016" "Manual page for rfct" .SH NAME .B rfct \- format the contents of an RFC for nicer reading @@ -14,6 +14,6 @@ strips page headers and footers and possibly other rubbish from the ASCII versions of RFC documents as retrieved from the IETF website and writes them to stdout. .SH SEE ALSO -rfcf(1), rfcr(1) +rfcf(1df), rfcr(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rmrej.1 b/man/man1/rmrej.1df index eeff999c..9af77837 100644 --- a/man/man1/rmrej.1 +++ b/man/man1/rmrej.1df @@ -1,4 +1,4 @@ -.TH RMREJ 1 "August 2016" "Manual page for rmrej" +.TH RMREJ 1df "August 2016" "Manual page for rmrej" .SH NAME .B rmrej \- delete all rejected hunks from a failed patch(1) diff --git a/man/man1/rnda.1 b/man/man1/rnda.1df index 4cfd7cbd..5cdf708c 100644 --- a/man/man1/rnda.1 +++ b/man/man1/rnda.1df @@ -1,4 +1,4 @@ -.TH RNDA 1 "August 2016" "Manual page for rnda" +.TH RNDA 1df "August 2016" "Manual page for rnda" .SH NAME .B rnda \- return a low-quality random choice from the given arguments @@ -7,10 +7,10 @@ arg1 arg2 arg3 .SH DESCRIPTION .B rnda -prints a random choice from the given arguments. It uses rndi(1), which is +prints a random choice from the given arguments. It uses rndi(1df), which is probably not a high-quality source, but should differ within seconds and between runs on most systems. .SH SEE ALSO -rndf(1), rndi(1), rndl(1), rnds(1), rndn(6) +rndf(1df), rndi(1df), rndl(1df), rnds(1df), rndn(6df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rndf.1 b/man/man1/rndf.1df index f523c3ac..a089378b 100644 --- a/man/man1/rndf.1 +++ b/man/man1/rndf.1df @@ -1,4 +1,4 @@ -.TH RNDF 1 "August 2016" "Manual page for rndf" +.TH RNDF 1df "August 2016" "Manual page for rndf" .SH NAME .B rndf \- return a low-quality random choice of a random file in a directory @@ -11,10 +11,10 @@ .SH DESCRIPTION .B rndf prints the name a random file (excluding dot files) from the given directory, -defaulting to the current directory. It uses rndi(1), which is probably not a +defaulting to the current directory. It uses rndi(1df), which is probably not a high-quality source, but should differ within seconds and between runs on most systems. .SH SEE ALSO -rndi(1), rnda(1), rndl(1), rnds(1), rndn(6) +rndi(1df), rnda(1df), rndl(1df), rnds(1df), rndn(6df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rndi.1 b/man/man1/rndi.1df index 094a5f62..767ad148 100644 --- a/man/man1/rndi.1 +++ b/man/man1/rndi.1df @@ -1,4 +1,4 @@ -.TH RNDI 1 "August 2016" "Manual page for rndi" +.TH RNDI 1df "August 2016" "Manual page for rndi" .SH NAME .B rndi \- return a low-quality random integer @@ -20,6 +20,6 @@ second. This should not be used in any sort of security or statistical context. The author wrote it to support scripts to choose a random background image from a directory. .SH SEE ALSO -rnda(1), rndf(1), rndl(1), rnds(1), rndn(6) +rnda(1df), rndf(1df), rndl(1df), rnds(1df), rndn(6df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rndl.1 b/man/man1/rndl.1 deleted file mode 100644 index 69deb42b..00000000 --- a/man/man1/rndl.1 +++ /dev/null @@ -1,22 +0,0 @@ -.TH RNDL 1 "August 2016" "Manual page for rndl" -.SH NAME -.B rndl -\- return a low-quality random choice of a random line from files -.SH SYNOPSIS -.B rndl -file -.br -.B rndl -file1 file2 file3 -.br -command | -.B rndl -.SH DESCRIPTION -.B rndl -prints a random line from its input, using rndi(1) to choose it. It uses -rndi(1), which is probably not a high-quality source, but should differ within -seconds and between runs on most systems. -.SH SEE ALSO -rndi(1), rnda(1), rndf(1), rnds(1), rndn(6) -.SH AUTHOR -Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rndl.1df b/man/man1/rndl.1df new file mode 100644 index 00000000..ec44564a --- /dev/null +++ b/man/man1/rndl.1df @@ -0,0 +1,22 @@ +.TH RNDL 1df "August 2016" "Manual page for rndl" +.SH NAME +.B rndl +\- return a low-quality random choice of a random line from files +.SH SYNOPSIS +.B rndl +file +.br +.B rndl +file1 file2 file3 +.br +command | +.B rndl +.SH DESCRIPTION +.B rndl +prints a random line from its input, using rndi(1df) to choose it. This is +probably not a high-quality source, but should differ within seconds and +between runs on most systems. +.SH SEE ALSO +rndi(1df), rnda(1df), rndf(1df), rnds(1df), rndn(6df) +.SH AUTHOR +Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/rnds.1 b/man/man1/rnds.1df index f259bd84..04e905d7 100644 --- a/man/man1/rnds.1 +++ b/man/man1/rnds.1df @@ -1,4 +1,4 @@ -.TH RNDS 1 "August 2016" "Manual page for rnds" +.TH RNDS 1df "August 2016" "Manual page for rnds" .SH NAME .B rnds \- try to get a random seed @@ -11,13 +11,13 @@ uses POSIX tools to try and find a random number device on the system and emits the first field of a cksum(1) based on it as a low-quality random numeric seed. The only optional argument allows specifying the number of random bytes to -read, defaulting to 32. This is intended as a low-quality seed for rndi(1). +read, defaulting to 32. This is intended as a low-quality seed for rndi(1df). .P /dev/urandom is tried first, then /dev/arandom, then /dev/random, before the script gives up and emits nothing. .P If you have OpenSSL, you will almost certainly prefer rand(1ssl). .SH SEE ALSO -rndi(1), rnda(1), rndf(1), rndl(1), rand(1ssl), rndn(6) +rndi(1df), rnda(1df), rndf(1df), rndl(1df), rand(1ssl), rndn(6df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/sd2u.1 b/man/man1/sd2u.1df index 2903447c..53fd4f95 100644 --- a/man/man1/sd2u.1 +++ b/man/man1/sd2u.1df @@ -1,4 +1,4 @@ -.TH SD2U 1 "August 2016" "Manual page for sd2u" +.TH SD2U 1df "August 2016" "Manual page for sd2u" .SH NAME .B sd2u \- change text stream from DOS to UNIX format @@ -16,6 +16,6 @@ program | Applies sed(1) to change DOS \\r\\n (CRLF) line endings to UNIX \\n line endings. Lines already in UNIX format should be unchanged. .SH SEE ALSO -sed(1), su2d(1), d2u(1), u2d(1) +sed(1), su2d(1df), d2u(1df), u2d(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/shb.1 b/man/man1/shb.1df index 64c7e0f9..4f096713 100644 --- a/man/man1/shb.1 +++ b/man/man1/shb.1df @@ -1,4 +1,4 @@ -.TH SHB 1 "August 2016" "Manual page for shb" +.TH SHB 1df "August 2016" "Manual page for shb" .SH NAME .B shb \- insert a shebang line above a file diff --git a/man/man1/sls.1 b/man/man1/sls.1df index d876b976..730be440 100644 --- a/man/man1/sls.1 +++ b/man/man1/sls.1df @@ -1,4 +1,4 @@ -.TH SLS 1 "May 2014" "Manual page for sls" +.TH SLS 1df "May 2014" "Manual page for sls" .SH NAME .B sls \- list the first hostname on each line of an ssh_config(5) file @@ -9,10 +9,11 @@ ssh_config_alt1 ssh_config_alt2 .SH DESCRIPTION .B sls -runs slsf(1) on the given set of ssh_config(5) files to print the first +runs slsf(1df) on the given set of ssh_config(5) files to print the first non-wildcard hostname on each "Host" line, defaulting to /etc/ssh/ssh_config -and ~/.ssh/config if they exist. Suitable for use in batch scripts like sra(1). +and ~/.ssh/config if they exist. Suitable for use in batch scripts like +sra(1df). .SH SEE ALSO -slsf(1), sra(1), sta(1), ssh(1), ssh_config(5) +slsf(1df), sra(1df), sta(1df), ssh(1), ssh_config(5) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/slsf.1 b/man/man1/slsf.1df index b34a719d..03ee46a3 100644 --- a/man/man1/slsf.1 +++ b/man/man1/slsf.1df @@ -1,4 +1,4 @@ -.TH SLSF 1 "July 2016" "Manual page for slsf" +.TH SLSF 1df "July 2016" "Manual page for slsf" .SH NAME .B slsf \- list the first hostname on each line of ssh_config(5) files @@ -12,7 +12,7 @@ cat ~/.ssh_config | .B slsf iterates through the ssh_config(5) files given as its input and prints the first name given on each "Host" line, as long as it contains no wildcards. Most -users will probably want the sls(1) frontend. +users will probably want the sls(1df) frontend. .P Within the file, a comment "### nosls" on its own line will exclude all following output unless an "### sls" comment is read to resume it again: @@ -24,6 +24,6 @@ following output unless an "### sls" comment is read to resume it again: ### sls Host wanted3 .SH SEE ALSO -sls(1), sra(1), sta(1), ssh(1), ssh_config(5) +sls(1df), sra(1df), sta(1df), ssh(1), ssh_config(5) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/spr.1 b/man/man1/spr.1df index 1039ae4b..6f1ae79f 100644 --- a/man/man1/spr.1 +++ b/man/man1/spr.1df @@ -1,4 +1,4 @@ -.TH SPR 1 "July 2016" "Manual page for spr" +.TH SPR 1df "July 2016" "Manual page for spr" .SH NAME .B spr \- post input to sprunge.us pastebin and print the URL to stdout diff --git a/man/man1/sra.1 b/man/man1/sra.1df index db4d1abd..4c071f62 100644 --- a/man/man1/sra.1 +++ b/man/man1/sra.1df @@ -1,15 +1,15 @@ -.TH SRA 1 "May 2014" "Manual page for sra" +.TH SRA 1df "May 2014" "Manual page for sra" .SH NAME .B sra -\- run a command on sls(1) hosts +\- run a command on sls(1df) hosts .SH SYNOPSIS .B sra .I [COMMAND] .SH DESCRIPTION .B sra opens a secure shell or runs a command with ssh(1) on all the hosts returned by -sls(1). +sls(1df). .SH SEE ALSO -sta(1), sls(1) +sta(1df), sls(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/sshi.1 b/man/man1/sshi.1df index 8f9ee41d..8cddaa87 100644 --- a/man/man1/sshi.1 +++ b/man/man1/sshi.1df @@ -1,4 +1,4 @@ -.TH SSHI 1 "August 2016" "Manual page for sshi" +.TH SSHI 1df "August 2016" "Manual page for sshi" .SH NAME .B sshi \- show human-readable details of the current SSH connection diff --git a/man/man1/sta.1 b/man/man1/sta.1df index 0a5b82c0..36551f81 100644 --- a/man/man1/sta.1 +++ b/man/man1/sta.1df @@ -1,17 +1,17 @@ -.TH STA 1 "May 2014" "Manual page for sta" +.TH STA 1df "May 2014" "Manual page for sta" .SH NAME .B sta -\- run a command on sls(1) hosts and print the hostname if successful +\- run a command on sls(1df) hosts and print the hostname if successful .SH SYNOPSIS .B sta .I [COMMAND] .SH DESCRIPTION .B sta attempts a connection and optionally runs a nominated command on all the hosts -returned by sls(1), and prints the hostname if connected and if the optional +returned by sls(1df), and prints the hostname if connected and if the optional command has an exit value of 0. The stdout from the commands is discarded, but stderr is shown. .SH SEE ALSO -sra(1), sls(1) +sra(1df), sls(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/stbl.1 b/man/man1/stbl.1df index b6339780..440f0ca2 100644 --- a/man/man1/stbl.1 +++ b/man/man1/stbl.1df @@ -1,4 +1,4 @@ -.TH STBL 1 "August 2016" "Manual page for stbl" +.TH STBL 1df "August 2016" "Manual page for stbl" .SH NAME .B stbl \- strip a trailing blank line from files @@ -8,6 +8,6 @@ Applies ed(1) to remove one trailing newline, if present, from each of the given files. .SH SEE ALSO -ed(1), stws(1) +ed(1), stws(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/stex.1 b/man/man1/stex.1df index 26392fb9..ebbea7ad 100644 --- a/man/man1/stex.1 +++ b/man/man1/stex.1df @@ -1,4 +1,4 @@ -.TH STEX 1 "August 2016" "Manual page for stex" +.TH STEX 1df "August 2016" "Manual page for stex" .SH NAME .B stex \- strip extensions from the given filenames if present diff --git a/man/man1/stws.1 b/man/man1/stws.1df index 717ce8d1..17674afa 100644 --- a/man/man1/stws.1 +++ b/man/man1/stws.1df @@ -1,4 +1,4 @@ -.TH STWS 1 "August 2016" "Manual page for stws" +.TH STWS 1df "August 2016" "Manual page for stws" .SH NAME .B stws \- strip trailing spaces from files @@ -8,6 +8,6 @@ Applies ed(1) to remove all trailing spaces at the end of lines, if present, from each of the given files. .SH SEE ALSO -ed(1), stbl(1) +ed(1), stbl(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/su2d.1 b/man/man1/su2d.1df index 6dc71787..7de9ec03 100644 --- a/man/man1/su2d.1 +++ b/man/man1/su2d.1df @@ -1,4 +1,4 @@ -.TH SU2D 1 "August 2016" "Manual page for su2d" +.TH SU2D 1df "August 2016" "Manual page for su2d" .SH NAME .B su2d \- change text files from UNIX to DOS format @@ -15,6 +15,6 @@ program | Applies sed(1) to change UNIX \\n line endings to DOS \\r\\n (CRLF) line endings. Lines already in DOS format should be unchanged. .SH SEE ALSO -sed(1), sd2u(1), d2u(1), u2d(1) +sed(1), sd2u(1df), d2u(1df), u2d(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/td.1 b/man/man1/td.1df index ea3f9095..df1ff82f 100644 --- a/man/man1/td.1 +++ b/man/man1/td.1df @@ -1,4 +1,4 @@ -.TH TD 1 "June 2016" "Manual page for td" +.TH TD 1df "June 2016" "Manual page for td" .SH NAME .B td \- manage to-do files diff --git a/man/man1/tl.1 b/man/man1/tl.1df index 4cbc8025..eee3bc98 100644 --- a/man/man1/tl.1 +++ b/man/man1/tl.1df @@ -1,4 +1,4 @@ -.TH TL 1 "Augusr 2016" "Manual page for tl" +.TH TL 1df "Augusr 2016" "Manual page for tl" .SH NAME .B tl \- tag lines with a string prefix and/or suffix @@ -15,6 +15,6 @@ given, defaults to reading standard input. $ tl -p 'file: ' /path/to/file $ dmesg | tl -s ' (stdout)' .SH SEE ALSO -tlcs(1) +tlcs(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/tlcs.1 b/man/man1/tlcs.1df index f032deef..e8f4fefa 100644 --- a/man/man1/tlcs.1 +++ b/man/man1/tlcs.1df @@ -1,4 +1,4 @@ -.TH TLCS 1 "August 2016" "Manual page for tlcs" +.TH TLCS 1df "August 2016" "Manual page for tlcs" .SH NAME .B tlcs \- execute command and tag stdout/stderr lines @@ -6,7 +6,7 @@ .B tlcs [-c] [-o STDOUT_PREFIX] [-e STDERR_PREFIX] [--] COMMAND [ARG1...] .SH DESCRIPTION Execute a command and tag the output of the stdout and stderr streams, line by -line, using tl(1) under the hood. Add -c when writing to a terminal to color +line, using tl(1df) under the hood. Add -c when writing to a terminal to color the lines. .P Specify a stdout prefix with -o (default "stdout: "), and/or a stderr prefix @@ -17,6 +17,6 @@ Remaining arguments are assumed to be a command and its arguments. $ tlcs cat ~/.vimrc $ tlcs -e 'FAIL: ' nonexistent-command .SH SEE ALSO -tl(1) +tl(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/try.1 b/man/man1/try.1df index 5c4459b0..d982c1d3 100644 --- a/man/man1/try.1 +++ b/man/man1/try.1df @@ -1,4 +1,4 @@ -.TH TRY 1 "August 2016" "Manual page for try" +.TH TRY 1df "August 2016" "Manual page for try" .SH NAME .B try \- attempt a command up to a certain number of times until it succeeds @@ -17,6 +17,6 @@ run. $ try maybe $ try -n5 -s10 gms .SH SEE ALSO -maybe(1) +maybe(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/u2d.1 b/man/man1/u2d.1df index 271b28ac..3bb16092 100644 --- a/man/man1/u2d.1 +++ b/man/man1/u2d.1df @@ -1,4 +1,4 @@ -.TH U2D 1 "August 2016" "Manual page for u2d" +.TH U2D 1df "August 2016" "Manual page for u2d" .SH NAME .B u2d \- change text files from UNIX to DOS format @@ -8,6 +8,6 @@ Applies ed(1) to change UNIX \\n line endings to DOS \\r\\n (CRLF) line endings. Files already in DOS format should be unchanged. .SH SEE ALSO -ed(1), d2u(1), sd2u(1), su2d(1) +ed(1), d2u(1df), sd2u(1df), su2d(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/unf.1 b/man/man1/unf.1df index 57d4548f..b74ef9ce 100644 --- a/man/man1/unf.1 +++ b/man/man1/unf.1df @@ -1,4 +1,4 @@ -.TH UNF 1 "August 2016" "Manual page for unf" +.TH UNF 1df "August 2016" "Manual page for unf" .SH NAME .B unf \- join lines with leading spaces to the previous line diff --git a/man/man1/urlc.1 b/man/man1/urlc.1df index b4234a3d..a5a6bcce 100644 --- a/man/man1/urlc.1 +++ b/man/man1/urlc.1df @@ -1,4 +1,4 @@ -.TH URLC 1 "June 2016" "Manual page for urlc" +.TH URLC 1df "June 2016" "Manual page for urlc" .SH NAME .B urlc \- check a list of URLs for errors, redirects, and available secure @@ -18,6 +18,6 @@ iterates through the newline-delimited URLs passed to it on stdin and using curl(1) requests checks for retrieval errors, redirects, and tries a naïve check to see if an HTTPS version is available of any unencrypted HTTP traffic. .SH SEE ALSO -curl(1), hurl(1), murl(1) +curl(1), hurl(1df), murl(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/urlh.1 b/man/man1/urlh.1df index 5066c7d0..d17f0a74 100644 --- a/man/man1/urlh.1 +++ b/man/man1/urlh.1df @@ -1,4 +1,4 @@ -.TH URLH 1 "August 2016" "Manual page for urlh" +.TH URLH 1df "August 2016" "Manual page for urlh" .SH NAME .B urlh \- search for URL header values by name @@ -12,6 +12,6 @@ makes a cURL HEAD request for the given URL, and searches the headers for a key matching the given name, case-insensitively. It prints any matching values to stdout. .SH SEE ALSO -curl(1), urlmt(1) +curl(1), urlmt(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/urlmt.1 b/man/man1/urlmt.1df index 843f7d81..892b10d4 100644 --- a/man/man1/urlmt.1 +++ b/man/man1/urlmt.1df @@ -1,4 +1,4 @@ -.TH URLMT 1 "August 2016" "Manual page for urlmt" +.TH URLMT 1df "August 2016" "Manual page for urlmt" .SH NAME .B urlmt \- try to get the MIME type of the document at the given URL @@ -7,9 +7,9 @@ https://www.sanctum.geek.nz/ .SH DESCRIPTION .B urlmt -uses urlh(1) to search for a Content-Type header for the given URL, and prints +uses urlh(1df) to search for a Content-Type header for the given URL, and prints it with any trailing data (e.g. charset) trimmed off. .SH SEE ALSO -curl(1), urlh(1) +curl(1), urlh(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/xgo.1 b/man/man1/xgo.1df index 5eec6517..368708a2 100644 --- a/man/man1/xgo.1 +++ b/man/man1/xgo.1df @@ -1,4 +1,4 @@ -.TH XGO 1 "August 2016" "Manual page for xgo" +.TH XGO 1df "August 2016" "Manual page for xgo" .SH NAME .B xgo \- view the given URL in an appropriate program, falling back on $BROWSER @@ -13,6 +13,6 @@ falling back on $BROWSER. The choices of application are very opinionated. There could probably be a MIME-type and/or URL-pattern to program configuration file, rather than hard-coding it. .SH SEE ALSO -br(1), xgoc(1) +br(1df), xgoc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/xgoc.1 b/man/man1/xgoc.1df index a4c23571..d4244a09 100644 --- a/man/man1/xgoc.1 +++ b/man/man1/xgoc.1df @@ -1,4 +1,4 @@ -.TH XGOC 1 "August 2016" "Manual page for xgoc" +.TH XGOC 1df "August 2016" "Manual page for xgoc" .SH NAME .B xgoc \- view an URL in the X clipboard in an appropriate program @@ -6,8 +6,8 @@ .B xgoc .SH DESCRIPTION .B xgoc -reads an URL from the X clipboard with xsel(1) and runs xgo(1) on it. +reads an URL from the X clipboard with xsel(1) and runs xgo(1df) on it. .SH SEE ALSO -br(1), xgoc(1) +br(1df), xgoc(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man1/xrbg.1 b/man/man1/xrbg.1df index 05ced37d..481c9185 100644 --- a/man/man1/xrbg.1 +++ b/man/man1/xrbg.1df @@ -1,4 +1,4 @@ -.TH XRBG 1 "March 2016" "Manual page for xrbg" +.TH XRBG 1df "March 2016" "Manual page for xrbg" .SH NAME .B xrbg \- apply a random X background image with feh(1) @@ -10,10 +10,10 @@ XBACKGROUNDS=/path/to/images .SH DESCRIPTION .B xrbg searches for images in the directory named in the XBACKGROUNDS environment -variable (defaults to ~/.xbackgrounds), chooses a random one with rndf(1), and -applies it with feh(1). It's designed for use in ~/.xinitrc, but it seems to -work when called manually from within an X session too. +variable (defaults to ~/.xbackgrounds), chooses a random one with rndf(1df), +and applies it with feh(1). It's designed for use in ~/.xinitrc, but it seems +to work when called manually from within an X session too. .SH SEE ALSO -feh(1), rndf(1) +feh(1), rndf(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man6/aaf.6 b/man/man6/aaf.6df index bd3fdadb..915cdefd 100644 --- a/man/man6/aaf.6 +++ b/man/man6/aaf.6df @@ -1,4 +1,4 @@ -.TH AAF 6 "June 2016" "Manual page for aaf" +.TH AAF 6df "June 2016" "Manual page for aaf" .SH NAME .B aaf \- print a random ASCII Art Farts comic diff --git a/man/man6/acq.6 b/man/man6/acq.6df index c3a94d27..a2f17250 100644 --- a/man/man6/acq.6 +++ b/man/man6/acq.6df @@ -1,4 +1,4 @@ -.TH ACQ 6 "August 2016" "Manual page for acq" +.TH ACQ 6df "August 2016" "Manual page for acq" .SH NAME .B acq \- interrogate AC, the interplanetary computer diff --git a/man/man6/dr.6 b/man/man6/dr.6df index fc586bb2..14787691 100644 --- a/man/man6/dr.6 +++ b/man/man6/dr.6df @@ -1,4 +1,4 @@ -.TH DR 6 "August 2016" "Manual page for dr" +.TH DR 6df "August 2016" "Manual page for dr" .SH NAME .B dr \- roll D&D dice @@ -16,6 +16,6 @@ d6 rolls dice according to the formulas used in D&D and other tabletop roleplaying games. It only allows d4, d6, d8, d10, d12, and d20 dice. .SH SEE ALSO -rndi(1) +rndi(1df) .SH AUTHOR Tom Ryder <tom@sanctum.geek.nz> diff --git a/man/man6/kvlt.6 b/man/man6/kvlt.6df index 8ca3ea31..bd84e2e1 100644 --- a/man/man6/kvlt.6 +++ b/man/man6/kvlt.6df @@ -1,4 +1,4 @@ -.TH KVLT 6 "June 2016" "Manual page for kvlt" +.TH KVLT 6df "June 2016" "Manual page for kvlt" .SH NAME .B kvlt \- sound like a 14-year-old who just listened to "A Blaze in the Northern Sky" diff --git a/man/man6/rndn.6 b/man/man6/rndn.6df index a3521c16..97fbe30a 100644 --- a/man/man6/rndn.6 +++ b/man/man6/rndn.6df @@ -1,4 +1,4 @@ -.TH RNDN 6 "June 2016" "Manual page for rndn" +.TH RNDN 6df "June 2016" "Manual page for rndn" .SH NAME .B rndn \- esoteric random number generator @@ -15,12 +15,12 @@ uses an advanced but somewhat esoteric algorithm derived by Adams (2001) to return a random number. The seed can be derived internally or specified with the -s option. .P -While rndn(6) has proven robust in the author's production usage, its algorithm +While rndn(6df) has proven robust in the author's production usage, its algorithm has not been formally verified. .SH SEE ALSO <http://dilbert.com/strip/2001-10-25> .br -rndi(1), rnda(1), rndf(1), rndl(1), rnds(1) +rndi(1df), rnda(1df), rndf(1df), rndl(1df), rnds(1df) .SH AUTHORS Tom Ryder <tom@sanctum.geek.nz> .br diff --git a/man/man6/xyzzy.6 b/man/man6/xyzzy.6df index 0e96ccfd..042bb9eb 100644 --- a/man/man6/xyzzy.6 +++ b/man/man6/xyzzy.6df @@ -1,4 +1,4 @@ -.TH XYZZY 6 "August 2016" "Manual page for xyzzy" +.TH XYZZY 6df "August 2016" "Manual page for xyzzy" .SH NAME .B xyzzy \- teleport between directories diff --git a/man/man6/zs.6 b/man/man6/zs.6df index 00080d62..a650cbf7 100644 --- a/man/man6/zs.6 +++ b/man/man6/zs.6df @@ -1,4 +1,4 @@ -.TH ZS 6 "June 2016" "Manual page for zs" +.TH ZS 6df "June 2016" "Manual page for zs" .SH NAME .B zs \- prepend occurences of "s" with "z", case-appropriately diff --git a/man/man7/dotfiles.7df b/man/man7/dotfiles.7df new file mode 100644 index 00000000..cf8e9389 --- /dev/null +++ b/man/man7/dotfiles.7df @@ -0,0 +1,730 @@ +.TH "DOTFILES(7df)" "" "June 2016" "" "" +.SH Dotfiles (Tom Ryder) +.PP +This is my personal repository of configuration files and scripts for +\f[C]$HOME\f[], including most of the settings that migrate well between +machines. +.SS Installation +.IP +.nf +\f[C] +$\ git\ clone\ https://sanctum.geek.nz/code/dotfiles.git\ ~/.dotfiles +$\ cd\ ~/.dotfiles +$\ git\ submodule\ init +$\ git\ submodule\ update +$\ make +$\ make\ \-n\ install +$\ make\ install +\f[] +.fi +.PP +For the default \f[C]all\f[] target, you'll need \f[C]bash(1)\f[], +\f[C]git(1)\f[], \f[C]install(1)\f[], \f[C]make(1)\f[], and +\f[C]m4(1)\f[]. +.PP +The installation \f[C]Makefile\f[] will overwrite things standing in the +way of its installed files without backing them up, so read the output +of \f[C]make\ \-n\ install\f[] before running \f[C]make\ install\f[] to +make sure you aren't going to lose anything unexpected. +If you're still not sure, install it in a temporary directory so you can +explore: +.IP +.nf +\f[C] +$\ tmpdir=$(mktemp\ \-d) +$\ make\ install\ HOME="$tmpdir" +$\ env\ \-i\ HOME="$tmpdir"\ TERM="$TERM"\ bash\ \-l +\f[] +.fi +.PP +The default target will install the core terminal\-only files: cURL, +Git, GnuPG, Vim, shell scripts and functions, and shell and terminal +setup files. +The remaining dotfiles can be installed with the other targets. +Take a look at the \f[C]Makefile\f[] to see what's available. +.SS Tools +.PP +Configuration is included for: +.IP \[bu] 2 +Abook (http://abook.sourceforge.net/) \[en] curses address book program +.IP \[bu] 2 +Bash (https://www.gnu.org/software/bash/) \[en] GNU Bourne\-Again Shell, +including a \f[C]~/.profile\f[] configured to work with most +Bourne\-compatible shells +.IP \[bu] 2 +cURL (https://curl.haxx.se/) \[en] Command\-line tool for transferring +data with URL syntax +.IP \[bu] 2 +Dunst (http://knopwob.org/dunst/) \[en] A lightweight X11 notification +daemon that works with \f[C]libnotify\f[] +.IP \[bu] 2 +\f[C]finger(1)\f[] \[en] User information lookup program +.IP \[bu] 2 +Git (https://git-scm.com/) \[en] Distributed version control system +.IP \[bu] 2 +GnuPG (https://www.gnupg.org/) \[en] GNU Privacy Guard, for private +communication and file encryption +.IP \[bu] 2 +GTK+ (http://www.gtk.org/) \[en] GIMP Toolkit, for graphical user +interface elements +.IP \[bu] 2 +i3 (https://i3wm.org/) \[en] Tiling window manager +.IP \[bu] 2 +less (https://www.gnu.org/software/less/) \[en] Terminal pager +.IP \[bu] 2 +Mutt (http://www.mutt.org/) \[en] Terminal mail user agent +.IP \[bu] 2 +\f[C]mysql(1)\f[] (http://linux.die.net/man/1/mysql) \[en] Command\-line +MySQL client +.IP \[bu] 2 +Ncmpcpp (https://rybczak.net/ncmpcpp/) \[en] ncurses music player client +.IP \[bu] 2 +Newsbeuter (https://www.newsbeuter.org/) \[en] Terminal RSS/Atom feed +reader +.IP \[bu] 2 +\f[C]pdksh(1)\f[] (http://www.cs.mun.ca/~michael/pdksh/) \[en] public +domain fork of the Korn shell +.IP \[bu] 2 +\f[C]psql(1)\f[] (http://linux.die.net/man/1/psql) \[en] Command\-line +PostgreSQL client +.IP \[bu] 2 +Perl::Critic (http://perlcritic.com/) \[en] static source code analysis +engine for Perl +.IP \[bu] 2 +Perl::Tidy (http://perltidy.sourceforge.net/) \[en] Perl indenter and +reformatter +.IP \[bu] 2 +Readline (https://cnswww.cns.cwru.edu/php/chet/readline/rltop.html) +\[en] GNU library for user input used by Bash, MySQL, and others +.IP \[bu] 2 +rxvt\-unicode (http://software.schmorp.de/pkg/rxvt-unicode.html) \[en] +Fork of the rxvt terminal emulator with Unicode support +.IP \[bu] 2 +Subversion (https://subversion.apache.org/) \[en] Apache Subversion, a +version control system +.IP \[bu] 2 +tmux (https://tmux.github.io/) \[en] Terminal multiplexer similar to GNU +Screen +.IP \[bu] 2 +Vim (http://www.vim.org/) \[en] Vi IMproved, a text editor +.IP \[bu] 2 +Wyrd (https://packages.debian.org/sid/wyrd) \[en] a \f[C]curses\f[] +calendar frontend for +Remind (https://www.roaringpenguin.com/products/remind) +.IP \[bu] 2 +X11 (https://www.x.org/wiki/) \[en] Windowing system with network +transparency for Unix +.IP \[bu] 2 +Zsh (https://www.zsh.org/) \[en] Bourne\-style shell designed for +interactive use +.PP +The configurations for Bash, GnuPG, Mutt, tmux, and Vim are the most +expansive and most likely to be of interest. +The i3 configuration is mostly changed to make window switching behave +like Vim windows and tmux panes do, and there's a fair few resources +defined for rxvt\-unicode. +Otherwise, the rest of the configuration isn't too distant from the +defaults. +.SS Shell +.PP +My \f[C]\&.profile\f[] and other files in \f[C]sh\f[] are written in +POSIX shell script, so they should work in most \f[C]sh(1)\f[] +implementations. +Individual scripts called by \f[C]\&.profile\f[] are saved in +\f[C]\&.profile.d\f[] and iterated on login for ease of management. +All of these boil down to exporting variables appropriate to the system +and the software it has available. +.PP +I make an effort to target POSIX for my functions and scripts where I +can, but Bash is my interactive shell of choice. +.PP +My \f[C]\&.bash_profile\f[] calls \f[C]\&.profile\f[], and then +\f[C]\&.bashrc\f[], which only applies for interactive shells. +Subscripts for \f[C]\&.bashrc\f[] are loaded from \f[C]\&.bashrc.d\f[]. +The contents of the \f[C]*.d\f[] directories changes depending on the +host, so only specific scripts in it are versioned. +.PP +As I occasionally have work on very old internal systems, my Bash is +written to work with any version 2.05a or +newer (http://wiki.bash-hackers.org/scripting/bashchanges). +This is why I use older syntax for certain things such as appending +items to arrays: +.IP +.nf +\f[C] +array[${#array[\@]}]=$item +\f[] +.fi +.PP +Compare this to the much nicer syntax available since 3.1\-alpha1, which +actually works for arrays with sparse indexes, unlike the above syntax: +.IP +.nf +\f[C] +array+=("$item") +\f[] +.fi +.PP +Where I do use features that are only available in versions of Bash +newer than 2.05a, such as newer \f[C]shopt\f[] options or +\f[C]PROMPT_DIRTRIM\f[], they are only run after testing +\f[C]BASH_VERSINFO\f[] appropriately. +.SS Prompt +.PP +When I use any other Bourne\-compatible shell, I'm generally happy to +accept its defaults for interactive behavior. +.PP +A terminal session with my prompt looks something like this: +.IP +.nf +\f[C] +~$\ ssh\ remote +tom\@remote:~$\ cd\ .dotfiles +tom\@remote:~/.dotfiles(master+!)$\ git\ status +\ M\ README.markdown +M\ \ bash/bashrc.d/prompt.bash +A\ \ init +tom\@remote:~/.dotfiles(master+!)$\ foobar +foobar:\ command\ not\ found +tom\@remote:~/.dotfiles(master+!)<127>$\ sleep\ 5\ & +[1]\ 28937 +tom\@remote:~/.dotfiles(master+!){1}$ +\f[] +.fi +.PP +The username and hostname are skipped if not connected via SSH. +The right side of the prompt expands based on context to include these +elements in this order: +.IP \[bu] 2 +Whether in a Git repository if applicable, and punctuation to show +repository status including reference to upstreams at a glance. +Subversion support can also be enabled (I need it at work), in which +case a \f[C]git:\f[] or \f[C]svn:\f[] prefix is added appropriately +.IP \[bu] 2 +The number of running background jobs, if non\-zero +.IP \[bu] 2 +The exit status of the last command, if non\-zero +.PP +You can set \f[C]PROMPT_COLOR\f[], \f[C]PROMPT_PREFIX\f[], and +\f[C]PROMPT_SUFFIX\f[] too, which all do about what you'd expect. +.PP +This is all managed within the \f[C]prompt\f[] function. +There's some mildly hacky logic on \f[C]tput\f[] codes included such +that it should work correctly for most common terminals using both +\f[C]termcap(5)\f[] and \f[C]terminfo(5)\f[], including *BSD systems. +It's also designed to degrade gracefully for eight\-color and no\-color +terminals. +.SS Functions +.PP +If a function can be written in POSIX \f[C]sh\f[] without too much +hackery, I put it in \f[C]sh/shrc.d\f[] to be loaded by any POSIX +interactive shell. +Those include: +.IP \[bu] 2 +\f[C]bc()\f[] silences startup messages from GNU \f[C]bc(1)\f[]. +.IP \[bu] 2 +\f[C]bd()\f[] changes into a named ancestor of the current directory. +.IP \[bu] 2 +\f[C]diff()\f[] forces the unified format for \f[C]diff(1)\f[]. +.IP \[bu] 2 +\f[C]ed()\f[] tries to get verbose error messages, a prompt, and a +Readline environment for \f[C]ed(1)\f[]. +.IP \[bu] 2 +\f[C]env()\f[] sorts the output of \f[C]env(1)\f[] if it was invoked +with no arguments, because the various shells have different ways of +listing exported variables. +.IP \[bu] 2 +\f[C]gdb()\f[] silences startup messages from \f[C]gdb(1)\f[]. +.IP \[bu] 2 +\f[C]gpg()\f[] quietens \f[C]gpg(1)\f[] down for most commands. +.IP \[bu] 2 +\f[C]grep()\f[] tries to apply color and other options good for +interactive use, depending on the capabilities of the system +\f[C]grep(1)\f[]. +.IP \[bu] 2 +\f[C]hgrep()\f[] allows searching \f[C]$HISTFILE\f[]. +.IP \[bu] 2 +\f[C]keychain()\f[] keeps \f[C]$GPG_TTY\f[] up to date if a GnuPG agent +is available. +.IP \[bu] 2 +\f[C]lhn()\f[] gets the history number of the last command, if the POSIX +\f[C]fc\f[] builtin is available. +.IP \[bu] 2 +\f[C]ls()\f[] tries to apply color to \f[C]ls(1)\f[] for interactive use +if available. +.RS 2 +.IP \[bu] 2 +\f[C]la()\f[] runs \f[C]ls\ \-A\f[] if it can, or \f[C]ls\ \-a\f[] +otherwise. +.IP \[bu] 2 +\f[C]ll()\f[] runs \f[C]ls\ \-Al\f[] if it can, or \f[C]ls\ \-al\f[] +otherwise. +through your pager, using color if it can. +.RE +.IP \[bu] 2 +\f[C]mkcd()\f[] creates a directory and changes into it. +.IP \[bu] 2 +\f[C]mysql()\f[] allows shortcuts to MySQL configuration files stored in +\f[C]~/.mysql\f[]. +.IP \[bu] 2 +\f[C]path()\f[] manages the contents of \f[C]PATH\f[] conveniently. +.IP \[bu] 2 +\f[C]pd()\f[] changes to the argument's parent directory. +.IP \[bu] 2 +\f[C]pwgen()\f[] generates just one decent password with +\f[C]pwgen(1)\f[]. +.IP \[bu] 2 +\f[C]rcsdiff()\f[] forces a unified format for \f[C]rcsdiff(1)\f[]. +.IP \[bu] 2 +\f[C]rd()\f[] replaces the first instance of its first argument with its +second argument in \f[C]$PWD\f[], emulating a feature of the Zsh +\f[C]cd\f[] builtin that I like. +.IP \[bu] 2 +\f[C]scp()\f[] tries to detect forgotten hostnames in \f[C]scp(1)\f[] +command calls. +.IP \[bu] 2 +\f[C]scr()\f[] creates a temporary directory and changes into it. +.IP \[bu] 2 +\f[C]sd()\f[] changes into a sibling of the current directory. +.IP \[bu] 2 +\f[C]sudo()\f[] forces \f[C]\-H\f[] for \f[C]sudo(8)\f[] calls so that +\f[C]$HOME\f[] is never preserved; I hate having \f[C]root\f[]\-owned +files in my home directory. +.IP \[bu] 2 +\f[C]tmux()\f[] changes the default command for \f[C]tmux(1)\f[] to +\f[C]attach\-session\ \-d\f[] if a session exists, or creates a new +session if one doesn't. +.IP \[bu] 2 +\f[C]ud()\f[] changes into an indexed ancestor of a directory. +.IP \[bu] 2 +\f[C]vim()\f[] defines three functions to always use \f[C]vim(1)\f[] as +my \f[C]ex(1)\f[], \f[C]vi(1)\f[] and \f[C]view(1)\f[] implementation if +it's available. +.IP \[bu] 2 +\f[C]vr()\f[] tries to change to the root directory of a source control +repository. +.PP +There are a few other little tricks defined for other shells, mostly in +\f[C]bash/bashrc.d\f[]: +.IP \[bu] 2 +\f[C]keep()\f[] stores ad\-hoc shell functions and variables. +.IP \[bu] 2 +\f[C]prompt()\f[] sets up my interactive prompt. +.IP \[bu] 2 +\f[C]pushd()\f[] adds a default destination of \f[C]$HOME\f[] to the +\f[C]pushd\f[] builtin. +.IP \[bu] 2 +\f[C]vared()\f[] allows interactively editing a variable with Readline, +emulating a Zsh function I like by the same name. +.SS Completion +.PP +I find the \f[C]bash\-completion\f[] package a bit too heavy for my +tastes, and turn it off using a stub file installed in +\f[C]\&.config/bash_completion\f[]. +The majority of the time I just want to complete paths anyway, and this +makes for a quicker startup without a lot of junk functions in my Bash +namespace. +.PP +I do make some exceptions with completions defined in +\f[C]\&.bash_completion.d\f[] files for things I really do get tired of +typing repeatedly: +.IP \[bu] 2 +Builtins, commands, help topics, shell options, and variables +.IP \[bu] 2 +\f[C]ftp(1)\f[] hostnames from \f[C]~/.netrc\f[] +.IP \[bu] 2 +\f[C]git(1)\f[] branch names +.IP \[bu] 2 +\f[C]gpg(1)\f[] long options +.IP \[bu] 2 +\f[C]make(1)\f[] targets read from a \f[C]Makefile\f[] +.IP \[bu] 2 +\f[C]man(1)\f[] page titles +.IP \[bu] 2 +\f[C]mysql(1)\f[] databases from \f[C]~/.mysql/*.cnf\f[] +.IP \[bu] 2 +\f[C]pass(1)\f[] entries +.IP \[bu] 2 +\f[C]ssh(1)\f[] hostnames from \f[C]~/.ssh/config\f[] +.PP +I also add completions for my own scripts and functions where useful. +The completions are dynamically loaded if Bash is version 4.0 or +greater. +Otherwise, they're all loaded on startup. +.SS pdksh +.PP +The pdksh configuration files and functions are not nearly as featureful +as the Bash ones. +They're tested on OpenBSD and FreeBSD pdksh implementations, but the +former is the primary system for which I'm maintaining them, and there +are some feature differences. +.SS Zsh +.PP +These are experimental; I do not like Zsh much at the moment. +The files started as a joke (\f[C]exec\ bash\f[]). +.SS GnuPG +.PP +The configuration for GnuPG is intended to follow RiseUp's OpenPGP best +practices (https://riseup.net/en/security/message-security/openpgp/best-practices). +The configuration file is rebuilt using \f[C]m4(1)\f[] and +\f[C]make(1)\f[] because it requires hard\-coding a path to the SKS +keyserver certificate authority, and neither tilde nor \f[C]$HOME\f[] +expansion works for this. +.SS Mutt +.PP +My mail is kept in individual Maildirs under \f[C]~/Mail\f[], with +\f[C]inbox\f[] being where most unfiltered mail is sent. +I use Getmail (http://pyropus.ca/software/getmail/), +maildrop (http://www.courier-mta.org/maildrop/), and +MSMTP (http://msmtp.sourceforge.net/); the configurations for these are +not included here. +I sign whenever I have some indication that the recipient might be using +a PGP implementation, and I encrypt whenever I have a public key +available for them. +The GnuPG interfacing is done with +GPGme (https://www.gnupg.org/related_software/gpgme/), rather than +defining commands for each crypto operation. +I wrote an article about this +setup (https://sanctum.geek.nz/arabesque/linux-crypto-email/) if it +sounds appealing. +.PP +You'll need Abook (http://abook.sourceforge.net/) installed if you want +to use the \f[C]query_command\f[] I have defined, and +msmtp (http://msmtp.sourceforge.net/) for the \f[C]sendmail\f[] command. +.SS rxvt\-unicode +.PP +I've butchered the URxvt Perl extensions +\f[C]selection\-to\-clipboard\f[] and \f[C]selection\f[] into a single +\f[C]select\f[] extension in \f[C]~/.urxvt/ext\f[], which is the only +extension I define in \f[C]~/.Xresources\f[]. +.PP +The included \f[C]\&.Xresources\f[] file assumes that \f[C]urxvt\f[] can +use 256 colors and Perl extensions. +If you're missing functionality, try changing \f[C]perl\-ext\-common\f[] +to \f[C]default\f[]. +.PP +My choice of font is Ubuntu Mono (http://font.ubuntu.com/), but the file +should allow falling back to the more common Deja Vu Sans +Mono (http://dejavu-fonts.org/wiki/Main_Page). +I've found Terminus (http://terminus-font.sourceforge.net/) works well +too, but bitmap fonts are not really my cup of tea. +The Lohit Kannada font bit is purely to make ಠ_ಠ work correctly. +( ͡° ͜ʖ ͡°) seems to work out of the box. +.SS tmux +.PP +These are just generally vi\-friendly settings, not much out of the +ordinary. +Note that the configuration presently uses a hard\-coded 256\-color +colorscheme, and uses non\-login shells, with an attempt to control the +environment to stop shells thinking they have access to an X display. +.PP +The configuration file is created with \f[C]m4(1)\f[] to allow +specifying a color theme. +This is just because I use a different color for my work session. +The default is a dark grey. +.PP +The configuration for Bash includes a \f[C]tmux\f[] function designed to +make \f[C]attach\f[] into the default command if no arguments are given +and sessions do already exist. +The default command is normally \f[C]new\-session\f[]. +.SS Vim +.PP +The majority of the \f[C]\&.vimrc\f[] file is just setting options, with +a few mappings. +I try not to deviate too much from the Vim defaults behaviour in terms +of interactive behavior and keybindings. +.PP +The configuration is extensively commented, mostly because I was reading +through it one day and realised I'd forgotten what half of it did. +Plugins are loaded using \@tpope's +pathogen.vim (https://github.com/tpope/vim-pathogen). +.SS Scripts +.PP +Where practical, I make short scripts into POSIX (but not Bourne) +\f[C]sh(1)\f[], \f[C]awk(1)\f[], or \f[C]sed(1)\f[] scripts in +\f[C]~/.local/bin\f[]. +A few of them still have Bashisms for various reasons. +I try to use shell functions only when I actually need to, which tends +to be when I need to tinker with the namespace of the user's current +shell. +.PP +Installed by the \f[C]install\-bin\f[] target: +.IP \[bu] 2 +Three SSH\-related scripts: +.RS 2 +.IP \[bu] 2 +\f[C]sls(1df)\f[] prints hostnames read from a \f[C]ssh_config(5)\f[] +file. +It uses \f[C]slsf(1df)\f[] to read each one. +.IP \[bu] 2 +\f[C]sra(1df)\f[] runs a command on multiple hosts read from +\f[C]sls(1df)\f[] and prints output. +.IP \[bu] 2 +\f[C]sta(1df)\f[] runs a command on multiple hosts read from +\f[C]sls(1df)\f[] and prints the hostname if the command returns zero. +.RE +.IP \[bu] 2 +Five URL\-related shortcut scripts: +.RS 2 +.IP \[bu] 2 +\f[C]hurl(1df)\f[] extracts values of \f[C]href\f[] attributes of +\f[C]<a>\f[] tags, sorts them uniquely, and writes them to +\f[C]stdout\f[]; it requires pup (https://github.com/ericchiang/pup). +.IP \[bu] 2 +\f[C]murl(1df)\f[] converts Markdown documents to HTML with +\f[C]pandoc(1)\f[] and runs the output through \f[C]hurl(1df)\f[]. +.IP \[bu] 2 +\f[C]urlc(1df)\f[] accepts a list of URLs on \f[C]stdin\f[] and writes +error messages to \f[C]stderr\f[] if any of the URLs are broken, +redirecting, or are insecure and have working secure versions; requires +\f[C]curl(1)\f[]. +.IP \[bu] 2 +\f[C]urlh(1df)\f[] prints the values for a given HTTP header from a HEAD +response. +.IP \[bu] 2 +\f[C]urlmt(1df)\f[] prints the MIME type from the \f[C]Content\-Type\f[] +header as retrieved by \f[C]urlh(1df)\f[]. +.RE +.IP \[bu] 2 +Three RFC\-related shortcut scripts: +.RS 2 +.IP \[bu] 2 +\f[C]rfcf(1df)\f[] fetches ASCII RFCs from the IETF website. +.IP \[bu] 2 +\f[C]rfct(1df)\f[] formats ASCII RFCs. +.IP \[bu] 2 +\f[C]rfcr(1df)\f[] does both, displaying in a pager if appropriate, like +a \f[C]man(1)\f[] reader for RFCs. +.RE +.IP \[bu] 2 +Five toy random\-number scripts (not for sensitive/dead\-serious use): +.RS 2 +.IP \[bu] 2 +\f[C]rndi(1df)\f[] gets a random integer within two bounds. +.IP \[bu] 2 +\f[C]rnds(1df)\f[] attempts to get an optional random seed for +\f[C]rndi(1df)\f[]. +.IP \[bu] 2 +\f[C]rnda(1df)\f[] uses \f[C]rndi(1df)\f[] to choose a random argument. +.IP \[bu] 2 +\f[C]rndf(1df)\f[] uses \f[C]rnda(1df)\f[] to choose a random file from +a directory. +.IP \[bu] 2 +\f[C]rndl(1df)\f[] uses \f[C]rndi(1df)\f[] to choose a random line from +files. +.RE +.IP \[bu] 2 +Four file formatting scripts: +.RS 2 +.IP \[bu] 2 +\f[C]d2u(1df)\f[] converts DOS line endings in files to UNIX ones. +.IP \[bu] 2 +\f[C]u2d(1df)\f[] converts UNIX line endings in files to DOS ones. +.IP \[bu] 2 +\f[C]stbl(1df)\f[] strips a trailing blank line from the files in its +arguments. +.IP \[bu] 2 +\f[C]stws(1df)\f[] strips trailing spaces from the ends of lines of the +files in its arguments. +.RE +.IP \[bu] 2 +Five stream formatting scripts: +.RS 2 +.IP \[bu] 2 +\f[C]sd2u(1df)\f[] converts DOS line endings in streams to UNIX ones. +.IP \[bu] 2 +\f[C]su2d(1df)\f[] converts UNIX line endings in streams to DOS ones. +.IP \[bu] 2 +\f[C]tl(1df)\f[] tags input lines with a prefix or suffix, basically a +\f[C]sed(1)\f[] shortcut. +.IP \[bu] 2 +\f[C]tlcs(1df)\f[] executes a command and uses \f[C]tl(1df)\f[] to tag +stdout and stderr lines, and color them if you want. +.IP \[bu] 2 +\f[C]unf(1df)\f[] joins lines with leading spaces to the previous line. +Intended for unfolding HTTP headers, but it should work for most RFC 822 +formats. +.RE +.IP \[bu] 2 +\f[C]apf(1df)\f[] prepends arguments to a command with ones read from a +file, intended as a framework for shell wrappers or functions. +.IP \[bu] 2 +\f[C]ax(1df)\f[] evaluates an awk expression given on the command line; +this is intended as a quick way to test how Awk would interpret a given +expression. +.IP \[bu] 2 +\f[C]bel(1df)\f[] prints a terminal bell character. +.IP \[bu] 2 +\f[C]br(1df)\f[] launches \f[C]$BROWSER\f[], or a more suitable +application for an URL if it knows of one. +.IP \[bu] 2 +\f[C]ca(1df)\f[] prints a count of its given arguments. +.IP \[bu] 2 +\f[C]cf(1df)\f[] prints a count of entries in a given directory. +.IP \[bu] 2 +\f[C]clrd(1df)\f[] sets up a per\-line file read, clearing the screen +first. +.IP \[bu] 2 +\f[C]clwr(1df)\f[] sets up a per\-line file write, clearing the screen +before each line +.IP \[bu] 2 +\f[C]dmp(1df)\f[] copies a pass(1) entry selected by \f[C]dmenu(1)\f[] +to the X CLIPBOARD. +.IP \[bu] 2 +\f[C]dub(1df)\f[] lists the biggest entries in a directory. +.IP \[bu] 2 +\f[C]edda(1df)\f[] provides a means to run \f[C]ed(1)\f[] over a set of +files preserving any options, mostly useful for scripts. +.IP \[bu] 2 +\f[C]eds(1df)\f[] edits executable script files in \f[C]EDSPATH\f[], +defaulting to \f[C]~/.local/bin\f[], for personal scripting snippets. +.IP \[bu] 2 +\f[C]fgscr(1df)\f[] finds Git repositories in a directory root and +scrubs them with \f[C]gscr(1df)\f[]. +.IP \[bu] 2 +\f[C]fnl(1df)\f[] runs a command and saves its output and error into +temporary files, printing their paths and line counts +.IP \[bu] 2 +\f[C]gms(1df)\f[] runs a set of \f[C]getmailrc\f[] files; does much the +same thing as the script \f[C]getmails\f[] in the \f[C]getmail\f[] +suite, but runs the requests in parallel and does up to three silent +retries using \f[C]try(1df)\f[]. +.IP \[bu] 2 +\f[C]grc(1df)\f[] quietly tests whether the given directory appears to +be a Git repository with pending changes. +.IP \[bu] 2 +\f[C]gscr(1df)\f[] scrubs Git repositories. +.IP \[bu] 2 +\f[C]han(1df)\f[] provides a \f[C]keywordprg\f[] for Vim's Bash script +filetype that will look for \f[C]help\f[] topics. +You could use it from the shell too. +.IP \[bu] 2 +\f[C]igex(1df)\f[] wraps around a command to allow you to ignore error +conditions that don't actually worry you, exiting with 0 anyway. +.IP \[bu] 2 +\f[C]isgr(1df)\f[] quietly tests whether the given directory appears to +be a Git repository. +.IP \[bu] 2 +\f[C]jfc(1df)\f[] adds and commits lazily to a Git repository. +.IP \[bu] 2 +\f[C]jfcd(1df)\f[] watches a directory for changes and runs +\f[C]jfc(1df)\f[] if it sees any. +.IP \[bu] 2 +\f[C]maybe(1df)\f[] is like \f[C]true(1)\f[] or \f[C]false(1)\f[]; given +a probability of success, it exits with success or failure. +Good for quick tests. +.IP \[bu] 2 +\f[C]mkcp(1df)\f[] creates a directory and copies preceding arguments +into it. +.IP \[bu] 2 +\f[C]mkmv(1df)\f[] creates a directory and moves preceding arguments +into it. +.IP \[bu] 2 +\f[C]motd(1df)\f[] shows the system MOTD. +.IP \[bu] 2 +\f[C]pa(1df)\f[] prints its arguments, one per line. +.IP \[bu] 2 +\f[C]paz(1df)\f[] print its arguments terminated by NULL chars. +.IP \[bu] 2 +\f[C]pit(1df)\f[] runs its input through a pager if its standard output +looks like a terminal. +.IP \[bu] 2 +\f[C]plmu(1df)\f[] retrieves a list of installed modules from +\f[C]plenv\f[] (https://github.com/tokuhirom/plenv), filters out any +modules in \f[C]~/.plenv/non\-cpan\-modules\f[], and updates them all. +.IP \[bu] 2 +\f[C]rmrej(1df)\f[] deletes rejected hunks from a failed +\f[C]patch(1)\f[] run. +.IP \[bu] 2 +\f[C]shb(1df)\f[] attempts to build shebang lines for scripts from +\f[C]$PATH\f[]. +.IP \[bu] 2 +\f[C]spr(1df)\f[] posts its input to the sprunge.us pastebin. +.IP \[bu] 2 +\f[C]sshi(1df)\f[] prints human\-readable SSH connection details. +.IP \[bu] 2 +\f[C]stex(1df)\f[] strips extensions from filenames. +.IP \[bu] 2 +\f[C]sue(8df)\f[] execs \f[C]sudoedit(8)\f[] as the owner of all the +file arguments given, perhaps in cases where you may not necessarily +have \f[C]root\f[] \f[C]sudo(8)\f[] privileges. +.IP \[bu] 2 +\f[C]td(1df)\f[] manages a to\-do file for you with \f[C]$EDITOR\f[] and +\f[C]git(1)\f[]; I used to use Taskwarrior, but found it too complex and +buggy. +.IP \[bu] 2 +\f[C]try(1df)\f[] repeats a command up to a given number of times until +it succeeds, only printing error output if all three attempts failed. +Good for tolerating blips or temporary failures in \f[C]cron(8)\f[] +scripts. +.PP +There's some silly stuff in \f[C]install\-games\f[]: +.IP \[bu] 2 +\f[C]aaf(6df)\f[] gets a random ASCII Art +Farts (http://www.asciiartfarts.com/) comic. +.IP \[bu] 2 +\f[C]acq(6df)\f[] allows you to interrogate AC, the interplanetary +computer. +.IP \[bu] 2 +\f[C]kvlt(6df)\f[] translates input to emulate a style of typing unique +to black metal communities on the internet. +.IP \[bu] 2 +\f[C]rndn(6df)\f[] implements an esoteric random number generation +algorithm. +.IP \[bu] 2 +\f[C]xyzzy(6df)\f[] teleports to a marked location on the filesystem. +.IP \[bu] 2 +\f[C]zs(6df)\f[] prepends \[lq]z\[rq] case\-appropriately to every +occurrence of \[lq]s\[rq] in the text on its standard input. +.SS Manuals +.PP +The \f[C]install\-bin\f[] and \f[C]install\-games\f[] targets install +manuals for each script they install. +There's also an \f[C]install\-dotfiles\-man\f[] target that uses +\f[C]pandoc(1)\f[] to reformat this document as a manual page for +section 7 (\f[C]dotfiles(7)\f[]) if you want that. +I haven't made that install by default, because \f[C]pandoc(1)\f[] is a +bit heavy. +.PP +If you want to use the manuals, you may need to add +\f[C]~/.local/share/man\f[] to your \f[C]/etc/manpath\f[] configuration, +depending on your system. +.SS Testing +.PP +You can check that both sets of shell scripts are syntactically correct +with \f[C]make\ check\-bash\f[], \f[C]make\ check\-sh\f[], or +\f[C]make\ check\f[] for everything including the scripts in +\f[C]bin\f[] and \f[C]games\f[]. +There's no proper test suite for the actual functionality (yet). +.PP +If you have ShellCheck (https://www.shellcheck.net/) and/or +Perl::Critic (http://perlcritic.com/), there's a \f[C]lint\f[] target +for the shell script files and Perl files respectively. +The files don't need to pass that check to be installed. +.SS Known issues +.PP +See ISSUES.markdown. +.SS Note for previous visitors +.PP +Most of this repository's five\-year history was rewritten shortly after +I moved it from GitHub to cgit, taking advantage of the upheaval to +reduce its size and remove useless binary blobs and third\-party stuff +that I never should have versioned anyway. +If you've checked this out before, you'll probably need to do it again, +and per\-commit links are likely to be broken. +Sorry about that. +.SS License +.PP +Public domain; see the included \f[C]UNLICENSE\f[] file. +It's just configuration and simple scripts, so do whatever you like with +it if any of it's useful to you. +If you're feeling generous, please join and/or donate to a free software +advocacy group, and let me know you did it because of this project: +.IP \[bu] 2 +Free Software Foundation (https://www.fsf.org/) +.IP \[bu] 2 +Software in the Public Interest (http://www.spi-inc.org/) +.IP \[bu] 2 +OpenBSD Foundation (http://www.openbsdfoundation.org/) +.SH AUTHORS +Tom Ryder. diff --git a/man/man7/dotfiles.7.header b/man/man7/dotfiles.7df.header index b059b0fd..70cb6c2e 100644 --- a/man/man7/dotfiles.7.header +++ b/man/man7/dotfiles.7df.header @@ -1,3 +1,3 @@ -% DOTFILES(7) +% DOTFILES(7df) % Tom Ryder % June 2016 diff --git a/man/man8/sue.8 b/man/man8/sue.8df index a7701d23..f9633f51 100644 --- a/man/man8/sue.8 +++ b/man/man8/sue.8df @@ -1,4 +1,4 @@ -.TH SUE 8 "September 2015" "Manual page for sue" +.TH SUE 8df "September 2015" "Manual page for sue" .SH NAME .B sue \- run sudoedit(8) as the arguments' owner |