Various fixes and improvements.

This commit is contained in:
C. Guy Yarvin 2015-10-20 16:50:53 -07:00
parent 0f178d5914
commit 13cd3c8c0d
6 changed files with 30 additions and 31 deletions

View File

@ -20,7 +20,7 @@ internals, but again it helps. But you need to know Hoon.
Don't worry,
Alas, the developer doc is still under construction. We'll have
more soon, starting with Nock.
more soon.
<list></list>

View File

@ -6,7 +6,7 @@ sort: 0
Urbit: an operating function
============================
<div class="warning">This is Urbit whitepaper DRAFT 41K. Some small details
<div class="warning">This is Urbit whitepaper DRAFT 40K. Some small details
remain at variance with the codebase.</div>
Abstract
@ -1049,17 +1049,17 @@ is easier than it looks.
Languages do need to be read out loud, and the conventional names
for punctuation are clumsy. So Hoon replaces them:
ace [1 space] dot . pan ]
bar | fas / pel )
bis \ gap [>1 space, nl] pid }
buc $ hax # ran >
cab _ ket ^ rep '
cen % lep ( sac ;
col : lit < tar *
com , lus + tec `
das - mat @ tis =
den " med & wut ?
dip { nap [ zap !
ace [1 space] gal < pel (
bar | gap [>1 space, nl] per )
bas \ gar > sel [
buc $ hax # sem ;
cab _ hep - ser ]
cen % kel { soq '
col : ker } tar *
com , ket ^ tec `
doq " lus + tis =
dot . pam & wut ?
fas / pat @ zap !
For example, `%=` sounds like "centis" rather than "percent
equals." Since even a silent reader will subvocalize, the length

View File

@ -17,7 +17,7 @@ For power users, the [appliance handbook](appliance) explains
your apps and how to control them. The [filesystem handbook](clay)
explains the Urbit filesystem and how to sync it with Unix.
Finally, the [:dojo manual](dojo) and [:talk manual](talk)
reveal the fine points of our shell and messenger respectively.
explore the fine points of our shell and messenger respectively.
<list dataSort="true"></list>

View File

@ -161,7 +161,7 @@ Every finished line is parsed into one `++dojo-command`:
== ::
Each kind of `++dojo-command` is an action that depends on one
noun thproduction, a `++dojo-recipe`. We describe first the
noun production, a `++dojo-recipe`. We describe first the
commands, then the recipes.
##### `[%show p=dojo-recipe]`

View File

@ -12,7 +12,7 @@ on a functional operating system, Arvo, written in a strict,
typed functional language, Hoon, which compiles itself to a
combinator interpreter, Nock, whose spec gzips to 340 bytes.
What is this for? Most directly, Urbit is designed as a
What is Urbit for? Most directly, Urbit is designed as a
personal cloud server for self-hosted web apps. It also uses
HTTP APIs to manage data stuck in traditional web applications.

View File

@ -59,18 +59,18 @@ And hit return. Don't worry, no one but you will see this. The
It's boring to post to yourself. Let's join a station:
~tasfyn-partyv: ;join /urbit-test
~tasfyn-partyv: ;join /urbit-meta
(`/urbit-test` is a federal station, meaning it's hosted by your
(`/urbit-meta` is a federal station, meaning it's hosted by your
star (for `~tasfyn-partyv`, `~doznec`). The `/` notation is just
an abbreviation for `~doznec/urbit-test`.)
an abbreviation for `~doznec/urbit-meta`.)
You'll see:
---------:talk| %porch subscribed to /urbit-test, called `>`
---------:talk| rules of /urbit-test:
---------:talk| %porch subscribed to /urbit-meta, called `>`
---------:talk| rules of /urbit-meta:
---------:talk| test posts only. no shitposting. no pedos/nazis.
~doznec> ~tasfyn-partyv admitted to %urbit-test
~doznec> ~tasfyn-partyv admitted to %urbit-meta
~tasfyn-partyv:talk>
Notice the character assignment - stations you're subscribed to are
@ -78,7 +78,7 @@ assigned [consistent ASCII glyphs](#-station-glyphs), which you'll
see in the log when you hear from these stations, and on the prompt
when you're talking to them.
Post a line to `/urbit-test`:
Post a line to `/urbit-meta`:
~tasfyn-partyv:talk> hello, world
@ -86,18 +86,18 @@ You'll see, echoed back at you through `~doznec`:
~tasfyn-partyv:talk> hello, world
And of course, anyone else in `/urbit-test` will see it as well.
But you don't care about `/urbit-test`, so leave it:
And of course, anyone else in `/urbit-meta` will see it as well.
But you don't care about `/urbit-meta`, so leave it:
~tasfyn-partyv:talk> ;leave
You'll see:
---------:talk| %porch has left /urbit-test, called `>`
---------:talk| %porch has left /urbit-meta, called `>`
Everyone else will see:
~doznec> ~tasfyn-partyv has left %urbit-test
~doznec> ~tasfyn-partyv has left %urbit-meta
Now you're ready to use `:talk` for real! List the federal
@ -140,7 +140,7 @@ glyph. Posts to a station use that station's glyph.
You can see a list of glyph bindings with `;what`. Write
`;what >` to see what station `>` is bound to, or
`;what /urbit-test` to see if `/urbit-test` has a binding.
`;what /urbit-meta` to see if `/urbit-meta` has a binding.
### Audience selection
@ -157,14 +157,13 @@ Otherwise, the audience is shown in parens:
`:talk` works fairly hard to get the audience right and minimize
manual switching. But to manually set the audience, the command
is simply `;station` - eg, `;~wictuc-folrex` for a direct post;
`/urbit-test` or `~doznec/urbit-test` to post to a federal
`/urbit-meta` or `~doznec/urbit-meta` to post to a federal
station, `%mystation` to post to a station on your own ship.
For a station bound to a glyph, `;` then the glyph; eg, `;>`.
You can post a line and set the audience in one command, eg:
;~wictuc-folrex this is a private message
;~wictuc-folrex this is a private message
You can configure your audience in a number of ways, which are
applied in priority order. From strongest to weakest: