72 lines
2.6 KiB
Plaintext
72 lines
2.6 KiB
Plaintext
--- Bake ---
|
|
|
|
Bake scripts into files.
|
|
|
|
Executes @BAKE to the end of the line or until @STOP within in any given file.
|
|
|
|
You may have multi-line commands, by either including a leading @STOP or by
|
|
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' and the file is
|
|
simply regarded as `file.c'.
|
|
|
|
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. You should always
|
|
consider your usecase before using a tool like this. Bake is not an
|
|
all-in-one solution, nor is it designed to be a sophisticated build system,
|
|
consider something like GNU Make or Mason instead.
|
|
|
|
Binary files (files that contain characters < ' ' or > '~') are supported.
|
|
|
|
Manpages are included: bake(1) shake(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.
|
|
|
|
--- Macro Extension ---
|
|
|
|
Macro provides various descriptive factors about the current context:
|
|
|
|
@FILENAME : Filename of the baked file (abc.x.txt)
|
|
@SHORT : Shortened version of the Filename (^-> abc.x)
|
|
@ARGS : the remaining arguments to Bake
|
|
|
|
$@, $*, $+, respectively mapped to @FILENAME, @SHORT, and @ARGS,
|
|
are still supported, avoid these in the future.
|
|
|
|
They are most useful for a template command, such as:
|
|
@BAKE cc @FILENAME -o @SHORT @ARGS
|
|
|
|
Backslash, while otherwise ignored, will be respected at the end of the line
|
|
to concatenate lines together or if added to before any of listed macros will
|
|
yield the unfettered text.
|
|
|
|
--- 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 after installation and as a bootstrapper.
|
|
The modified version includes all features of Bake with the exceptions of
|
|
multi-line commands. It is not a general replacement for Bake.
|
|
|
|
Bake is licensed under the GPLv3-only, See LICENSE.
|
|
|
|
Bake was created on September 13th, 2023, and is complete.
|