on master help sign in
wide-form /_ and separate headers for filtered and unfiltered
498206aTed Blackman
docs/arvo/internals/ford/runes.md+7−1
@@ -185,7 +185,7 @@ just a mark: `/&c&b&/:path:/mark/`
185Tall-form `/&` takes only two arguments: a mark and a horn. The mark does not
185Tall-form `/&` takes only two arguments: a mark and a horn. The mark does not
186need to be enclosed in `/`'s: `/& html /elem/`
186need to be enclosed in `/`'s: `/& html /elem/`
187
187
188−### `/_` run a horn on each file in the current directory
188+### `/_` unfiltered: run a horn on each file in the current directory
189
189
190`/_` can be used in two ways: filtered and unfiltered.
190`/_` can be used in two ways: filtered and unfiltered.
191
191
@@ -208,6 +208,10 @@ contents of the file through the `%hoon` mark, which validates that it's valid
208hoon code and returns it unmodified. So, the resulting map associates basenames
208hoon code and returns it unmodified. So, the resulting map associates basenames
209with file contents.
209with file contents.
210
210
211+Wide-form unfiltered `/_` doesn't need a delimiter: `/= kids /_/hoon/`
212+
213+### `/_` filtered: run a horn on each file in the directory matching an aura
214+
211Filtered `/_` takes an aura and a horn, and filters the list of files in the
215Filtered `/_` takes an aura and a horn, and filters the list of files in the
212current directory by whether their filenames can be parsed to an atom of that
216current directory by whether their filenames can be parsed to an atom of that
213aura. It then produces a map where each key is the filename after parsing into
217aura. It then produces a map where each key is the filename after parsing into
@@ -223,6 +227,8 @@ produces a map from dates to cords. This product will only contain files whose
223names are parsable into `@da` dates. The values are the file contents converted
227names are parsable into `@da` dates. The values are the file contents converted
224to a cord of markdown-formatted text.
228to a cord of markdown-formatted text.
225
229
230+Wide-form filtered `/_` uses `_` as a delimiter: `/= timed-posts /_@da_/md/`
231+
226### `/;` operate on
232### `/;` operate on
227
233
228`/;` takes a twig and a horn. The twig should evaluate to a gate, which is then slammed
234`/;` takes a twig and a horn. The twig should evaluate to a gate, which is then slammed