]> sipb.mit.edu Git - wiki.git/blobdiff - doc/UsingZephyr
Edited the Debian ssh instructions.
[wiki.git] / doc / UsingZephyr
index 313fae71420a3e74c0850122363c13fa18c4333b..c9ebaac5c22d24f028f2e75d077b7c10011a5a01 100644 (file)
@@ -26,11 +26,13 @@ Using Barnowl is recommended, as it is better supported and more documentation e
 
 === 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, at 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}}} (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.
 
 The simplest use of Zephyr is to send personal zephyrs to other users. To send a zephyr, type : to bring up a command line, and run the command {{{zwrite USERNAME}}}. You can also start a {{{zwrite}}} command 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.
+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 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}}} to undelete it, and {{{x}}} to expunge all messages that have been marked as deleted.
 
@@ -94,6 +96,18 @@ If you spend enough time on Zephyr, you'll begin noticing some strange phrases a
 
 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).  Common abbreviations that you might find on AIM, however, are not.  People tend to look down upon "lol", "rofl", and other overly-used abbreviations.
+
+Don't sub randomly to someone's class who you just met on zephyr.  It is usually considered good form to wait until you've met the person in real life, or at least have had lengthy conversations with them in personals.
+
 === Startup ===
 
 There might be some options that you want to be consistent from session to session; you don't want to have to set the same variables each time.  You can fix this by adding the commands to your "startup" file, for example, {{{.owl/startup}}}.  This can be done from within Barnowl, by using the {{{startup}}} command:
@@ -118,14 +132,16 @@ And to log personals:
 :set logging on
 }}}
 
-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
+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 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 ===
 
@@ -200,6 +216,10 @@ kinit -l1d -r7d -54
 
 To detach a screen session (for example, if you want to log out), press C-a d (Control-A, then D).  Screen continues to run, but is no longer active.
 
-To reattach a screen session, possibly detaching from wherever it's currently attached, run {{{screen -dr}}}.
+To reattach a screen session, possibly detaching from wherever it's currently attached, run:
+
+{{{
+screen -dr
+}}}
 
 {{{screen}}} can do a whole lot more.   To find out about it, see UsingScreen.
\ No newline at end of file