aboutsummaryrefslogtreecommitdiff
path: root/man/man1
diff options
context:
space:
mode:
authorTom Ryder <tom@sanctum.geek.nz>2016-08-02 19:23:52 +1200
committerTom Ryder <tom@sanctum.geek.nz>2016-08-02 19:24:20 +1200
commit02673c20da7ffe3d0a4aded934ae479ae5280781 (patch)
tree8958da26a40ca735a6f090161bb6b8f82303f969 /man/man1
parentsls(1) bail if no defaults and no arguments (diff)
downloaddotfiles-02673c20da7ffe3d0a4aded934ae479ae5280781.tar.gz
dotfiles-02673c20da7ffe3d0a4aded934ae479ae5280781.zip
Add shb(1)
Diffstat (limited to 'man/man1')
-rw-r--r--man/man1/shb.126
1 files changed, 26 insertions, 0 deletions
diff --git a/man/man1/shb.1 b/man/man1/shb.1
new file mode 100644
index 00000000..64c7e0f9
--- /dev/null
+++ b/man/man1/shb.1
@@ -0,0 +1,26 @@
+.TH SHB 1 "August 2016" "Manual page for shb"
+.SH NAME
+.B shb
+\- insert a shebang line above a file
+.SH SYNOPSIS
+.B shb
+script bash
+.br
+.B shb
+script sed -f
+.br
+command |
+.B shb
+- awk -f
+.SH DESCRIPTION
+.B shb
+uses PATH to find a suitable program with the name given in the second
+argument, forms a "shebang" line from it and any arguments beyond the second,
+and then emits the contents of the first argument ('-' can be used for stdin).
+.P
+This is intended as a minimal way to make portable shebang lines for Makefiles
+or other building or installation frameworks, handling subtleties like sed(1)
+being located in /bin on Linux, but /usr/bin on BSD. It should work with any
+POSIX-compliant sh(1).
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>