3 install \- notes about Plan 9 from User Space installation
16 To obtain the Plan 9 tree, use Git
19 or download a tar file from
20 .HR https://9fans.github.io/plan9port "" .
22 The tree can be unpacked anywhere, but the
24 .BR /usr/local/plan9 .
25 In the root of the tree, run
27 This script builds the Plan 9 build program
30 cleans all previously built object files and libraries out of the tree,
31 rebuilds and installs everything, and then cleans up.
33 There are a few files in tree which have the root
37 edits these files to replace the string
39 with the name of the root of the current tree.
43 builds an HTML version of the manual and installs it in
46 The installation can be thought of as two steps:
47 build all the binaries, and then edit files as necessary
48 to fix the references to the installation root.
49 If necessary, these can be run separately.
54 performs only the first step.
59 performs only the second step.
60 The first step can be done with the tree in a temporary work directory,
61 but the second step must be done once the tree is in its final location.
62 If you want to build the project in one location and then install into
68 location of Plan9 tree.
69 These flags are only necessary when trying to conform to the
70 expectations of certain package management systems.
72 At the end of the installation,
74 prints suggested settings for the environment variables
80 writes various autodetected settings to
86 after this auto-detection and can be used to override the choices.
91 then the system is built without using X11.
93 On most Linux systems, the X11 header packages need to be installed
94 to build using X11. On Debian. the required packages are
95 libx11-dev, libxext-dev, and libxt-dev.
96 On Ubuntu, it suffices to install xorg-dev.
99 can safely be repeated to rebuild the system from scratch.
101 Once the system is built for the first time,
102 it can be maintained and rebuilt using
104 To rebuild individual commands or libraries,
111 in the appropriate source directory
116 .B \*9/lib/moveplan9.files
117 the list of files that need to have
121 .B \*9/lib/moveplan9.sh
122 the script that edits the files
125 the shell script used to build
129 the shell script that builds the HTML manual
131 .B \*9/man/index.html
132 the top-level page in the HTML version of the manual
135 logged output from the last run of