60 lines
2.1 KiB
Plaintext
60 lines
2.1 KiB
Plaintext
--- Bake ---
|
|
|
|
Bake scripts into files.
|
|
|
|
Executes @BAKE to the end of the line or @STOP within in any given file.
|
|
|
|
You may have multi-line commands, by either including a leading @STOP
|
|
or ending each line with a backslash.
|
|
|
|
The execution takes place at the root of the target file, so if you have:
|
|
`test/file.c', and then execution takes place at `test'.
|
|
|
|
you may see a real example in the primary and only source file: `bake.c'.
|
|
this is not targeted toward any language and should be fairly flexible,
|
|
especially when multi-line comments are available.
|
|
|
|
Binary files (files that contain characters < ' ' or > '~') are supported.
|
|
|
|
A manpage is included: bake(1)
|
|
|
|
--- Building ---
|
|
|
|
Bootstrapping may be done with Shake, simply run `./shake ./bake.c'
|
|
|
|
Or simply run `install.sh', you'll need to be a privileged user to install the files.
|
|
See the file's content for more details regarding the installation.
|
|
|
|
--- I/O Extension ---
|
|
|
|
I/O provides various descriptive factors about the current context for the command,
|
|
primarily the full and shortened filename, and the remaining arguments to the process.
|
|
|
|
$@: the name of the executed file
|
|
$*: the text of the filename before the last dot
|
|
$+: the remaining arguments to Bake
|
|
|
|
They are most useful for a template command, such as: @BAKE cc $@ -o $* $+
|
|
|
|
--- Options ---
|
|
|
|
only one option may be in use at a time, and must come as the first argument.
|
|
|
|
-h, --help: displays help message, similarly to empty input.
|
|
-n, --dry-run: DRYRUN, does NOT run anything!
|
|
|
|
--- Shake ---
|
|
|
|
Bake was inspired by the Bash-based Shake utility (formerly eMake,
|
|
he liked my suggestion for a name). It is included under authorization
|
|
of it's creator. The original version of Shake may be found at:
|
|
<http://bis64wqhh3louusbd45iyj76kmn4rzw5ysawyan5bkxwyzihj67c5lid.onion/anon/shake>
|
|
|
|
Bake includes a modified Shake, both in installation, and as a bootstrapper.
|
|
The modified version includes all features of Bake with the exceptions of
|
|
multi-line commands. It is not a replacement for Bake.
|
|
|
|
Bake is licensed under the GPLv3-only, See LICENSE.
|
|
|
|
Bake began on September 13th, 2023, and at this point in time, is complete.
|