X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/0dbf03dfcc1a94ba1a07a0b1d7dd8c0f53824db3..d94cfdc987aba3983f4945d59b02cbb062573432:/README.markdown?ds=inline diff --git a/README.markdown b/README.markdown index 2bb1bce..cae7ac1 100644 --- a/README.markdown +++ b/README.markdown @@ -93,6 +93,7 @@ In every case, you may supply your own implementation by overriding the - `cat` - `cp` +- `date` - `echo` - `file` - `find` @@ -102,6 +103,7 @@ In every case, you may supply your own implementation by overriding the - `rm` - `sed` - `sleep` +- `stat` - `test` - `touch` - `tr` (requires support for `-d`) @@ -122,9 +124,21 @@ The following additional variables can be used to control the behaviour - **`BUILDDIR`:** The location of the (temporary) build directory (default: `build`). + `make clean` will delete this, and it is recommended that it not be + used for programs aside from ⛩️📰 书社. - **`DESTDIR`:** The location of directory to output files to (default: `public`). + `make install` will overwrite files in this directory which + correspond to those in `SRCDIR`. + It *will not* touch other files, including those generated from files + in `SRCDIR` which have since been deleted. + + Files are first compiled to `$(BUILDDIR)/public` before they are + copied to `DESTDIR`, so this folder is relatively quick and + inexpensive to re·create. + It’s reasonable to simply delete it before every `make install` to + ensure stale content is removed. - **`THISDIR`:** The location of the ⛩️📰 书社 `GNUmakefile`. @@ -138,12 +152,20 @@ The following additional variables can be used to control the behaviour - **`FINDOPTS`:** Options to pass to `find` when searching for source files (default: - `-LE`). + `-PE`). - **`FINDRULES`:** Rules to use with `find` when searching for source files (default: `-flags -nohidden -and -not -name '.*'`). +- **`FINDINCLUDEOPTS`:** + Options to pass to `find` when searching for includes (default: + `$(FINDOPTS)`). + +- **`FINDINCLUDERULES`:** + Rules to use with `find` when searching for includes (default: + `$(FINDRULES)`). + - **`PARSERS`:** A white·space‐separated list of parsers to use (default: `$(THISDIR)/parsers/*.xslt`). @@ -175,6 +197,8 @@ Supported magic numbers include :⁠— - `#!js` for `text/javascript` files - `@charset "` for `text/css` files - `#!tsv` for `text/tab-separated-values` files +- `%%` for `text/record-jar` files (unregistered; see + [[draft-phillips-record-jar-01][]]) Text formats with associated X·S·L·T parsers are wrapped in a H·T·M·L `