From dadf59d70d465f0eae53024defeecd28d1d3c1e6 Mon Sep 17 00:00:00 2001
From: Greg Price <price@mit.edu>
Date: Wed, 14 Jan 2009 21:01:43 -0500
Subject: [PATCH] import from lockers.html

---
 projects/lockers.mdwn | 84 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 projects/lockers.mdwn

diff --git a/projects/lockers.mdwn b/projects/lockers.mdwn
new file mode 100644
index 0000000..5c2380c
--- /dev/null
+++ b/projects/lockers.mdwn
@@ -0,0 +1,84 @@
+# Locker Software Maintained by SIPB
+
+SIPB maintains software in a number of Athena lockers. At some point
+we may even list all the lockers and all the software. For now, here
+is an incomplete list of some of the lockers:
+
+
+<dl>
+
+<dt>sipb </dt><dd>The sipb locker is the primary locker for software
+supported by sipb. It contains a wide variety of software.
+
+</dd></dt>outland </dt><dd>The outland locker is the primary locker
+for unsupported SIPB software. It contains software that SIPB members
+think is useful, but which is not suitable for the sipb locker.
+Software may be here because we don't trust it not to break, or
+because we don't want to find updated versions, or because no member
+is willing to take responsibility for it.  Other lockers also
+semi-maintained by sipb include the editors and perlmacs locker. Send
+mail to <tt>bug-outland@</tt> for questions, comments, or more information.
+
+</dd></dt>crypto </dt><dd>Some crypto software, including ssh for older
+platforms and pgp/gpg.
+
+</dd></dt>graphics </dt><dd>Assorted pieces of graphics software. Favorites are
+xv (a viewer) and gimp (an editor). A related locker is 
+the dia locker, which contains a tool for writing diagrams. 
+
+</dd></dt>newtex </dt><dd>Newtex contains an install of tetex which is no longer
+really new. It continues to provide tex and latex packages not
+included with Athena, an older tex/latex (which is sometimes useful)
+and an object lesson about the dangers of naming software "new".
+</dd>
+</dd></dt>php</dt><dd>the PHP.net command-line interface, selected modules, and a
+supporting MySQL client<br>
+Contact: <tt>php@</tt>, <tt>presbrey</tt>
+</dd>
+</dl>
+
+
+## What's in a locker?
+
+There is no really easy way to see what is in a locker. However, most
+programs have man pages, which you can read easily if you know the
+name of the program. To get a list of all the programs in a locker
+that are built for the platform you are logged in on, try the
+following at the Athena prompt. The first line is just to make
+<code>less</code> available.
+
+    athena% add sipb
+    athena% add lockername
+    athena% ls /mit/lockername/bin | less
+<!--
+    athena% add sipb
+    athena% add <i>lockername</i>
+    athena% ls /mit/<i>lockername</i>/bin | less
+-->
+
+This will give you a list of all the programs in that locker built for
+the sort of computer you are using. To see the manpage for a program,
+enter the following:
+
+    athena% man programname
+<!--
+    athena% man <i>programname</i>
+-->
+
+## What locker is <i>foo</i> in?
+
+There is a tool in the outland locker called whichlocker which will
+search all of the Athena lockers we know about and find a particular
+program by name. It works like this:
+
+    athena% add outland
+    athena% whichlocker gimp
+    Locker software on Athena is maintained by many different people.
+    Don't run these programs unless you know the maintainer can be trusted:
+    "gimp" is installed in "graphics" for linux, sgi, and sun4.
+    "gimp" is installed in "gimp-1.2" for linux, sgi, and sun4.
+
+As the disclaimer says, it's important to remember that many different
+people maintain locker software on Athena, and not all of them can be
+trusted to do a good job. Usually its a good idea to know who runs the
+lockers you use.
-- 
2.30.0