Drop CKSUM and SRCTIME params; add as attributes

[Shushe] / README.markdown

diff --git a/README.markdown b/README.markdown
index 6b865aeb07499008c86d550e253ae89cdcc51820..e70361e3160b68b98656993439f61f38f36d5f52 100644 (file)
--- a/README.markdown
+++ b/README.markdown
@@ -283,6 +283,8 @@ The following additional variables can be used to control the behaviour
     those which end with a cloparen, and those which contain a hash,
     buck, percent, asterisk, colon, semi, eroteme, bracket, backslash,
     or pipe.
     those which end with a cloparen, and those which contain a hash,
     buck, percent, asterisk, colon, semi, eroteme, bracket, backslash,
     or pipe.

+  It is important that these rules not produce any output, as anything
+    printed to `stdout` will be considered a result of the find.

 
 - **`EXTRAFINDRULES`:**
   The value of this variable is appended to `FINDRULES` by default, to
 
 - **`EXTRAFINDRULES`:**
   The value of this variable is appended to `FINDRULES` by default, to


@@ -465,8 +467,17 @@ It is **strongly recommended** that auxillary templates in parsers be
 ⛩️📰 书社 will add a few attributes to the output of the parsing step,
   namely :⁠—
 
 ⛩️📰 书社 will add a few attributes to the output of the parsing step,
   namely :⁠—
 

-- A `@书社:cksum` attribute on toplevel result elements, giving the
-    `cksum` checksum of the corresponding source file.
+- For toplevel result elements :⁠—
+
+  - A `@书社:cksum` attribute giving the `cksum` checksum of the
+      corresponding source file.
+
+  - A `@书社:mtime` attribute giving the last modified time of the
+      corresponding source file.
+
+  - A `@书社:identifier` attribute giving the ⛩️📰 书社 identifier
+      (i·e, starting with `about:shushe?`) of the corresponding source
+      file.

 
 - For the elements which result from parsing plaintext `<html:script>`
     elements :⁠—
 
 - For the elements which result from parsing plaintext `<html:script>`
     elements :⁠—


@@ -586,9 +597,6 @@ The following params are made available globally in parsers and
 - **`BUILDTIME`:**
   The current time.
 
 - **`BUILDTIME`:**
   The current time.
 

-- **`CKSUM`:**
-  The checksum of the source file (⅌ `cksum`).
-

 - **`IDENTIFIER`:**
   The ⛩️📰 书社 identifier of the source file (a u·r·i beginning with
     `about:shushe`).
 - **`IDENTIFIER`:**
   The ⛩️📰 书社 identifier of the source file (a u·r·i beginning with
     `about:shushe`).


@@ -596,16 +604,13 @@ The following params are made available globally in parsers and
 - **`SRCREV`:**
   The value of the `SRCREV` variable (if present).
 
 - **`SRCREV`:**
   The value of the `SRCREV` variable (if present).
 

-- **`SRCTIME`:**
-  The time at which the source file was last modified.
-

 - **`THISREV`:**
   The value of the `THISREV` variable (if present).
 
 The following params are only available in transforms :⁠—
 
 - **`THISREV`:**
   The value of the `THISREV` variable (if present).
 
 The following params are only available in transforms :⁠—
 

-- **`CATALOG`:**
-  The path of the catalog file (within `BUILDDIR`).
+- **`METADATA`:**
+  The path of the metadata file (within `BUILDDIR`).

 
 - **`PATH`:**
   The path of the output file (within `DESTDIR`).
 
 - **`PATH`:**
   The path of the output file (within `DESTDIR`).