@@ -127,7 +127,9 @@ and the HTML itself.
127127### `/&` pass through a series of marks
128128
129129`/&` passes a horn through multiple marks, right-to-left. It has both a
130−wide-form and a tall-form syntax. Wide-form:
130+wide-form and a tall-form syntax. In wide-form, it takes a series of mark
131+arguments followed by a horn. In tall-form, it takes a single mark followed by
132+a horn.
131133
132134```
133135/= some-text /: /%/text-file /&mime&/txt/
@@ -158,7 +160,13 @@ checking that the type fits in `manx` (a hoon/sail type indicating an XML
158160element). The `%html` mark recognizes the `%elem` and converts it to an HTML
159161string with enclosing `<html>`, `<head>`, and `<body>` tags.
160162
161−It's possible to use wide-form `/&` with more than two marks, by using `&` as a delimiter between marks and adding a `/` before the last mark, like: `/&d&c&b&/a/`.
163+It's possible to use wide-form `/&` with more than two marks, by using `&` as a
164+delimiter between marks and adding a `/` before the last mark, like:
165+`/&d&c&b&/a/`. The last argument here can actually be any arbitrary horn, not
166+just a mark: `/&c&b&/:path:/mark/`
167+
168+Tall-form `/&` takes only two arguments: a mark and a horn. The mark does not
169+need to be enclosed in `/`'s: `/& html /elem/`
162170
163171### `/_` run a horn on each file in the current directory
164172