import from lockers.html
authorGreg Price <price@mit.edu>
Thu, 15 Jan 2009 02:01:43 +0000 (21:01 -0500)
committersipb-www <sipb-www@better-mousetrap.mit.edu>
Thu, 15 Jan 2009 02:01:43 +0000 (21:01 -0500)
projects/lockers.mdwn [new file with mode: 0644]

diff --git a/projects/lockers.mdwn b/projects/lockers.mdwn
new file mode 100644 (file)
index 0000000..5c2380c
--- /dev/null
@@ -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.