1 f305dffb 2003-10-13 devnull This is a port of some Plan 9 libraries and programs to Unix.
3 f305dffb 2003-10-13 devnull Some parts expect that the tree is installed in /usr/local/plan9.
4 f305dffb 2003-10-13 devnull Most are position independent. The few hard-coded references
5 f305dffb 2003-10-13 devnull (there's one in sam) should really be fixed.
7 f305dffb 2003-10-13 devnull * Obtaining the source
9 771ff2bc 2003-10-13 devnull Tarballs will be posted nightly (but only when there are updates!) at
11 f305dffb 2003-10-13 devnull http://pdos.lcs.mit.edu/~rsc/software/plan9
13 f305dffb 2003-10-13 devnull /usr/local/plan9 is the suggested location to keep the software.
14 f305dffb 2003-10-13 devnull All the paths in the tarball begin with plan9/, so it's okay to unpack it
15 f305dffb 2003-10-13 devnull directly in /usr/local.
17 f305dffb 2003-10-13 devnull You can use CVS to obtain the very latest version and stay up-to-date.
18 f305dffb 2003-10-13 devnull See below.
20 f305dffb 2003-10-13 devnull * Building
22 21a17ff3 2003-11-25 devnull To build, cd into src and run make; mk install. This will place binaries
23 21a17ff3 2003-11-25 devnull in "bin". At time of writing, the commands are sam, samterm, rc, and mk.
24 f305dffb 2003-10-13 devnull There are a few shell scripts already included in bin -- B, Bwait,
25 f305dffb 2003-10-13 devnull and samsave.
27 21a17ff3 2003-11-25 devnull The "make" builds mk. Mk builds the rest.
29 f305dffb 2003-10-13 devnull * Helping out
31 f305dffb 2003-10-13 devnull If you'd like to help out, great!
33 f305dffb 2003-10-13 devnull The TODO file contains our (somewhat long) to do list.
35 f305dffb 2003-10-13 devnull If you port this code to other architectures, please share your changes
36 f305dffb 2003-10-13 devnull so others can benefit. See PORTING for some notes.
38 f305dffb 2003-10-13 devnull Please use diff -u or CVS (see below) to prepare patches.
42 f305dffb 2003-10-13 devnull You can use CVS to keep your local copy up-to-date as we make
43 f305dffb 2003-10-13 devnull changes and fix bugs. The idioms explained here are pretty much
44 f305dffb 2003-10-13 devnull all you need to know about CVS.
46 f305dffb 2003-10-13 devnull To check out from the anonymous CVS repository, use
48 f305dffb 2003-10-13 devnull cd /usr/local
49 f305dffb 2003-10-13 devnull >$HOME/.cvspass
50 f305dffb 2003-10-13 devnull cvs -d :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs login
51 f305dffb 2003-10-13 devnull cvs -d :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs checkout plan9
53 f305dffb 2003-10-13 devnull When prompted for a password, just hit enter.
55 f305dffb 2003-10-13 devnull From then on, when you want to update, you can do
57 f305dffb 2003-10-13 devnull cd /usr/local/plan9
58 f305dffb 2003-10-13 devnull cvs update -dAP
60 f305dffb 2003-10-13 devnull If there are conflicts between changes you have made locally
61 f305dffb 2003-10-13 devnull and changes on the server, cvs will warn about them and leave
62 f305dffb 2003-10-13 devnull them clearly marked in the updated files.
64 f305dffb 2003-10-13 devnull If you change something and want to submit the change (please do!),
65 f305dffb 2003-10-13 devnull you can run
67 f305dffb 2003-10-13 devnull cd /usr/local/plan9
68 f305dffb 2003-10-13 devnull cvs diff -u
70 f305dffb 2003-10-13 devnull to generate the diff in a format that will be easy to apply.
71 f305dffb 2003-10-13 devnull (You can also use this to see what you've changed.)
73 f305dffb 2003-10-13 devnull Running the cvs commands in /usr/local/plan9 makes them
74 f305dffb 2003-10-13 devnull apply to the whole tree. Running them in a subdirectory applies
75 f305dffb 2003-10-13 devnull only to the code rooted there in the code.
77 f305dffb 2003-10-13 devnull There's not much magical about /usr/local/plan9. If you
78 f305dffb 2003-10-13 devnull check out the tree in some other directory, it should work
79 f305dffb 2003-10-13 devnull just as well.
83 f305dffb 2003-10-13 devnull Russ Cox <rsc@swtch.com>