1 4ef9ff62 2005-01-14 devnull .TH INSTALL 1
3 4ef9ff62 2005-01-14 devnull install \- notes about Plan 9 from User Space installation
4 4ef9ff62 2005-01-14 devnull .SH SYNOPSIS
6 4ef9ff62 2005-01-14 devnull cd \*9; ./INSTALL
15 4ef9ff62 2005-01-14 devnull .SH DESCRIPTION
16 08e79372 2014-11-17 rsc To obtain the Plan 9 tree, use Git
18 d32deab1 2020-08-16 rsc .MR git (1) )
19 4ef9ff62 2005-01-14 devnull or download a tar file from
20 a3993885 2017-09-01 rsc .HR https://9fans.github.io/plan9port "" .
22 af79ebc2 2005-12-30 devnull The tree can be unpacked anywhere, but the
23 af79ebc2 2005-12-30 devnull usual place is
24 af79ebc2 2005-12-30 devnull .BR /usr/local/plan9 .
25 4ef9ff62 2005-01-14 devnull In the root of the tree, run
26 4ef9ff62 2005-01-14 devnull .BR ./INSTALL .
27 af79ebc2 2005-12-30 devnull This script builds the Plan 9 build program
29 af79ebc2 2005-12-30 devnull if necessary,
30 af79ebc2 2005-12-30 devnull cleans all previously built object files and libraries out of the tree,
31 4ef9ff62 2005-01-14 devnull rebuilds and installs everything, and then cleans up.
33 4ef9ff62 2005-01-14 devnull There are a few files in tree which have the root
34 4ef9ff62 2005-01-14 devnull hard-coded in them.
35 cb8f7357 2020-01-20 rsc After the build,
36 4ef9ff62 2005-01-14 devnull .I INSTALL
37 4ef9ff62 2005-01-14 devnull edits these files to replace the string
38 4ef9ff62 2005-01-14 devnull .B /usr/local/plan9
39 4ef9ff62 2005-01-14 devnull with the name of the root of the current tree.
42 4ef9ff62 2005-01-14 devnull .I INSTALL
43 4ef9ff62 2005-01-14 devnull builds an HTML version of the manual and installs it in
44 4ef9ff62 2005-01-14 devnull .BR \*9/man .
46 af79ebc2 2005-12-30 devnull The installation can be thought of as two steps:
47 af79ebc2 2005-12-30 devnull build all the binaries, and then edit files as necessary
48 af79ebc2 2005-12-30 devnull to fix the references to the installation root.
49 af79ebc2 2005-12-30 devnull If necessary, these can be run separately.
50 af79ebc2 2005-12-30 devnull Given the
53 4ef9ff62 2005-01-14 devnull .I INSTALL
54 af79ebc2 2005-12-30 devnull performs only the first step.
55 af79ebc2 2005-12-30 devnull Given the
58 af79ebc2 2005-12-30 devnull .I INSTALL
59 af79ebc2 2005-12-30 devnull performs only the second step.
60 af79ebc2 2005-12-30 devnull The first step can be done with the tree in a temporary work directory,
61 af79ebc2 2005-12-30 devnull but the second step must be done once the tree is in its final location.
62 89ec3cde 2011-06-02 rsc If you want to build the project in one location and then install into
63 89ec3cde 2011-06-02 rsc another location, use
66 89ec3cde 2011-06-02 rsc to specify the
68 89ec3cde 2011-06-02 rsc location of Plan9 tree.
69 af79ebc2 2005-12-30 devnull These flags are only necessary when trying to conform to the
70 af79ebc2 2005-12-30 devnull expectations of certain package management systems.
72 af79ebc2 2005-12-30 devnull At the end of the installation,
73 7c604f0d 2005-01-23 devnull .I INSTALL
74 cb8f7357 2020-01-20 rsc prints suggested settings for the environment variables
75 7c604f0d 2005-01-23 devnull .B $PLAN9
77 7c604f0d 2005-01-23 devnull .BR $PATH .
79 b04c42e9 2005-01-17 devnull .I INSTALL
80 cb8f7357 2020-01-20 rsc writes various autodetected settings to
81 cb8f7357 2020-01-20 rsc .BR \*9/config .
83 d93fca6a 2005-02-11 devnull .B \*9/LOCAL.config
84 d93fca6a 2005-02-11 devnull is appended to
85 d93fca6a 2005-02-11 devnull .B config
86 d93fca6a 2005-02-11 devnull after this auto-detection and can be used to override the choices.
88 d93fca6a 2005-02-11 devnull .B LOCAL.config
89 d93fca6a 2005-02-11 devnull contains a line
90 16c1defa 2005-11-12 devnull .B WSYSTYPE=nowsys
91 d93fca6a 2005-02-11 devnull then the system is built without using X11.
92 9444b8e4 2020-05-18 rsc .B LOCAL.config
93 9444b8e4 2020-05-18 rsc may also list settings for
95 9444b8e4 2020-05-18 rsc (the host C compiler)
98 9444b8e4 2020-05-18 rsc (any additional flags to pass to the compiler).
99 9444b8e4 2020-05-18 rsc Values more complex than single words should be quoted
100 9444b8e4 2020-05-18 rsc with single quotes.
102 8c24e687 2009-04-30 rsc On most Linux systems, the X11 header packages need to be installed
103 8c24e687 2009-04-30 rsc to build using X11. On Debian. the required packages are
104 93a25a0f 2021-04-09 rsc libfontconfig1-dev, libx11-dev, libxext-dev, and libxt-dev.
105 8c24e687 2009-04-30 rsc On Ubuntu, it suffices to install xorg-dev.
107 af79ebc2 2005-12-30 devnull .I INSTALL
108 af79ebc2 2005-12-30 devnull can safely be repeated to rebuild the system from scratch.
110 17e1150a 2005-11-26 devnull Once the system is built for the first time,
111 cb8f7357 2020-01-20 rsc it can be maintained and rebuilt using
112 d32deab1 2020-08-16 rsc .MR mk (1) .
113 af79ebc2 2005-12-30 devnull To rebuild individual commands or libraries,
116 af79ebc2 2005-12-30 devnull .B install
119 af79ebc2 2005-12-30 devnull .B clean
120 af79ebc2 2005-12-30 devnull in the appropriate source directory
122 d32deab1 2020-08-16 rsc .MR src (1) ).
123 4ef9ff62 2005-01-14 devnull .SH FILES
125 4ef9ff62 2005-01-14 devnull .B \*9/lib/moveplan9.files
126 4ef9ff62 2005-01-14 devnull the list of files that need to have
127 4ef9ff62 2005-01-14 devnull .B /usr/local/plan9
128 4ef9ff62 2005-01-14 devnull edited out of them
130 4ef9ff62 2005-01-14 devnull .B \*9/lib/moveplan9.sh
131 4ef9ff62 2005-01-14 devnull the script that edits the files
133 4ef9ff62 2005-01-14 devnull .B \*9/src/mkmk.sh
134 4ef9ff62 2005-01-14 devnull the shell script used to build
137 4ef9ff62 2005-01-14 devnull .B \*9/dist/manweb
138 4ef9ff62 2005-01-14 devnull the shell script that builds the HTML manual
140 4ef9ff62 2005-01-14 devnull .B \*9/man/index.html
141 4ef9ff62 2005-01-14 devnull the top-level page in the HTML version of the manual
143 7c604f0d 2005-01-23 devnull .B \*9/install.log
144 7c604f0d 2005-01-23 devnull logged output from the last run of
145 7c604f0d 2005-01-23 devnull .I INSTALL
147 1415e197 2009-04-30 rsc .B \*9/install.sum
148 af79ebc2 2005-12-30 devnull a summary of
149 af79ebc2 2005-12-30 devnull .B install.log
150 4ef9ff62 2005-01-14 devnull .SH SEE ALSO
151 d32deab1 2020-08-16 rsc .MR intro (1) ,
