From 13cd3c8c0dfc58eec753621139be50fc731b0543 Mon Sep 17 00:00:00 2001 From: "C. Guy Yarvin" Date: Tue, 20 Oct 2015 16:50:53 -0700 Subject: [PATCH] Various fixes and improvements. --- pub/docs/dev.mdy | 2 +- pub/docs/theory/whitepaper.mdy | 24 ++++++++++++------------ pub/docs/user.mdy | 2 +- pub/docs/user/dojo.mdy | 2 +- pub/docs/user/intro.mdy | 2 +- pub/docs/user/talk.mdy | 29 ++++++++++++++--------------- 6 files changed, 30 insertions(+), 31 deletions(-) diff --git a/pub/docs/dev.mdy b/pub/docs/dev.mdy index ad30e924c0..0048e1f792 100644 --- a/pub/docs/dev.mdy +++ b/pub/docs/dev.mdy @@ -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. diff --git a/pub/docs/theory/whitepaper.mdy b/pub/docs/theory/whitepaper.mdy index 154ab182f7..2fd7b44b9f 100644 --- a/pub/docs/theory/whitepaper.mdy +++ b/pub/docs/theory/whitepaper.mdy @@ -6,7 +6,7 @@ sort: 0 Urbit: an operating function ============================ -
This is Urbit whitepaper DRAFT 41K. Some small details +
This is Urbit whitepaper DRAFT 40K. Some small details remain at variance with the codebase.
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 diff --git a/pub/docs/user.mdy b/pub/docs/user.mdy index e4d089ae93..930c6bb9b1 100644 --- a/pub/docs/user.mdy +++ b/pub/docs/user.mdy @@ -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. diff --git a/pub/docs/user/dojo.mdy b/pub/docs/user/dojo.mdy index b497a6c1f5..8961885a51 100644 --- a/pub/docs/user/dojo.mdy +++ b/pub/docs/user/dojo.mdy @@ -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]` diff --git a/pub/docs/user/intro.mdy b/pub/docs/user/intro.mdy index ced46bf513..7bad0a793c 100644 --- a/pub/docs/user/intro.mdy +++ b/pub/docs/user/intro.mdy @@ -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. diff --git a/pub/docs/user/talk.mdy b/pub/docs/user/talk.mdy index f4179699ec..e120e28939 100644 --- a/pub/docs/user/talk.mdy +++ b/pub/docs/user/talk.mdy @@ -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: