rebalance

This commit is contained in:
Chad C. Starz 2024-04-14 05:30:14 +00:00
parent 6fb6964bd7
commit 3c2996e2d4
No known key found for this signature in database
GPG Key ID: CEEBC9208C287297

50
README
View File

@ -8,15 +8,15 @@ You may have multi-line commands, by either including a leading @STOP or by
ending each line with a backslash. ending each line with a backslash.
The execution takes place at the root of the target file, so if you have: 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 `test/file.c', and then execution takes place at `test' and the file is simply
simply regarded as `file.c'. regarded as `file.c'.
you may see a real example in the primary and only source file: `bake.c'. you may see a real example in the primary and only source file: `bake.c'. this
this is not targeted toward any language and should be fairly flexible, is not targeted toward any language and should be fairly flexible, especially
especially when multi-line comments are available. You should always when multi-line comments are available. You should always consider your usecase
consider your usecase before using a tool like this. Bake is not an before using a tool like this. Bake is not an all-in-one solution, nor is it
all-in-one solution, nor is it designed to be a sophisticated build system, designed to be a sophisticated build system, consider something like GNU Make or
consider something like GNU Make or Meson instead. Meson instead.
Binary files (files that contain characters < ' ' or > '~') are supported. Binary files (files that contain characters < ' ' or > '~') are supported.
@ -26,23 +26,22 @@ Manpages are included: bake(1) shake(1)
Bootstrapping may be done with Shake, simply run `./shake ./bake.c' 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 Or simply run `install.sh', you'll need to be a privileged user to install the
install the files. See the file's content for more details regarding files. See the file's content for more details regarding the installation.
the installation.
--- Macro Extension --- --- Macro Extension ---
Macro provides various descriptive factors about the current context: Macro provides various descriptive factors about the current context:
@FILENAME : Filename of the baked file (abc.x.txt) @FILENAME : Filename of the baked file (abc.x.txt) @SHORT : Shortened version
@SHORT : Shortened version of the Filename (^-> abc.x) of the Filename (^-> abc.x) @ARGS : the remaining arguments to Bake
@ARGS : the remaining arguments to Bake
$@, $*, $+, respectively mapped to @FILENAME, @SHORT, and @ARGS, $@, $*, $+, are respectively mapped to @FILENAME, @SHORT, and @ARGS. They have
are still supported, avoid these in the future. been partially deprecated, however they'll never be removed, use them if you'd
like.
They are most useful for a template command, such as: They are most useful for a template command, such as: @BAKE cc @FILENAME -o
@BAKE cc @FILENAME -o @SHORT @ARGS @SHORT @ARGS
Backslash, while otherwise ignored, will be respected at the end of the line to 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 concatenate lines together or if added to before any of listed macros will yield
@ -74,17 +73,16 @@ This feature was suggested by the original author of Shake, blame him for this.
Options must come before the filename, and may be merged together, such as -xn. Options must come before the filename, and may be merged together, such as -xn.
-v, --version: display versioning and licensing information. -v, --version: display versioning and licensing information. h, --help:
-h, --help: display the help message, similarly to empty input. -display the help message, similarly to empty input. n, --dry-run: DRYRUN,
-n, --dry-run: DRYRUN, does NOT run anything! -does NOT run anything! x, --expunge: See above Expunge Extension section. c,
-x, --expunge: See above Expunge Extension section. ---color: Disables color for a clean output.
-c, --color: Disables color for a clean output.
--- Shake --- --- Shake ---
Bake was inspired by the Bash-based Shake utility (formerly eMake, Bake was inspired by the Bash-based Shake utility (formerly eMake, he liked my
he liked my suggestion for a name). It is included under authorization suggestion for a name). It is included under authorization of its creator. The
of its creator. The original version of Shake may be found at: original version of Shake may be found at:
<http://bis64wqhh3louusbd45iyj76kmn4rzw5ysawyan5bkxwyzihj67c5lid.onion/anon/shake> <http://bis64wqhh3louusbd45iyj76kmn4rzw5ysawyan5bkxwyzihj67c5lid.onion/anon/shake>
Bake includes a modified Shake, both after installation and as a bootstrapper. Bake includes a modified Shake, both after installation and as a bootstrapper.