@@ -30,7 +30,7 @@ this section isn't too long, so many readers may wish to quickly read through
3030all of it. If you get bored, though, just skip to the next section. You can
3131always come back when you need to.
3232
33−### `++raft`, formal state
33+### `$raft`, formal state
3434
3535```hoon
3636+$ raft :: filesystem
@@ -51,47 +51,41 @@ calls to Clay is stored in this state.
5151where all the "real" data we know is stored; the rest is "just
5252bookkeeping".
5353
54−`rom` is our domestic state. It consists of a `duct` to
54+`rom` is the state for all local desks. It consists of a `duct` to
5555[Dill](@/docs/arvo/dill/dill.md) and a collection of `desk`s.
5656
57−`hoy` is a collection of foreign ships for which we know something about their
58−Clay.
57+`hoy` is the state for all foreign desks.
5958
60−`ran` is the object store. It has maps of commit hashes to commits and content
61−hashes to content.
59+`ran` is the global, hash-addressed object store. It has maps of commit hashes
60+to commits and content hashes to content.
6261
6362`mon` is a collection of Unix mount points. `term` is the mount point (relative
6463to th pier) and `beam` is a domestic Clay directory.
6564
66−`hez` is the Unix duct that `%ergo` `%gift`s should be sent to.
65+`hez` is the duct used to sync with Unix.
6766
6867`cez` is a collection of named permission groups.
6968
7069`pud` is an update that's waiting on a kernel upgrade.
7170
7271
73−#### `++room`, filesystem per domestic ship
72+#### `$room`, filesystem per domestic ship
7473
7574```hoon
76− ++ room :: fs per ship
77− $: hun=duct :: terminal duct
78− hez=(unit duct) :: sync duch
79− dos=(map desk dojo) :: native desk
80− == ::
75++$ room :: fs per ship
76+ $: hun=duct :: terminal duct
77+ dos=(map desk dojo) :: native desk
78+ == ::
8179```
8280
8381This is the representation of the filesystem of a ship on our pier.
8482
85−`hun` is the duct we use to send messages to dill to display
86−notifications of filesystem changes. Only `%note` gifts should be
87−produced along this duct. This is set by the `%init` kiss.
88−
89−`hez`, if present, is the duct we use to send sync messages to unix so
90−that they end up in the pier unix directory. Only `%ergo` gifts should
91−be producd along this duct. This is set by `%into` and `%invo` kisses.
83+`hun` is the duct we use to send messages to [Dill](@/docs/arvo/dill/dill.md) to
84+display notifications of filesystem changes. Only `%note` `%gift`s should be
85+produced along this `duct`. This is set by the `%init` `move`.
9286
9387`dos` is a well-known operating system released in 1981. It is also the
94−set of desks on this ship, mapped to their data.
88+set of desks on this ship, mapped to their desk state.
9589
9690#### `++desk`, filesystem branch
9791