@@ -33,7 +33,7 @@ Note: Bridge allows you to both make reads and writes to the Ethereum blockchain
34Once the program is running in your browser, go through the steps presented according to the type of wallet you have. You’ll be presented with a few login options. A notable option is Urbit Master Ticket. This is for those who used our Wallet Generator software. If you bought points from an Urbit sale and then used the Wallet Generator, your networking keys will be set for you. All other login options will require you to set your own networking keys.
34Once the program is running in your browser, go through the steps presented according to the type of wallet you have. You’ll be presented with a few login options. A notable option is Urbit Master Ticket. This is for those who used our Wallet Generator software. If you bought points from an Urbit sale and then used the Wallet Generator, your networking keys will be set for you. All other login options will require you to set your own networking keys.
36−### Accept Your Transfer
36+### Accept your transfer
38If you were given points by Tlon you likely already fully own them. But if someone else sent you a point, then you will first need to use Bridge to accept that transfer.
38If you were given points by Tlon you likely already fully own them. But if someone else sent you a point, then you will first need to use Bridge to accept that transfer.
@@ -43,7 +43,7 @@ Now you'll be on the management page of your point. The transfer isn't completed
44If you already own a point, click on the `Details ->` under your sigil in the `Your Points` section.
44If you already own a point, click on the `Details ->` under your sigil in the `Your Points` section.
46−### Set Your Networking Keys
46+### Set your networking keys
48If you just accepted a point, you'll be returned to your point screen. Notice that that links and buttons are now clickable. You now own this point!
48If you just accepted a point, you'll be returned to your point screen. Notice that that links and buttons are now clickable. You now own this point!
@@ -57,14 +57,14 @@ and use the result.
58It should be noted that setting your network keys is an event on the Ethereum network and will therefore cost a trivial, but non-zero, amount of [gas](https://github.com/ethereum/wiki/wiki/Design-Rationale#gas-and-fees) to complete.
58It should be noted that setting your network keys is an event on the Ethereum network and will therefore cost a trivial, but non-zero, amount of [gas](https://github.com/ethereum/wiki/wiki/Design-Rationale#gas-and-fees) to complete.
60−### Generate Your Keyfile
60+### Generate your keyfile
62From the detail page associated with your point, click the `Generate Arvo Keyfile` link and you'll be taken to a page with a field titled `Network seed`. This field should already be filled in, and should match the hexadecimal string that you entered in the previous step. If it's not filled in or does not match, fill it in with the correct string.
62From the detail page associated with your point, click the `Generate Arvo Keyfile` link and you'll be taken to a page with a field titled `Network seed`. This field should already be filled in, and should match the hexadecimal string that you entered in the previous step. If it's not filled in or does not match, fill it in with the correct string.
63Click `Generate ->`, which will download a keyfile onto your machine.
63Click `Generate ->`, which will download a keyfile onto your machine.
65With that keyfile in hand, you can now exit Bridge and continue to the guide to [install the Urbit binary](@/install.md).
65With that keyfile in hand, you can now exit Bridge and continue to the guide to [install the Urbit binary](@/install.md).
67−## Using Your Ship {#urbit-administration}
67+## Using your ship {#urbit-administration}
69Your urbit (also called your _ship_) is a persistent Unix process that you mainly control from the console.
69Your urbit (also called your _ship_) is a persistent Unix process that you mainly control from the console.
@@ -238,7 +238,7 @@ Because Urbit networking is stateful we call this a _continuity breach_. Everyth
239When this happens, back up any files you'd like to save, shut down your urbit, and recreate it (as if you were starting for the first time).
239When this happens, back up any files you'd like to save, shut down your urbit, and recreate it (as if you were starting for the first time).
241−## Creating a Comet {#creating-a-comet}
241+## Creating a comet {#creating-a-comet}
243**Comets** are urbits whose names are 128-bits or 16 syllables, such as:
243**Comets** are urbits whose names are 128-bits or 16 syllables, such as:
@@ -246,7 +246,7 @@ When this happens, back up any files you'd like to save, shut down your urbit, a
247Comet names aren't quite as memorable as others, but they're disposable identities that anyone can make for free to join the live network.
247Comet names aren't quite as memorable as others, but they're disposable identities that anyone can make for free to join the live network.
249−### Booting a Comet
249+### Booting a comet
251To boot your comet, go into the command line and run the following command from the directory that was created during Urbit installation:
251To boot your comet, go into the command line and run the following command from the directory that was created during Urbit installation:
@@ -264,7 +264,7 @@ http: live (insecure, loopback) on 12321
264~dasres_marzod:dojo>
264~dasres_marzod:dojo>
267−## DNS Proxying {#dns-proxying}
267+## DNS proxying {#dns-proxying}
269We have a system that lets you request a domain name for your ship in the form of `ship.arvo.network`, where `ship` is your ship's name minus the `~`. This allows users to access their ships remotely using Landscape, our graphical web interface.
269We have a system that lets you request a domain name for your ship in the form of `ship.arvo.network`, where `ship` is your ship's name minus the `~`. This allows users to access their ships remotely using Landscape, our graphical web interface.
@@ -308,7 +308,7 @@ This will make HTTP-requests to self-check availability over `galaxy.$AMES-DOMAI
309Otherwise, `:dns|auto` works the same as `:dns|ip` does with stars and planets: if it's available or unavailable, talk messages, and so on.
309Otherwise, `:dns|auto` works the same as `:dns|ip` does with stars and planets: if it's available or unavailable, talk messages, and so on.
311−### More Information
311+### More information
313Configuring a ship's domain causes the `:acme` app to request an HTTPS certificate for that domain from LetsEncrypt. Note that LetsEncrypt also requires that the HTTP server be listening on port 80. If the certificate request fails, `:acme` will send a `:talk` message with an explanation. Once the certificate is successfully retrieved, `:acme` will install it, causing the HTTP servers to restart. A secure server will be started on port 443 (the HTTPS default) if it's available. Otherwise, it will try 8443, and then increment to the next port until it can successfully bind one.
313Configuring a ship's domain causes the `:acme` app to request an HTTPS certificate for that domain from LetsEncrypt. Note that LetsEncrypt also requires that the HTTP server be listening on port 80. If the certificate request fails, `:acme` will send a `:talk` message with an explanation. Once the certificate is successfully retrieved, `:acme` will install it, causing the HTTP servers to restart. A secure server will be started on port 443 (the HTTPS default) if it's available. Otherwise, it will try 8443, and then increment to the next port until it can successfully bind one.
@@ -352,7 +352,7 @@ You'll see your message printed below messages from others that came before it:
352~your-urbit= Hello, world!
352~your-urbit= Hello, world!
355−### Direct Messaging
355+### Direct messaging
357To send a direct message to someone, first set your audience:
357To send a direct message to someone, first set your audience:
@@ -475,7 +475,7 @@ will print as
475~your-urbit=^ Well, thanks!
475~your-urbit=^ Well, thanks!
478−#### Activating Lines
478+#### Activating lines
480A line number identifying the **subsequent** line is displayed every 5 lines.
480A line number identifying the **subsequent** line is displayed every 5 lines.
@@ -559,7 +559,7 @@ To delete our example above:
559sampel-palnet:talk> ;delete %coolbox 'people sent uncool messages'
559sampel-palnet:talk> ;delete %coolbox 'people sent uncool messages'
562−#### Change Description
562+#### Change description
564Syntax: `;depict %name 'description'`
564Syntax: `;depict %name 'description'`
@@ -639,17 +639,17 @@ For example:
639~sampel-palnet:talk> ;unsource %coolbox ~marzod/urbit-help
639~sampel-palnet:talk> ;unsource %coolbox ~marzod/urbit-help
642−#### Circle Membership
642+#### Circle membership
644If you have joined a circle, you can make this information publicly available to help others find that circle as well.
644If you have joined a circle, you can make this information publicly available to help others find that circle as well.
646−#### Show Membership
646+#### Show membership
648Syntax: `;show ~some/circle`
648Syntax: `;show ~some/circle`
650Adds a circle to your public membership list on your Hall profile. Hall profiles are not used yet.
650Adds a circle to your public membership list on your Hall profile. Hall profiles are not used yet.
652−#### Hide Membership
652+#### Hide membership
654Syntax: `;hide ~some/circle`
654Syntax: `;hide ~some/circle`
@@ -659,13 +659,13 @@ Removes a circle from your public membership list on your Hall profile. Hall pro
660You'll see status notifications when people enter or leave circles you're subscribed to.
660You'll see status notifications when people enter or leave circles you're subscribed to.
662−#### Notifications Off
662+#### Notifications off
664Syntax: `;set quiet`
664Syntax: `;set quiet`
666Turn off status (and config) notifications.
666Turn off status (and config) notifications.
668−#### Notifications On
668+#### Notifications on
670Syntax: `;unset quiet`
670Syntax: `;unset quiet`
@@ -703,7 +703,7 @@ For example:
703~sampel-palnet:talk> ;attend ~marzod/urbit-help idle
703~sampel-palnet:talk> ;attend ~marzod/urbit-help idle
706−#### Set Display Name
706+#### Set display name
708Syntax: `;name ~some/circle 'my handle'`
708Syntax: `;name ~some/circle 'my handle'`
@@ -717,7 +717,7 @@ An audience consists of one or more messaging targets. These can be
717circles or ships. (In the latter case, it's secretly the `~ship/inbox`
717circles or ships. (In the latter case, it's secretly the `~ship/inbox`
720−#### Circle Glyphs
720+#### Circle glyphs
722Glyphs are found at the end of your prompt to as a quick indicator of where
722Glyphs are found at the end of your prompt to as a quick indicator of where
723your messages will be sent.
723your messages will be sent.
@@ -804,31 +804,31 @@ There are a few special-purpose glyphs:
805### Configuration
805### Configuration
807−#### Set Audience
807+#### Set audience
809`;~ship/circle`
809`;~ship/circle`
811Set audience to `~ship/circle`.
811Set audience to `~ship/circle`.
813−#### Set Audience by Glyph
813+#### Set audience by glyph
815Syntax: `;[glyph]`
815Syntax: `;[glyph]`
817Set audience to the circle previously bound to the chosen glyph.
817Set audience to the circle previously bound to the chosen glyph.
819−#### Set Audience to Ship
819+#### Set audience to ship
821syntax `;~ship`
821syntax `;~ship`
823Set audience to another ship.
823Set audience to another ship.
825−#### Set Audience to Own Circle
825+#### Set audience to own circle
827Syntax: `;%circle`
827Syntax: `;%circle`
829Set audience to a circle on your own ship.
829Set audience to a circle on your own ship.
831−#### Set Audience + Send Message
831+#### Set audience and send message
833Syntax: `;~dannum-mitryl this is a private message`
833Syntax: `;~dannum-mitryl this is a private message`
@@ -843,44 +843,44 @@ Your audience is configured with regard to the following rules (in order):
844### Local nicknames
844### Local nicknames
846−#### See Nicknames
846+#### See nicknames
848Syntax: `;nick`
848Syntax: `;nick`
850List all local nicknames.
850List all local nicknames.
852−#### Find Nickname
852+#### Find nickname
854Syntax: `;nick ~some-urbit`
854Syntax: `;nick ~some-urbit`
856Look up a nickname using the known ship-name.
856Look up a nickname using the known ship-name.
858−#### Reverse Find Nickname
858+#### Reverse-find nickname
860syntax: `;nick plato`
860syntax: `;nick plato`
862Find a ship's name using its nickname.
862Find a ship's name using its nickname.
864−#### Set Nickname
864+#### Set nickname
866Syntax: `;nick ~some-urbit plato`
866Syntax: `;nick ~some-urbit plato`
868Create a new nickname.
868Create a new nickname.
870−#### Clear Nickname
870+#### Clear nickname
872Syntax: `;nick ~some-urbit ~`
872Syntax: `;nick ~some-urbit ~`
874Clear an assigned nickname.
874Clear an assigned nickname.
876−#### Display Nicks, Not Ship-Names
876+#### Display nicknames, not ship names
878Syntax: `;set nicks`
878Syntax: `;set nicks`
880Show nicknames instead of ship-names. If no local nickname is set, uses
880Show nicknames instead of ship-names. If no local nickname is set, uses
881that user's handle. If the user has no handle, just the urbit name.
881that user's handle. If the user has no handle, just the urbit name.
883−#### Display Ship-Names, Not Nicks
883+#### Display ship names, not nicknames
885Syntax: `;unset nicks`
885Syntax: `;unset nicks`
@@ -892,38 +892,38 @@ phonebook.
893### Miscellaneous configuration
893### Miscellaneous configuration
895−#### Show Timestamps
895+#### Show timestamps
897Syntax: `;set showtime`
897Syntax: `;set showtime`
899Show the timestamp for each message.
899Show the timestamp for each message.
901−#### Hide Timestamps
901+#### Hide timestamps
903Syntax: `;unset showtime`
903Syntax: `;unset showtime`
905Stop showing the timestamp for each message.
905Stop showing the timestamp for each message.
907−#### Change Time Zone
907+#### Change timezone
909Syntax: `;set timezone [+/-][hours]`
909Syntax: `;set timezone [+/-][hours]`
911Adjust the display of timestamps to a specific timezone. Relative to UTC.
911Adjust the display of timestamps to a specific timezone. Relative to UTC.
913−#### Sound Notification On
913+#### Sound notification on
915Syntax: `;set notify`
915Syntax: `;set notify`
917Emit a terminal bell sound if your six-syllable ship name is mentioned in
917Emit a terminal bell sound if your six-syllable ship name is mentioned in
918a message.
918a message.
920−#### Sound Notification Off
920+#### Sound notification off
922Syntax `;unset notify`
922Syntax `;unset notify`
924Do not notify when your ship name is mentioned.
924Do not notify when your ship name is mentioned.
926−#### Set Width
926+#### Set width
928Syntax: `;set width [number]`
928Syntax: `;set width [number]`
@@ -973,7 +973,7 @@ Use `=var` to save faces to the Dojo subject.
973Note, however, that `=var` is Dojo syntax, not Hoon syntax. You cannot bind a
973Note, however, that `=var` is Dojo syntax, not Hoon syntax. You cannot bind a
974face in a `.hoon` file in this way.
974face in a `.hoon` file in this way.
976−#### System Commands
976+#### System commands
978Use `=dir` to set the current working directory:
978Use `=dir` to set the current working directory:
@@ -1167,7 +1167,7 @@ Set any environment variable:
1167Make sure to note that `=var` is Dojo syntax, not Hoon syntax. You cannot bind a
1167Make sure to note that `=var` is Dojo syntax, not Hoon syntax. You cannot bind a
1168variable in a `.hoon` file in this way.
1168variable in a `.hoon` file in this way.
1170−#### Special Variables
1170+#### Special variables
1172There are a few special variables that the Dojo maintains.
1172There are a few special variables that the Dojo maintains.
@@ -1285,7 +1285,7 @@ fintyr-haldet-fassev-solhex
1285You can use `=` to set an environment variable in Dojo, but there are
1285You can use `=` to set an environment variable in Dojo, but there are
1286a few reserved names that have special uses.
1286a few reserved names that have special uses.
1288−#### dir
1288+#### `dir`
1290Current working `%clay` desk and revision. Read / write.
1290Current working `%clay` desk and revision. Read / write.
@@ -1297,7 +1297,7 @@ Current working `%clay` desk and revision. Read / write.
1297404/hoon docs/ dojo/hoon lib/ listen/hoon md static/udon talk/ testing/udon tree/main/ unmark/ womb/
1297404/hoon docs/ dojo/hoon lib/ listen/hoon md static/udon talk/ testing/udon tree/main/ unmark/ womb/
1300−#### lib
1300+#### `lib`
1302Current set of libraries (`/lib`) in your environment. Can be set
1302Current set of libraries (`/lib`) in your environment. Can be set
1303with `/+`. Read / write.
1303with `/+`. Read / write.
@@ -1312,7 +1312,7 @@ Now we can use arms from lib/number-to-words.hoon
1312~your-urbit:dojo> (to-words:eng-us:number-to-words 123.456)
1312~your-urbit:dojo> (to-words:eng-us:number-to-words 123.456)
1315−#### sur
1315+#### `sur`
1317Current set of structures (`/sur`) in your environment. Can be set
1317Current set of structures (`/sur`) in your environment. Can be set
1318with `/-`. Read / write.
1318with `/-`. Read / write.
@@ -1327,7 +1327,7 @@ Now we can use arms in sur/sole.hoon.
1327~your-urbit:dojo> `sole-effect:sole`[%bel ~]
1327~your-urbit:dojo> `sole-effect:sole`[%bel ~]
1330−#### now
1330+#### `now`
1332The current (128-bit `@da`) time. Read-only.
1332The current (128-bit `@da`) time. Read-only.
@@ -1338,7 +1338,7 @@ The current (128-bit `@da`) time. Read-only.
1338~2016.3.21..21.10.57..429a
1338~2016.3.21..21.10.57..429a
1341−#### our
1341+#### `our`
1343The current urbit ship. Read-only.
1343The current urbit ship. Read-only.
@@ -1349,7 +1349,7 @@ The current urbit ship. Read-only.
1349~your-urbit
1349~your-urbit
1352−#### eny
1352+#### `eny`
1354512 bits of entropy. Read-only.
1354512 bits of entropy. Read-only.