about summary refs log tree commit diff stats
path: root/README.md
blob: f6f03d8b5f81d8ca148ea6a48a6b40d3e2f153bd (plain)
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
# shin
## include shell files

built to scratch a personal itch.  SHIN is an awk(1) script that plops include
files in to .shin files.

recently rewritten.  now use it like this:

```sh
#!/bin/sh

. shin # if shin is in $PATH this should Just Work(TM)

do_stuff_here

shin included_file

other_stuff
```

you can run the above script itself, or you can "compile" it by running `shin -c <script>`, which will insert `included_file` in the correct spot in the file and remove the `. shin` line (only if it's by itself, which really it should be).

## build a shell file

use the program `shinb` to build a shell file on the command line.  You don't need to include `-c` in the command line when calling `shinb`.