Merge updated git import of Trac content into Markdown.
authorGeoffrey Thomas <geofft@mit.edu>
Mon, 21 Sep 2009 01:56:28 +0000 (21:56 -0400)
committerGeoffrey Thomas <geofft@mit.edu>
Mon, 21 Sep 2009 02:51:01 +0000 (22:51 -0400)
Conflicts:

doc/AFSAndYou
doc/CupsOnMac
doc/SummerReading
doc/UsingZephyr

doc/afs-and-you.html
doc/summer-reading.mdwn
doc/zephyr.mdwn

index 4c7a095234333646f423a5edf8c503564633fb69..2c41b2236248296896442dcec36477bda77db57a 100644 (file)
@@ -206,7 +206,7 @@ Unfortunately, just because you add specific users to an AFS ACL does not mean t
   &lt;/limit&gt;
 </pre></li></ul><ul><li>You can require the reader be (a) specific user(s), for example:
 <pre>  &lt;limit GET&gt;
-  require user fawkes jflorey siptest jarandom
+  require user fawkes jflorey sipbtest jarandom
   &lt;/limit&gt;
 
 </pre></li><li>You can require that the reader be a member of one of certain moira groups (notice these are <strong>moira</strong> groups, there is no "system:". For example:
index 4addf610c3c46b9204e04124e520d7367aaca934..b942577fac6a3021097d71b7015dfc8c74b53330 100644 (file)
@@ -5,6 +5,7 @@
  * [The Kerberos play](http://web.mit.edu/Kerberos/dialogue.html): explains why Kerberos works the way it does
  * [The Rise of Worse is Better](http://www.jwz.org/doc/worse-is-better.html): a brief description of the single coding philosophy that most influenced the design of UNIX and many related systems. The [entire article](http://web.mit.edu/geofft/Public/gabriel-on-lisp.ps), rather than just the section, is available in PostScript
  * Tim Berners-Lee's [Design Issues](http://www.w3.org/DesignIssues/) section, and his piece on why [Cool URIs Don't Change](http://www.w3.org/Provider/Style/URI)
+ * [How To Ask Questions The Smart Way](http://catb.org/esr/faqs/smart-questions.html How To Ask Questions The Smart Way) -- A document on asking questions in hacker communities in ways that will help you get answers. Many of its points apply to places like Zephyr, too.
  * A definition of [yak shaving](http://projects.csail.mit.edu/gsb/old-archive/gsb-archive/gsb2000-02-11.html), which you'll often find SIPB members unwisely engaging in.
  * [GNU Philosophy](http://www.gnu.org/philosophy/philosophy.html), hardline but worth reading.
  * On that note, the [GPLv3](http://www.gnu.org/licenses/gpl.html) and [GPLv2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html). Dense legal style, but also worth reading once, to understand what free software is about
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.