summer-reading: another phrasing tweak
[wiki.git] / doc / szs.mdwn
index 9cba19d1f4596b83612bbb98f6660ba3ac4f05b6..9f9adc66f1c5e004f465e6b9e69aba60a8206c43 100644 (file)
@@ -1,23 +1,23 @@
-[[!meta title="Using SZS (the SMS to zephyr relay)"]]
+[[!meta title="Using SZS (the SMS to Zephyr Relay)"]]
 
 ## Introduction to SZS, the SMS to Zephyr Relay
 
-This service relays messages between Zephyr and phones (which use SMS). In other words, you can send and receive text messages in Zephyr.
+This service relays messages between [Zephyr](http://sipb.mit.edu/doc/zephyr/) and phones (which use SMS). In other words, you can send and receive text messages in Zephyr. For the short but slightly obsolete version of this documentation, see [http://webzephyr.mit.edu/szs.html](http://webzephyr.mit.edu/szs.html).
 
 ## Zephyr to SMS
 
-To send zephyrs to a phone address as an Athena user, use your favorite zephyr client to zwrite daemon.webzephyr with a class of `szs` and an instance of `1234567890@servicemail.foo`; for instance, in Barnowl, 
+To send zephyrs to a phone address as an Athena user, use your favorite zephyr client (see [Using Zephyr](http://sipb.mit.edu/doc/zephyr/) if you're not sure what this means) to zwrite `daemon.webzephyr` with a class of `szs` and an instance of `1234567890@servicemail.foo`; for instance, in Barnowl, 
 
        ----> zwrite daemon.webzephyr -c szs -i 1234567890@servicemail.foo
        Hi imaginary friend, how are you doing? I'm sending you a text message through Zephyr.
 
-where you replace `1234567890@servicemail.foo` with the email address of the person you wish to reach (you can look up the email address for a given cellular provider online). Additionally, if you're not sure what cellular provider your friend has, there are online services where you can look up the number and determine the carrier.
+where you replace `1234567890@servicemail.foo` with the email address of the person you wish to reach (you can look up the email address for a given cellular provider online. See ). Additionally, if you're not sure what cellular provider your friend has, there are online services where you can look up the number and determine the carrier. For instance, try [http://www.whitepages.com/carrier_lookup](Free Cell Phone Carrier Lookup | Whitepages.com) (just enter in the "Mobile #" field, the "Name" and "Select Your Carrier" are unnecessary). 
 
 ## SMS to Zephyr
 ### Notes
 Do note that your message **will be accompanied by your phone number**!
 
-Messages over 140 chars will get cut off between the phone and Zephyr. The cell phone user will get an `invalidpducontent` error, although the first part of his/her message will get through to Zephyr. On the other hand, messages *from* Zephyr to cellphones can be as long as you like.
+Messages over 140 chars will get **cut off** between the phone and Zephyr. The cell phone user will get an `invalidpducontent` error, although the first part of his/her message will get through to Zephyr. On the other hand, messages *from* Zephyr to cellphones can be as long as you like.
 
 Also, hitting "`r`" in Barnowl to reply to a zephyrgram someone sent as a text message **does not work**. You'll have to hit `[Ctrl-R]` and typing out your friend's email address. (Afterward, you can scroll back to the last one you sent to your friend and hit "`r`", which will work).
 
@@ -58,17 +58,17 @@ Now find the line that starts with `filter personal` and edit it.
 Barnowl is picky about formatting, so here are some examples.
 This includes all your SMS <-> Zephyr messages in your personals and also colors your personal messages green.
 
-       filter personal -c green ( class ^szs$ ) or ( isprivate ^true$ and ( not type ^zephyr$ or ( class ^message$ ) ) ) or ( class kusername ) or ( type admin )
+       filter personal -c green ( class ^szs$ ) or ( isprivate ^true$ and ( not type ^zephyr$ or ( class ^message$ ) ) )
 
 To color all your SMS <-> Zephyr messages separately from your other personals messages, add another line that will override the coloring you gave it under the personal filter:
 
        filter szs -c cyan ( class ^szs$ ) or ( sender daemon.webzephyr@ATHENA.MIT.EDU )
 
-So you'll have general personals in one color, and SMS <-> Zephyr messages in a separate color, both of which appear when you hit '[Alt-p]'.
+So you'll have general personals in one color, and SMS <-> Zephyr messages in a separate color, both of which appear when you hit `[Alt-p]`.
 
 If you ever need to revert your personal filter, the default is:
 
-       isprivate ^true$ and (  not type ^zephyr$ or ( class ^message ) )
+       isprivate ^true$ and ( not type ^zephyr$ or ( class ^message ) )
 
 Now to reload your Barnowl configuration, in Barnowl, run
 
@@ -79,4 +79,4 @@ Therefore you could have multiple startup files if you wish. However, do note th
 ### Screen
 If you are going to regularly send and receive text messages using the Barnowl client for Zephyr, you will probably want a Barnowl instance running 24/7 so that whoever texts you won't encounter a `user not subscribed` error and so that your text message conversations don't disappear each time you quit Barnowl. 
 
-A good way to do this is to use screen and run it on the SIPB dialup machine, which allows you to run a Barnowl session within screen on the SIPB dialup machine that's theoretically up 24/7 (sadly outages do occur). See [UsingScreen](http://sipb-www.scripts.mit.edu/doc/wiki/UsingScreen) for more information; the basic idea is to `ssh` to `kusername@linux.mit.edu` and run `add kchen; owl-screen`, and in the future after `ssh`-ing to `kusername@linux.mit.edu` run 'screen -dr'.
+A good way to do this is to use screen and run it on the SIPB dialup machine, which allows you to run a Barnowl session within screen on the SIPB dialup machine that's theoretically up 24/7 (sadly outages do occur). See [Using Screen](http://sipb-www.scripts.mit.edu/doc/wiki/UsingScreen) for more information; the basic idea is to `ssh` to `kusername@linux.mit.edu` and run `add kchen; owl-screen`, and in the future after `ssh`-ing to `kusername@linux.mit.edu` run `screen -dr`.