aboutsummaryrefslogtreecommitdiff
path: root/man/man1
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2015-10-01 16:38:17 +1300
committerTom Ryder <tom@sanctum.geek.nz>2015-10-01 16:38:17 +1300
commit0d17ce7135284dde08558febb620e03d3e01923a (patch)
tree3fe311f51e6f83056a1ad741c0ebd7bb090917ad /man/man1
parentUpdate tmux status bar every second (diff)
downloaddotfiles-0d17ce7135284dde08558febb620e03d3e01923a.tar.gz
dotfiles-0d17ce7135284dde08558febb620e03d3e01923a.zip
Move man pages into man1 subdir
Going to make a man8 page shortly
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/edda.130
-rw-r--r--man/man1/han.118
-rw-r--r--man/man1/scatter.116
-rw-r--r--man/man1/shoal.118
-rw-r--r--man/man1/shock.117
5 files changed, 99 insertions, 0 deletions
diff --git a/man/man1/edda.1 b/man/man1/edda.1
new file mode 100644
index 00000000..2a7ef501
--- /dev/null
+++ b/man/man1/edda.1
@@ -0,0 +1,30 @@
+.TH EDDA 1 "June 2015" "Manual page for edda"
+.SH NAME
+.B edda
+\- run ed(1) over multiple files
+.SH SYNOPSIS
+.B edda [OPTS] [--] FILE1 [FILE2...]
+.SH DESCRIPTION
+Duplicate any data on stdin into a temporary file, and run ed(1) with any given
+options over each of the files given as the remaining arguments. Example:
+.P
+ $ edda -s /etc/app.d/*.conf <<EOF
+ ,s/foo/bar/g
+ w
+ EOF
+.SH WISDOM
+"Each man who is wise and would wise be called,
+.br
+ Must ask and answer aright.
+.br
+ Let one know thy secret, but never a second;
+.br
+ If three, a thousand shall know."
+.P
+ -- Poetic Edda, Hávamál, 63
+.br
+.SH SEE ALSO
+ed(1)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+
diff --git a/man/man1/han.1 b/man/man1/han.1
new file mode 100644
index 00000000..8bb65be4
--- /dev/null
+++ b/man/man1/han.1
@@ -0,0 +1,18 @@
+.TH HAN 1 "May 2015" "Manual page for han"
+.SH NAME
+.B han
+\- try running builtin help, then man(1)
+.SH SYNOPSIS
+.B han
+.I (HELPTOPIC | MANARGS...)
+.SH DESCRIPTION
+If called with a single argument, try running the help builtin for the given
+keyword, writing its output to a file. If it succeeds, show that. If not, pass
+the call to man(1).
+.P
+This was written so it could be used as a 'keywordprg' in Vim for Bash files;
+you can then use the K normal-mode binding over both shell builtins (e.g. read,
+set, export) and external programs (e.g. cat(1), grep(1), ed(1)).
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+
diff --git a/man/man1/scatter.1 b/man/man1/scatter.1
new file mode 100644
index 00000000..95addd23
--- /dev/null
+++ b/man/man1/scatter.1
@@ -0,0 +1,16 @@
+.TH SCATTER 1 "May 2014" "Manual page for scatter"
+.SH NAME
+.B scatter
+\- run a command on shoal(1) hosts
+.SH SYNOPSIS
+.B scatter
+.I COMMAND
+.SH DESCRIPTION
+.B scatter
+runs a nominated command on all the hosts returned by shoal(1), and prints the
+hostname, stdout, and stderr for each call.
+.SH SEE ALSO
+shock(1), shoal(1)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+
diff --git a/man/man1/shoal.1 b/man/man1/shoal.1
new file mode 100644
index 00000000..2399f974
--- /dev/null
+++ b/man/man1/shoal.1
@@ -0,0 +1,18 @@
+.TH SHOAL 1 "May 2014" "Manual page for shoal"
+.SH NAME
+.B shoal
+\- list the first hostname on each line of an ssh_config(5) file
+.SH SYNOPSIS
+.B shoal
+.I [SSH_CONFIG]
+.SH DESCRIPTION
+.B shoal
+reads an ssh_config(5) file, defaulting to ~/.ssh/config, and returns a
+newline-delimited list of the first of the hostnames on each Host line in the
+file, ignoring all other lines. Suitable for use in batch scripts like
+scatter(1).
+.SH SEE ALSO
+scatter(1), shock(1), ssh(1), ssh_config(5)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+
diff --git a/man/man1/shock.1 b/man/man1/shock.1
new file mode 100644
index 00000000..0b64d504
--- /dev/null
+++ b/man/man1/shock.1
@@ -0,0 +1,17 @@
+.TH SHOCK 1 "May 2014" "Manual page for shock"
+.SH NAME
+.B shock
+\- run a command on shoal(1) hosts and print the hostname if successful
+.SH SYNOPSIS
+.B shock
+.I COMMAND
+.SH DESCRIPTION
+.B shock
+runs a nominated command on all the hosts returned by shoal(1), and prints the
+hostname if the command has an exit value of 0. The stdout from the commands is
+discarded.
+.SH SEE ALSO
+scatter(1), shoal(1)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+