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