@@ -124,6 +124,40 @@ produces:
124This result includes the MIME type ('text/html'), the content length in bytes,
124This result includes the MIME type ('text/html'), the content length in bytes,
125and the HTML itself.
125and the HTML itself.
127+### `/&` pass through a series of marks
129+`/&` passes a horn through multiple marks, right-to-left. It has both a
130+wide-form and a tall-form syntax. Wide-form:
133+/= some-text /: /%/text-file /&mime&/txt/
137+produces: `[[%text %plain ~] p=17 q='Hi I\'m some text\0a']`
139+This example shows two of the ways marks are used. The first way is what
140+happens with the `/txt/` mark: we use it to find a file in clay with that
141+extension, without performing any conversions. Since this file is stored with
142+the `%txt` mark in `%clay`, its type is a `wain`: a list of cords, where each
143+cord is a single line. Once we've read the file, the `%mime` mark converts the
144+`wain` to a triple that includes the MIME type ("text/plain"), the content
145+length in bytes, and the content itself as a cord.
148+/= page /&html&elem&/~[;div.foo;]
152+produces: `'<html><head></head><body><div class="foo"></div></body></html>'`
154+This runs the sail expression `;div.foo;` through the `%elem` mark, then
155+through the `%html` mark. The `/~` rune produces an item of mark `noun`. The
156+`%elem` mark converts the mark of the expression from `noun` to `elem` by
157+checking that the type fits in `manx` (a hoon/sail type indicating an XML
158+element). The `%html` mark recognizes the `%elem` and converts it to an HTML
159+string with enclosing `<html>`, `<head>`, and `<body>` tags.
127### `/_` run a horn on each file in the current directory
161### `/_` run a horn on each file in the current directory
129`/_` takes a horn as an argument. It produces a new horn representing the
163`/_` takes a horn as an argument. It produces a new horn representing the