X-Git-Url: https://git.ladys.computer/Shushe/blobdiff_plain/2d4cbd1e2235a49728ca6ccb5a73c15fb34736d6..a9dfb3cd8b5a2a8a3c6b8ce90212638166a15fd3:/README.markdown?ds=sidebyside diff --git a/README.markdown b/README.markdown index 28b8b46..dec092a 100644 --- a/README.markdown +++ b/README.markdown @@ -91,6 +91,7 @@ In every case, you may supply your own implementation by overriding the corresponding (allcaps) variable (e·g, set `MKDIR` to supply your own `mkdir` implementation). +- `awk` - `cat` - `cp` - `date` @@ -99,6 +100,7 @@ In every case, you may supply your own implementation by overriding the - `find` - `mkdir` (requires support for `-p`) - `mv` +- `od` (requires support for `-t x1`) - `printf` - `rm` - `sed` @@ -108,6 +110,7 @@ In every case, you may supply your own implementation by overriding the - `touch` - `tr` (requires support for `-d`) - `uuencode` (requires support for `-m` and `-r`) +- `xargs` (requires support for `-0`) - `xmlcatalog` (provided by `libxml2`) - `xmllint` (provided by `libxml2`) - `xsltproc` (provided by `libxslt`) @@ -117,10 +120,14 @@ The following additional variables can be used to control the behaviour - **`SRCDIR`:** The location of the source files (default: `sources`). + Multiple source directories can be provided, so long as the same + file subpath doesn’t exist in more than one of them. - **`INCLUDEDIR`:** - The location of the source files (default: `sources/includes`). + The location of source includes (default: `sources/includes`). This can be inside of `SRCDIR`, but needn’t be. + Multiple include directories can be provided, so long as the same + file subpath doesn’t exist in more than one of them. - **`BUILDDIR`:** The location of the (temporary) build directory (default: `build`). @@ -152,12 +159,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`). @@ -370,7 +385,7 @@ In addition to being called with the transform result, each of these modes will additionally be called with a `` element corresponding to each transform. If a transform has a `<书社:id>` top‐level element whose value is an - i·r·i, its `` element will have a corresponding + i·r·i, its `` element will have a corresponding `@书社:id` attribute. This mechanism can be used to allow transforms to insert content without matching any elements in the result; for example, the