Fixed bullet points
[wiki.git] / projects / lockers.mdwn
1 [[!meta title="Locker Software Maintained by SIPB"]]
2
3 SIPB maintains software in a number of Athena lockers. At some point
4 we may even list all the lockers and all the software. For now, here
5 is an incomplete list of some of the lockers:
6
7
8 <dl>
9
10 <dt>sipb </dt><dd>The sipb locker is the primary locker for software
11 supported by sipb. It contains a wide variety of software.
12
13 </dd></dt>outland </dt><dd>The outland locker is the primary locker
14 for unsupported SIPB software. It contains software that SIPB members
15 think is useful, but which is not suitable for the sipb locker.
16 Software may be here because we don't trust it not to break, or
17 because we don't want to find updated versions, or because no member
18 is willing to take responsibility for it.  Other lockers also
19 semi-maintained by sipb include the editors and perlmacs locker. Send
20 mail to <tt>bug-outland@</tt> for questions, comments, or more information.
21
22 </dd></dt>crypto </dt><dd>Some crypto software, including ssh for older
23 platforms and pgp/gpg.
24
25 </dd></dt>graphics </dt><dd>Assorted pieces of graphics software. Favorites are
26 xv (a viewer) and gimp (an editor). A related locker is 
27 the dia locker, which contains a tool for writing diagrams. 
28
29 </dd></dt>newtex </dt><dd>Newtex contains an install of tetex which is no longer
30 really new. It continues to provide tex and latex packages not
31 included with Athena, an older tex/latex (which is sometimes useful)
32 and an object lesson about the dangers of naming software "new".
33 </dd>
34 </dd></dt>php</dt><dd>the PHP.net command-line interface, selected modules, and a
35 supporting MySQL client<br>
36 Contact: <tt>php@</tt>, <tt>presbrey</tt>
37 </dd>
38 </dl>
39
40
41 ## What's in a locker?
42
43 There is no really easy way to see what is in a locker. However, most
44 programs have man pages, which you can read easily if you know the
45 name of the program. To get a list of all the programs in a locker
46 that are built for the platform you are logged in on, try the
47 following at the Athena prompt. The first line is just to make
48 <code>less</code> available.
49
50     athena% add sipb
51     athena% add lockername
52     athena% ls /mit/lockername/bin | less
53 <!--
54     athena% add sipb
55     athena% add <i>lockername</i>
56     athena% ls /mit/<i>lockername</i>/bin | less
57 -->
58
59 This will give you a list of all the programs in that locker built for
60 the sort of computer you are using. To see the manpage for a program,
61 enter the following:
62
63     athena% man programname
64 <!--
65     athena% man <i>programname</i>
66 -->
67
68 ## What locker is <i>foo</i> in?
69
70 There is a tool in the outland locker called whichlocker which will
71 search all of the Athena lockers we know about and find a particular
72 program by name. It works like this:
73
74     athena% add outland
75     athena% whichlocker gimp
76     Locker software on Athena is maintained by many different people.
77     Don't run these programs unless you know the maintainer can be trusted:
78     "gimp" is installed in "graphics" for linux, sgi, and sun4.
79     "gimp" is installed in "gimp-1.2" for linux, sgi, and sun4.
80
81 As the disclaimer says, it's important to remember that many different
82 people maintain locker software on Athena, and not all of them can be
83 trusted to do a good job. Usually its a good idea to know who runs the
84 lockers you use.