cirno/plan9port
1
0
Fork 0
mirror of https://github.com/9fans/plan9port.git synced 2025-01-24 11:41:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

new man page

Browse source
This commit is contained in:
rsc 2005-12-30 19:22:07 +00:00
parent df29f2cef6
commit 2e8a63f0d1
1 changed files with 33 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

51
install.txt
View file

@ -5,17 +5,18 @@
install - notes about Plan 9 from User Space installation install - notes about Plan 9 from User Space installation
SYNOPSIS SYNOPSIS
cd /usr/local/plan9; ./INSTALL cd /usr/local/plan9; ./INSTALL [ -b | -c ]
DESCRIPTION DESCRIPTION
To obtain the Plan 9 tree, use CVS (see cvs(1)) or download To obtain the Plan 9 tree, use CVS (see cvs(1)) or download
a tar file from http://swtch.com/plan9port. a tar file from http://swtch.com/plan9port.
In the root of the tree, run ./INSTALL. This script first The tree can be unpacked anywhere, but the usual place is
uses make(1) to build the Plan 9 build program mk(1) if nec- /usr/local/plan9. In the root of the tree, run ./INSTALL.
essary. It cleans all previously built object files and This script builds the Plan 9 build program mk(1) if neces-
libraries out of the tree, rebuilds and installs everything, sary, cleans all previously built object files and libraries
and then cleans up. out of the tree, rebuilds and installs everything, and then
cleans up.
There are a few files in tree which have the root hard-coded There are a few files in tree which have the root hard-coded
in them. After the build, INSTALL edits these files to in them. After the build, INSTALL edits these files to
@ -25,14 +26,19 @@
Finally, INSTALL builds an HTML version of the manual and Finally, INSTALL builds an HTML version of the manual and
installs it in /usr/local/plan9/man. installs it in /usr/local/plan9/man.
INSTALL can safely be repeated to rebuild the system from The installation can be thought of as two steps: build all
scratch. the binaries, and then edit files as necessary to fix the
references to the installation root. If necessary, these
can be run separately. Given the -b flag, INSTALL performs
only the first step. Given the -c flag, INSTALL performs
only the second step. The first step can be done with the
tree in a temporary work directory, but the second step must
be done once the tree is in its final location. These flags
are only necessary when trying to conform to the expecta-
tions of certain package management systems.
At the end of the build, INSTALL prints suggested settings At the end of the installation, INSTALL prints suggested
for the environment variables $PLAN9 and $PATH. After set- settings for the environment variables $PLAN9 and $PATH.
ting those, the script $PLAN9/dist/isum will print a short
summary of the installation output, omitting the usual com-
mand chatter but preserving compiler warnings and errors.
Plan 9 from User Space uses different threading implementa- Plan 9 from User Space uses different threading implementa-
tions on Linux 2.6 and later kernels than on 2.4 and ear- tions on Linux 2.6 and later kernels than on 2.4 and ear-
@ -45,18 +51,24 @@
On these systems, plan9port must fall back on the threading On these systems, plan9port must fall back on the threading
code intended for Linux 2.4. To accomplish this, INSTALL code intended for Linux 2.4. To accomplish this, INSTALL
checks whether the running system uses NPTL and sets checks whether the running system uses NPTL and sets
Page 1 Plan 9 (printed 12/30/05)
INSTALL(1) INSTALL(1)
SYSVERSION in /usr/local/plan9/config accordingly. The file SYSVERSION in /usr/local/plan9/config accordingly. The file
/usr/local/plan9/LOCAL.config is appended to config after /usr/local/plan9/LOCAL.config is appended to config after
this auto-detection and can be used to override the choices. this auto-detection and can be used to override the choices.
If LOCAL.config contains a line WSYSTYPE=nowsys then the If LOCAL.config contains a line WSYSTYPE=nowsys then the
system is built without using X11. system is built without using X11.
Page 1 Plan 9 (printed 11/28/05) INSTALL can safely be repeated to rebuild the system from
scratch.
INSTALL(1) INSTALL(1)
Once the system is built for the first time, it can be main- Once the system is built for the first time, it can be main-
tained and rebuilt using mk(1). tained and rebuilt using mk(1). To rebuild individual com-
mands or libraries, run mk install and mk clean in the
appropriate source directory (see src(1)).
FILES FILES
/usr/local/plan9/lib/moveplan9.files /usr/local/plan9/lib/moveplan9.files
@ -78,8 +90,11 @@
/usr/local/plan9/install.log /usr/local/plan9/install.log
logged output from the last run of INSTALL logged output from the last run of INSTALL
/usr/local/plan9/install.isum
a summary of install.log
SEE ALSO SEE ALSO
intro(1), cvs(1) intro(1), cvs(1)
Page 2 Plan 9 (printed 11/28/05) Page 2 Plan 9 (printed 12/30/05)