Upstream prefers BarnOwl to Barnowl
authorAnders Kaseorg <andersk@mit.edu>
Wed, 28 Aug 2013 22:25:01 +0000 (18:25 -0400)
committerAnders Kaseorg <andersk@mit.edu>
Wed, 28 Aug 2013 22:28:14 +0000 (18:28 -0400)
Signed-off-by: Anders Kaseorg <andersk@mit.edu>
doc.mdwn
doc/barnowl_random_zsigs.mdwn
doc/szs.mdwn
doc/traditional-zephyr.mdwn
doc/zephyr.mdwn
hackathons/great-hacksby/projects.mdwn
office/zephyrClasses.mdwn
projects/ideas.mdwn

index e7dd6becc22e4bbf591e9e330fd507582cda807e..53e78bcf1092079b0a9ef57bf3b3968be5403974 100644 (file)
--- a/doc.mdwn
+++ b/doc.mdwn
@@ -23,7 +23,7 @@ Some tips for using Moira
 ### Zephyr
 
 * [[Using Zephyr|doc/zephyr]] <br />
-A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, and a pretty good reference.  See also [the Barnowl wiki](http://barnowl.mit.edu/).
+A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, and a pretty good reference.  See also [the BarnOwl wiki](http://barnowl.mit.edu/).
 
 * [[Using SZS (the SMS to Zephyr Relay)|doc/szs]] <br />
 Send and receive text messages through Zephyr.
@@ -94,7 +94,7 @@ A very helpful guide to LaTeX, a typesetting program commonly used for doing PSe
 A guide to using MATLAB on Athena.
 
 * [Inessential Zephyr](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/html/izephyr.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/izephyr.dvi))([PDF](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/izephyr.pdf)) <br />
-A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use Barnowl, try [this](http://sipb-www.scripts.mit.edu/doc/wiki/UsingZephyr) instead
+A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use BarnOwl, try [this](http://sipb-www.scripts.mit.edu/doc/wiki/UsingZephyr) instead
 
 * [Inessential Bitmaps](http://stuff.mit.edu/afs/sipb.mit.edu/project/doc/ibitmap/ibitmap.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/ibitmap.dvi)) <br />
 A guide to drawing and displaying XBM bitmaps and other graphics.
index 012493dc966598b0c99eaa42b32543b883f27177..e2f243c6da2dc8f95dc3ae56c2a8c0946b329a3a 100644 (file)
@@ -1,15 +1,15 @@
-[[!meta title="Random Zsigs for Barnowl"]]
+[[!meta title="Random Zsigs for BarnOwl"]]
 
-## Random Zsigs for Barnowl
+## Random Zsigs for BarnOwl
 
 Note: There's a lot of background information in here which can be bypassed.
 
-First off, if you haven't already, take a look at Barnowl's internal documentation. Try the following two commands.
+First off, if you haven't already, take a look at BarnOwl's internal documentation. Try the following two commands.
        
        :help
        :show quickstart
        
-(Also viewable outside of Barnowl, in the form of messier-to-read source code, at [/help.c - barnowl - Trac](http://barnowl.mit.edu/browser/help.c) and the "intro" file at [/docs/intro.txt - barnowl - Trac](http://barnowl.mit.edu/browser/doc/intro.txt),
+(Also viewable outside of BarnOwl, in the form of messier-to-read source code, at [/help.c - BarnOwl - Trac](http://barnowl.mit.edu/browser/help.c) and the "intro" file at [/docs/intro.txt - BarnOwl - Trac](http://barnowl.mit.edu/browser/doc/intro.txt),
 
 ### Intro to Zsigs
 A "zsig" appears after your username (your Athena account name) in Zephyr (see [[Using Zephyr (a.k.a. Zephyr for Dummies)|doc/zephyr]] if you don't know what Zephyr is).
@@ -19,20 +19,20 @@ By default, if your name is Jane Lillian Doe, your zsig is `(Jane L Doe)`. For i
        2013 / personal / jdoe  22:16  (Jane L Doe)
                ...hey I'm talking here.
                
-Most people keep it that way, since people may not immediately know who you are by your username. Some people opt to remove the middle initial or leave it at an interesting quote. To do so, in Barnowl simply type in
+Most people keep it that way, since people may not immediately know who you are by your username. Some people opt to remove the middle initial or leave it at an interesting quote. To do so, in BarnOwl simply type in
 
        :set zsig  "This is a very interestin' quote."
        
-(Barnowl accepts either single or double quotes to enclose your zsig, allowing you to use the other type of quote inside your zsig. Experiment, Barnowl tells you what it interpreted your command as by showing as confirmation
+(BarnOwl accepts either single or double quotes to enclose your zsig, allowing you to use the other type of quote inside your zsig. Experiment, BarnOwl tells you what it interpreted your command as by showing as confirmation
 
        zsig = 'This is a very interestin' quote.'      
 
 ### Random Zsig Generator
 But what if you want to set up a random zsig generator?
 
-In outline, we use some bash magic that prints a zsig out to `stdout`, then set up Barnowl to run that bit of bash magic. Barnowl has something already which will automagically take that `stdout` and pipe it into your zsig.
+In outline, we use some bash magic that prints a zsig out to `stdout`, then set up BarnOwl to run that bit of bash magic. BarnOwl has something already which will automagically take that `stdout` and pipe it into your zsig.
 
-#### Steps Outside of Barnowl: Creating the zsigs file
+#### Steps Outside of BarnOwl: Creating the zsigs file
 Connect to Athena if you haven't already.
 
 1. Create a file of zsigs. In this article we'll call the file `.zsigs`
@@ -50,13 +50,13 @@ Connect to Athena if you haven't already.
        
        The second line should be one of the zsigs from your list. Run it multiple times if you want to check for randomness.
 
-#### Setting Up Barnowl: Using the zsigproc variable
+#### Setting Up BarnOwl: Using the zsigproc variable
 ##### Background
-Open up Barnowl now.
+Open up BarnOwl now.
        
        kusername@dr-wily:~$ add barnowl; barnowl
 
-Using the command `:show variables` inside of Barnowl we see descriptions of the variables of interest to us:
+Using the command `:show variables` inside of BarnOwl we see descriptions of the variables of interest to us:
        
        zsig - zephyr signature (default: '')
        zsigproc - name of a program to run that will generate zsigs (default: '<null>')     
@@ -72,12 +72,12 @@ We will also use the `:startup` command, which is described in
        
 ##### The Steps
 
-1. Use the `:startup` command in Barnowl to write to the "~/.owl/startup" file (or wherever you decided to put the your startup settings file for Barnowl). (Alternatively, edit the "~/.owl/startup" file directly). As mentioned in the detailed documentation, the variable `zsig` takes precedence over `zsigproc`. Make sure that `zsig` is empty. Then set `zsigproc` to run our bit of bash magic.
+1. Use the `:startup` command in BarnOwl to write to the "~/.owl/startup" file (or wherever you decided to put the your startup settings file for BarnOwl). (Alternatively, edit the "~/.owl/startup" file directly). As mentioned in the detailed documentation, the variable `zsig` takes precedence over `zsigproc`. Make sure that `zsig` is empty. Then set `zsigproc` to run our bit of bash magic.
 
                :startup set zsig ''
                :startup set zsigproc 'shuf -n1 ~/.zsigs'
        
-2. Force Barnowl to reload the startup configuration file
+2. Force BarnOwl to reload the startup configuration file
 
                :source "~/.owl/startup"
                
index fb88cb891d8802be173b66e5b68f88e6bfea355f..c76367f5d864e1f934bfa08c11a553332fc9673e 100644 (file)
@@ -6,7 +6,7 @@ This service relays messages between [Zephyr](http://sipb.mit.edu/doc/zephyr/) a
 
 ## Zephyr to SMS
 
-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.mit.edu` 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.mit.edu` with a class of `szs` and an instance of `1234567890@servicemail.foo`; for instance, in BarnOwl, 
 
        ----> zwrite daemon/webzephyr.mit.edu -c szs -i 1234567890@servicemail.foo
        Hi imaginary friend, how are you doing? I'm sending you a text message through Zephyr.
@@ -19,7 +19,7 @@ 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.
 
-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).
+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).
 
 ### Personals
 When sending a zephyr from a phone, simply text a message to `kusername@szs.mit.edu` where `kusername` is the person's Athena username.
@@ -47,7 +47,7 @@ Your message will appear like this:
               Zephyr replies to daemon/webzephyr.mit.edu -c szs -i 1234567890@servicemail.foo )
 
 ### Filtering
-As it turns out, for the same reasons that make replying to text messages such a pain, messages sent to Zephyr will appear in your personals (and can be viewed in Barnowl with the shortcut `[Alt-p]`) but messages you send in reply will not show up. This can make it annoying to carry on a conversation. To get text messages sent through Zephyr to show up in your personals (in Barnowl), you can edit your personal filter. To get your changes to persist across Barnowl sessions, you should directly edit your startup configuration file. This, by default, is the `startup` file in the `~/.owl` folder (where "~" stands for your home folder, so the full path should be something like `/mit/kusername/.owl/startup`). 
+As it turns out, for the same reasons that make replying to text messages such a pain, messages sent to Zephyr will appear in your personals (and can be viewed in BarnOwl with the shortcut `[Alt-p]`) but messages you send in reply will not show up. This can make it annoying to carry on a conversation. To get text messages sent through Zephyr to show up in your personals (in BarnOwl), you can edit your personal filter. To get your changes to persist across BarnOwl sessions, you should directly edit your startup configuration file. This, by default, is the `startup` file in the `~/.owl` folder (where "~" stands for your home folder, so the full path should be something like `/mit/kusername/.owl/startup`). 
 
 So open up the "startup" file in your favorite text editor. If you're not sure which, try double-clicking the "startup" file, which should open it up in `gedit`. Or, if you're in a dialup ssh session, try `nano`.
 
@@ -55,7 +55,7 @@ So open up the "startup" file in your favorite text editor. If you're not sure w
 
 Now find the line that starts with `filter personal` and edit it.
 
-Barnowl is picky about formatting, so here are some examples.
+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$ ) ) )
@@ -70,13 +70,13 @@ If you ever need to revert your personal filter, the default is:
 
        isprivate ^true$ and ( not type ^zephyr$ or ( class ^message ) )
 
-Now to reload your Barnowl configuration, in Barnowl, run
+Now to reload your BarnOwl configuration, in BarnOwl, run
 
        :source ~/.owl/startup
 
-Therefore you could have multiple startup files if you wish. However, do note that if you don't specify (overwrite) a filter in `startup2`, it will remain in its `startup` state. In other words, there is no original Barnowl filter configuration that your filters will revert to.
+Therefore you could have multiple startup files if you wish. However, do note that if you don't specify (overwrite) a filter in `startup2`, it will remain in its `startup` state. In other words, there is no original BarnOwl filter configuration that your filters will revert to.
 
 ### 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. 
+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 [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`.
+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`.
index 244868329312a9e1c4c560a51c4a814d5741e2ac..ca740debeaaab9e3eae51d628dd5a33d1dcc7a74 100644 (file)
@@ -1,6 +1,6 @@
 [[!meta title="Traditional Zephyr (archaic)"]]
 
-For information on using Barnowl, see [[Using Zephyr|doc/zephyr]].
+For information on using BarnOwl, see [[Using Zephyr|doc/zephyr]].
 
 When you log into Athena, you may occasionally see a white box pop up
 with text on it.  This is Zephyr in its traditional form.
index b083a5d75e4e700cc52cd3717b00ed422baa0967..47a3d394f02741b24230b18014a7dec0cb5da64d 100644 (file)
@@ -17,13 +17,13 @@ Zephyr is an underlying chat system; the built-in tools for exchanging messages
 
 Here are some of the primary clients used at MIT. There's also a listing of [other Zephyr clients](http://zephyr.1ts.org/wiki/ZephyrClients), but their use is generally not recommended.
 
-### Barnowl
+### BarnOwl
 
-[Barnowl](http://barnowl.mit.edu/) is a command-line Zephyr client that supports advanced filtering and customisation. It is probably the most commonly used client, but requires some effort to get started. To use Barnowl effectively, you should connect to an [Athena dialup](http://web.mit.edu/dialup/www/ssh.html) and run Barnowl along with a program to renew your Kerberos tickets. The Athena command `athrun sipb owl-screen` will set this up for you.
+[BarnOwl](http://barnowl.mit.edu/) is a command-line Zephyr client that supports advanced filtering and customisation. It is probably the most commonly used client, but requires some effort to get started. To use BarnOwl effectively, you should connect to an [Athena dialup](http://web.mit.edu/dialup/www/ssh.html) and run BarnOwl along with a program to renew your Kerberos tickets. The Athena command `athrun sipb owl-screen` will set this up for you.
 
-In addition to primarily supporting Zephyr, Barnowl also lets you connect to [AIM](http://aim.com) and and [XMPP](http://xmpp.org/) (Google Talk, Facebook, etc.) networks.
+In addition to primarily supporting Zephyr, BarnOwl also lets you connect to [AIM](http://aim.com) and and [XMPP](http://xmpp.org/) (Google Talk, Facebook, etc.) networks.
 
-See [Getting Started with Barnowl](http://barnowl.mit.edu/wiki/GettingStarted) for more information.
+See [Getting Started with BarnOwl](http://barnowl.mit.edu/wiki/GettingStarted) for more information.
 
 ### Roost
 
index fce883dbc2f7f0bb168f2b490551c7cff4ee51f5..a96e19e30e213bceb04b9157dfaa69be5da51417 100644 (file)
@@ -1,4 +1,4 @@
-There are a lot of projects: Scripts, Barnowl, Straversity, smiopp and cyclist all have different things to work on. Skim through, see what catches your fancy.
+There are a lot of projects: Scripts, BarnOwl, Straversity, smiopp and cyclist all have different things to work on. Skim through, see what catches your fancy.
 
 [Scripts](http://scripts.mit.edu)
 =================================
index 2c5861b9303a99d849ff25f579e7a33a0ea15220..1209c7b6bd0488135f0e3ef7d20d22890217cb16 100644 (file)
@@ -34,7 +34,7 @@ you're interested in helping with a specific project.
 with [Scripts](http://scripts.mit.edu/), subscribe here to see what
 the Scripts team does behind the scenes. *High traffic.*
 
-* **&lt;barnowl,\*,\*&gt;** &mdash; Discussion of [Barnowl](http://barnowl.mit.edu/), a zephyr client written and maintained by SIPB members.
+* **&lt;barnowl,\*,\*&gt;** &mdash; Discussion of [BarnOwl](http://barnowl.mit.edu/), a zephyr client written and maintained by SIPB members.
 
 * **&lt;debathena,\*,\*&gt;** &mdash; Discussion of [Debathena](http://debathena.mit.edu/), a project designed to bring the functionality of Athena to your Debian or Ubuntu system. Debathena is also the basis of the next official version of Athena. *High traffic.*
 
index 019ac4b5ed5b1b978e98a7532f3e7fe674140ad7..b2d29ae6e341113110158dab77a9d12e23bac7ed 100644 (file)
@@ -167,7 +167,7 @@ Currently, it is a pain to get someone else set up using zephyr
 within screen on Linerva with automatically-renewing tickets.
 We should write scripts to set them up so that that all they
 have to do is enter a command or click an icon, type their kerberos
-password, and then know how to use Barnowl.
+password, and then know how to use BarnOwl.
 
 _Contact: afarrell_
 
@@ -200,7 +200,7 @@ _Contact: xavid_
 
 ## A zephyr log viewer
 
-Many SIPB-affiliated people use the [Zephyr](http://zephyr.1ts.org/) messaging system, and the [Barnowl](http://barnowl.mit.edu/) client for it in particular. Barnowl has a number of very nice features that make it easy to follow large amounts of zephyr traffic: search, color coding, auto-narrowing, etc. Barnowl can also store logs of zephyrs sent and received for future reference, but the logs are saved separated by class in a way that's quite annoying to navigate sometimes. A Barnowl-like interface (perhaps implemented as a Barnowl plugin) for viewing zephyr logs would be a great thing to have.
+Many SIPB-affiliated people use the [Zephyr](http://zephyr.1ts.org/) messaging system, and the [BarnOwl](http://barnowl.mit.edu/) client for it in particular. BarnOwl has a number of very nice features that make it easy to follow large amounts of zephyr traffic: search, color coding, auto-narrowing, etc. BarnOwl can also store logs of zephyrs sent and received for future reference, but the logs are saved separated by class in a way that's quite annoying to navigate sometimes. A BarnOwl-like interface (perhaps implemented as a BarnOwl plugin) for viewing zephyr logs would be a great thing to have.
 
 _Contact: oremanj_