@@ -139,15 +139,52 @@ planet can issue ~4 billion (`2^32`) moons.
139139To generate a random moon from your planet, run:
140140
141141```
142−~your-urbit:dojo> +moon
142+~sampel-palnet:dojo> +moon
143+moon: ~faswep-navred-sampel-palnet
144+\/~.0wd.rZU67.3jSny.z1vda.7sr-s.EL1Jt.-76Nj.ugXxY.g6-Bx.HvKZl.G53oV.hPnXe.7U3E3.J4CEe.MEVuq.~08Nt\/
145+ .zNT0K.k-Ab~.Nn90d.OZ2fT.-XlQQ.Cfrkf.y6~K0.2Do09.EaE3W.BSK--.5Q~9N.y3QIP.eokH-.T6lwz.gg8MX.7LU5
146+ x.DJROE.IzQsy.OXOLr.IOE3a.-QI40.H5ukK.Cw-u4.uxE-y.V-o1F.Q84g0.effP0.de01g.600g1
147+\/ \/
143148```
144149
150+You must manually edit the output of `+moon` to get
151+the correct format for the `<key>`:
152+
153+- strip out the `\/`
154+
155+- combine into one line, omitting spaces
156+
157+- trim the leading `~.`
158+
159+`<key>` would be `0wd.rZU67.3jSny.z1vda ... <snip> ... effP0.de01g.600g1`
160+in this example.
161+
162+Put `<key>` in a file and that file becomes `<keyfile>`.
163+
164+*`<keyfile>` must not have a trailing newline.*
165+
166+Another way of generating `<keyfile>` is:
167+
168+```
169+~sampel-palnet:dojo> @moon/key +moon
170+moon: ~faswep-navred-sampel-palnet
171+```
172+
173+`<keyfile>` will be at `path/to/sampel-palnet/.urb/put/moon.key`
174+and does not need editing to be used with the `-k` option.
175+
145176You can use the resulting output in the same installation flow from
146177[install](../install) and [setup](../setup), following the same scheme as
147178for booting a planet. That scheme is:
148179
149180```
150−$ urbit -w <moonname> -t <ticket> -c <piername>
181+$ urbit -w <moonname> -G <key> -c <piername>
182+```
183+
184+or
185+
186+```
187+$ urbit -w <moonname> -k <keyfile> -c <piername>
151188```
152189
153190The `-c <piername>` argument is not required, but it is recommended; otherwise,
@@ -156,9 +193,14 @@ the resulting directory is a rather unwieldy moon name.
156193Here's how an example moon might be booted:
157194
158195```
159−$ urbit -w faswep-navred-sampel-palnet -t habref-mebsem-parsym-batlus -c mymoon
196+$ urbit -w faswep-navred-sampel-palnet -G <key> -c mymoon
160197```
161198
199+or
200+
201+```
202+$ urbit -w faswep-navred-sampel-palnet -k <keyfile> -c mymoon
203+```
162204
163205Moons are automatically synced to their parent `%kids` desk, and can control
164206applications on their parent planet using `|link`. You can read more about