diff --git a/docs/userguide/en/installation/install-source-linux.html b/docs/userguide/en/installation/install-source-linux.html index d4654ef6bb..f213b5c7f5 100644 --- a/docs/userguide/en/installation/install-source-linux.html +++ b/docs/userguide/en/installation/install-source-linux.html @@ -69,7 +69,7 @@ This is also how you update the code in the future.
./configure --build-cross-tools ../buildtools/To build with GCC 4.x the configure line changes to:
./configure --build-cross-tools-gcc4 x86 ../buildtools/-
But keep in mind this will produce binaries which are not compatible with BeOS.
+But keep in mind this will produce a Haiku installation which is not compatible with BeOS.
Now you could already start to build RAW or VMWare images. Before we come to that, however, let's have a look at the UserBuildConfig that can be used to customize and automate some things.
In trunk/haiku/build/jam/ there's a UserBuildConfig.ReadMe that explains various options. Don't simply rename it and use it as UserBuildConfig!
-You start by duplicating the UserBuildConfig.sample and the remove the.sample suffix to get your UserBuildConfig. From the .ReadMe you can copy interesting parts into your config and customize them there.
+You start by duplicating the UserBuildConfig.sample and removing the .sample suffix to get your UserBuildConfig. From the .ReadMe you can copy interesting parts into your config and customize them there.
First, the line is needed for the optional "OpenSSH" package:
+First, this line is needed for the optional "OpenSSH" package:
HAIKU_IMAGE_HOST_NAME = "TEST" ;
There are several optional software packages available, that are dowloaded at build time if they haven't been so already. For a list of all available packages, see haiku/trunk/build/jam/OptionalPackages. Here's an example:
@@ -107,7 +107,7 @@ AddSymlinkToHaikuImage home config settings : /boot/beos/etc/timezones/Europe/Paris : timezone ; AddFilesToHaikuImage home config settings : German : Key_map ;The build process can be fine tuned until it fits your needs. You could create your own folder haiku/trunk/user_data/ and put files there that are then copied or unzipped into the image. Zipping is important when dealing with Haiku files with their attributes, because zipping them up will preserve them on non-BFS partitions.
+
The build process can be fine tuned until it fits your needs. You could create your own folder haiku/trunk/user_data/ and put files there that are then copied or unzipped into the image. Zipping is important when dealing with Haiku files and their attributes, because zipping them up will preserve them on non-BFS partitions.
For example:
# Zip up your emails between each system update and place the archive into the @@ -125,12 +125,12 @@ DefineBuildProfile vmware : vmware-image ; switch $(HAIKU_BUILD_PROFILE) { case "disk" : { + HAIKU_DONT_CLEAR_IMAGE = 1 ; } case "vmware" : { HAIKU_IMAGE_SIZE = 900 ; - HAIKU_DONT_CLEAR_IMAGE = 1 ; } }@@ -172,17 +172,17 @@ DefineBuildProfile vmware : vmware-image ; switch $(HAIKU_BUILD_PROFILE) { case "disk" : { + HAIKU_DONT_CLEAR_IMAGE = 1 ; } case "vmware" : { HAIKU_IMAGE_SIZE = 900 ; - HAIKU_DONT_CLEAR_IMAGE = 1 ; } } -
Note: when building an a USB memory stick, you wouldn't specify the partition number in the disk entry (ex. /dev/sdb instead of /dev/sdb1). This will erase your whole flash drive and it's partitions, so be cautious to use the correct drive name!
+Note: When building onto a USB memory stick, you wouldn't specify the partition number in the disk entry (ex. /dev/sdb instead of /dev/sdb1). This will erase your whole flash drive and it's partitions, so be cautious to use the correct drive name!
Besides these user build profiles, there are also official release profiles, see ReleaseBuildProfiles in the same folder. The profiles alpha-raw and alpha-vmware will build all officially planned components for the alpha release. They are invoked just like the user profiles, see Building a VMWare Image a bit further down.
@@ -203,7 +203,7 @@ sudo chmod o+rw /dev/sda7Note that the read permission is set for the whole disk (1st line) while the write permission is limited to one specific partition (2nd line).
When installing to a USB flashdrive, replace the drive name, and type:
-sudo chmod o+r /dev/sda+
sudo chmod o+rw /dev/sdb
Now the Haiku image is built and installed on the partition:
@@ -213,7 +213,7 @@ sudo chmod o+rw /dev/sda7Installing to its own partition offers some interesting possibilities:
jam -q @disk update-all-
This updates all of the system, but leaves the home folder untouched, so all your data will still be there.
+This updates all of the system, but leaves the home folder untouched, so all your data and settings will still be there. Note that optional packages will not be updated in this install mode.
You can also decide to only update certain components:
jam -q @disk update {components}@@ -223,7 +223,7 @@ sudo chmod o+rw /dev/sda7
Just enter:
+If you are using the UserBuildConfig from above, just enter:
jam -q @vmware
The resulting image can be run in VMPlayer with an associated .vmx file (There's also a .vmx file in haiku/3rdparty/vmware/).
@@ -243,7 +243,7 @@ sudo chmod o+rw /dev/sda7All harddisks start with "hd"
"N" is the hard disk number, starting with "0".
"n is the partition number, also starting with "0".
-The first logical partition always have the number 4, regardless of the number of primary partitions.
If you're still unsure, check out the GRUB manual.
@@ -263,7 +263,7 @@ chainloader +1Using build profiles has another advantage: You can mount a VMWare image or the partition of a Haiku installation to transfer data. Navigate to haiku/trunk/ and simply enter:
+Using build profiles has another advantage: You can mount a VMWare image or the partition of a Haiku installation to transfer data. If you were using the UserBuildConfig above, you could navigate to haiku/trunk/ and simply enter:
jam @disk mount
or
@@ -284,7 +284,7 @@ query - query for files quit - quit the shell rm - remove files and directories sync - syncs the file system -It all works pretty much like in your normal bash shell (besides there's sadly no tab-completion).
+
It all works pretty much like in your normal bash shell (besides there's sadly neither tab-completion nor command history).
The one thing to remember: You have to prefix every local path (your Linux partition) with a ":".
Here's an example to copy the file .bash_history from Haiku to your Linux partition: