Merge updated git import of Trac content into Markdown.
[wiki.git] / doc / zephyr.mdwn
index 21e4cbb4dbed2f5a8aefaf0b6e37750666e59a71..1dbadb9f39ef7d7ca835e81805a0eb46239754c7 100644 (file)
@@ -50,6 +50,25 @@ Using Barnowl is recommended, as it is better supported and more
 documentation exists for it.
 
 ### Using Barnowl
+You will need access to an Athena machine to run barnowl.  The easiest
+way to do this would be to SSH into linerva.mit.edu.
+
+On a Debian-based linux distro, open up a terminal and type `ssh
+<username>@linerva.mit.edu`.
+
+On Windows, download a SSH client (such as
+[PuTTY](http://chiark.greenend.org.uk/~sgtatham/putty/download.html))
+and install it.  Once you've opened it, type `<username>@linerva.mit.edu`
+into the prompt and hit enter.
+
+On a Mac, open Terminal from the Utilities Folder in Applications. Type
+`kinit <username>@ATHENA.MIT.EDU && ssh -K
+<username>@linerva.mit.edu` If this command fails (saying -K is
+invalid), then just do `ssh <username>@linerva.mit.edu`.
+
+(In all these cases, don't include the angle brackets, just replace
+<username> with your MIT username).  You will then be prompted for your
+password.  Enter it, and then carry on with running barnowl!
 
 To start barnowl, run the command `add barnowl; barnowl` at the prompt
 on any Athena machine or dialup, such as linerva.mit.edu.
@@ -61,8 +80,10 @@ by simply typing z.
 
 You can then enter your message, and then enter a `.` on a line by
 itself to finish the zephyr. By convention, zephyrs are usually
-word-wrapped to 70-character lines or so; Pressing M-q (Alt-q, or
-Escape then q) will word-wrap the text you've entered for you.
+word-wrapped to 70 characters or so per line; barnowl will wrap at about
+10 characters less than the width of your terminal window, so if you
+have a large window, you may need to press M-q (Alt-q, or Escape then q)
+to word-wrap the current paragraph to a smaller width.
 
 Once you've sent and received zephyrs, you can navigate the message
 list with the arrow keys. Press `d` to mark a message as deleted, `u`
@@ -129,16 +150,6 @@ Some common classes include:
 > report what one is working on or up to, or ask friends questions, or
 > just rant about something.
 
-<strong>"un" Classes</strong>:
-> Many people use "un" classes in addition to their personal class,
-> for example `johndoe` might use `-c unjohndoe`.  Sometimes there are
-> nested un-classes as well, such as `-c ununjohndoe` or `-c
-> unununjohndoe`.  It is extremely rare to see anything more than
-> three "un"s.  Un-classes are generally used for snarking about a
-> conversation going on in the next class up (`-c unjohndoe` snarking
-> about `-c johndoe`), or for more intense ranting.  The more "un"s,
-> the more intense the snarking/ranting generally becomes.
-
 ### Zephyr Slang
 
 If you spend enough time on Zephyr, you'll begin noticing some strange
@@ -176,6 +187,31 @@ There are many other acronyms that are used; if you don't know what it
 means, try using the `whats foo` command at an Athena terminal. If you
 don't have the command, run `add sipb` first.
 
+### Zephyr Etiquette
+
+There are rules that people tend to use on Zephyr.  These include:
+
+Good grammar, spelling, and punctuation.  Not everybody uses
+capitalization, but they will still use good English.  Please do not say
+things such as "hey wut r u up to???".  It makes you look like an idiot.
+Really.
+
+You don't need multiple question marks or exclamation points.  Usually.
+
+There are a few abbreviations people use, such as YMMV (Your Mileage May
+Vary) or IIRC (If I Remember Correctly), as well as some nerdier ones
+like DTRT (Do The Right Thing, in reference to
+[http://www.jwz.org/doc/worse-is-better.html The Rise of "Worse Is
+Better"]).  Try running `add outland; whats dtrt` to look up an
+abbreviation.  Common abbreviations that you might find on AIM, however,
+are not often used.  People tend to look down upon "lol", "rofl", and
+such.
+
+Personal classes are by convention considered a little more private than
+non-personal (public) classes. Although most people don't mind people
+they've met subscribing to their personal class and lurking, it's poor
+form to talk loudly on the personal class of someone you don't know.
+
 ### Startup
 
 There might be some options that you want to be consistent from
@@ -203,12 +239,14 @@ And to log personals:
 
 This will log to the "zlog" directory in your locker. You probably
 don't want people to see what classes you're on or what people you
-talk to, so you can run the Athena command
+talk to, so you can run the Athena commands
 
     mkdir -p ~/zlog
     fs sa ~/zlog system:anyuser none
+    mkdir -p ~/zlog/people
+    mkdir -p ~/zlog/class
 
-to make this directory completely hidden.
+to create the necessary directories and make them completely hidden.
 
 ### Colors
 
@@ -317,3 +355,19 @@ currently attached, run:
 
 `screen` can do a whole lot more.  To find out about it, see
 [UsingScreen](https://sipb-www.scripts.mit.edu:444/doc/wiki/UsingScreen).
+
+### Interaction with Traditional Zephyr
+
+The default athena startup scripts launch zwgc on login. If you are
+subscribed to many classes and use Zephyr as many do today, zwgc's
+behavior is not very desirable. To disable zwgc startup, add:
+
+    setenv ZEPHYR_CLIENT false
+
+to your `~/.environment` file if you use `tcsh` or
+
+    ZEPHYR_CLIENT=false
+
+to your `~/.bash_environment` if you use `bash`. This will cause your
+shell to launch the `false` executable instead of zwgc which does
+nothing.