Disallow archive paths beginning with `/`

[Shushe] / README.markdown

diff --git a/README.markdown b/README.markdown
index 7c663be305086a76c6d33937a012c7eb339e4ce9..55d6f8f8d7c31ba42d6477c2f2ef8f043696d45a 100644 (file)
--- a/README.markdown
+++ b/README.markdown
@@ -121,6 +121,7 @@ In every case, you may supply your own implementation by overriding the
 - `mkdir` (requires support for `-p`)
 - `mv`
 - `od` (requires support for `-t x1`)
+- `pax` (only when generating archives)
 - `printf`
 - `rm`
 - `sed`
@@ -528,7 +529,8 @@ Output wrapping can be entirely disabled by adding a
   `@书社:disable-output-wrapping` attribute to the top‐level element in
   the result tree.
 It will not be performed on outputs whose root elements are
-  `<书社:raw-text>` or `<书社:base64-binary>` (described below).
+  `<书社:archive>`, `<书社:base64-binary>`, or `<书社:raw-text>`
+  (described below).
 
 ## Applying Attributes
 
@@ -558,15 +560,24 @@ There are a few special elements in the `书社:` namespace which, if
   ⛩️📰 书社 to produce something other than an X·M·L file.
 They are :⁠—
 
-- **`<书社:raw-text>`:**
-  A plaintext (U·T·F‐8) file will be produced from the text nodes in
-    the transformation result.
+- **`<书社:archive>`:**
+  Each child element with a `@书社:archived-as` attribute will be
+    archived as a separate file in a resulting tarball (this attribute
+    gives the file name).
+  These elements will be processed the same as the root elements of any
+    other file (e·g, they will be wrapped; they can themselves specify
+    non X·M·L output types, ⁊·c).
+  Other child elements will be ignored.
 
 - **`<书社:base64-binary>`:**
   The text nodes in the transformation result will, after removing all
     Ascii whitespace, be treated as a Base·64 string, which is then
     decoded.
 
+- **`<书社:raw-text>`:**
+  A plaintext (U·T·F‐8) file will be produced from the text nodes in
+    the transformation result.
+
 ## License
 
 This repository conforms to [REUSE][].