Conditionalize keyboard layout change
[ikiwiki.git] / docs / newhandbook / Upgrading / index.mdwn
index 0249dea..86eddc7 100644 (file)
@@ -2,10 +2,7 @@
 
 ### Supported methods
 
-The only **supported** method of upgrading DragonFly BSD is by building from source code. <br><br>
-Supported upgrade process includes going from the *previous release* to *latest release*.<br>
-
-For example, in our actual case, only the upgrade process involving <u>2.10.x up to 3.0.x</u> would be supported.
+The only **supported** method of upgrading DragonFly BSD is by building from source code. The supported upgrade process includes going from the *previous release* to *latest release*.
 
 ### Getting the source code
 
@@ -15,14 +12,22 @@ There is a Makefile in /usr which will ease the task of retrieving the source tr
     % make src-create
      [...]
 
-And that will effectively checkout the source tree on `/usr/src` and switch to master branch. For stable branch you need to check it out with the following command (remember to replace the *DragonFly_RELEASE_3_0* with the appropriate branch name for the release needed).
+This will check out (download) the source tree to `/usr/src` and switch to the master branch. For the stable branch, you need to check it out with the following command (remember to replace the *DragonFly_RELEASE_3_0* with the appropriate branch name for the release needed).
 
     % cd /usr/src
     % git checkout DragonFly_RELEASE_3_0
 
+To see the available remote branches:
+
+    # cd /usr/src 
+    # git pull
+    # git branch -r
+
+The leading edge (development trunk) version of the system will be the "master".
+
 ### Build and upgrade process
 
-Build process requires some time to build all the userland programs and the DragonFly BSD kernel. Once built, next step is to install everything and make the upgrade target. No configuration files in */etc* are changed by this process. More details can be found in **[build(7)](http://leaf.dragonflybsd.org/cgi/web-man?command=build&section=ANY)** manpage. 
+The build process requires some time to build all the userland programs and the DragonFly BSD kernel. Once built, the next step is to install everything and make the upgrade target. No configuration files in */etc* are changed by this process. More details can be found in **[build(7)](http://leaf.dragonflybsd.org/cgi/web-man?command=build&section=ANY)** manpage. 
 
     % cd /usr/src
     % make buildworld
@@ -32,24 +37,20 @@ Build process requires some time to build all the userland programs and the Drag
     % make upgrade
     (reboot)
 
-**Note:** You may use a concurrent build if you have a SMP (a machine with several cores or CPUs). You may specify *-j x* parameter to make where x is the number of CPUs + 1. <br>
-If you run DragonFly 2.12 or higher the kernel will auto-detect the number of CPUs your computer has and activate them all if possible. To find out how many CPUs your computer has:
-<br>
+**Note:** You may use a concurrent build if you have a SMP (a machine with several cores or CPUs). You may specify *-j x* parameter to make where x is the number of CPUs + 1.  If you run DragonFly 2.12 or higher the kernel will auto-detect the number of CPUs your computer has and activate them all if possible. To find out how many CPUs your computer has:
 
     % sysctl hw.ncpu
     hw.ncpu: 2
 
 An explanation of each step follows.
 
-* <u>*make buildworld*</u> : This command builds all userland programs and it is the most time-consuming step.<br>
-Some programs may be discarded from the build process.<br>
-For more details check **[make.conf(5)](http://leaf.dragonflybsd.org/cgi/web-man?command=make.conf&section=ANY)** manpage. 
+* <u>*make buildworld*</u> : This command builds all userland programs; it is the most time-consuming step of the process.  Some programs may be discarded from the build process.  For more information, see **[make.conf(5)](http://leaf.dragonflybsd.org/cgi/web-man?command=make.conf&section=ANY)** manpage. 
 
-* <u>*make buildkernel*</u> : This builds the kernel using the config file by default for your architecture. You may also specify a different kernel configuration file using KERNCONF=configfile. More details on **[make.conf(5)](http://leaf.dragonflybsd.org/cgi/web-man?command=make.conf&section=ANY)** manpage.
+* <u>*make buildkernel*</u> : This builds the kernell by default, it uses the config file for your architecture. You may also specify a different kernel configuration file using `KERNCONF=<configfile>`. For more information, see **[make.conf(5)](http://leaf.dragonflybsd.org/cgi/web-man?command=make.conf&section=ANY)** manpage.
 
-* <u>*make installkernel*</u> This installs the kernel using the config file for your architecture or KERNCONF=file can be used to specify which one to install.
+* <u>*make installkernel*</u> This installs the kernel using the config file for your architecture; again, `KERNCONF=<configfile>` can be used to specify which one to install.
 
-* <u>*make installworld*</u> : This copies all the files built in the buildworld step (i.e. everything that is not the kernel) to the proper places in the filesystem.
+* <u>*make installworld*</u> : This copies all the files built in the buildworld step (i.e. everything that is not the kernel) to their proper places in the file system.
 
 * <u>*make upgrade*</u> : This cleans out any files made unnecessary by this upgrade.
 
@@ -57,4 +58,4 @@ For more details check **[make.conf(5)](http://leaf.dragonflybsd.org/cgi/web-man
 
 If your computer fails to boot the new kernel, you can always select 'Boot DragonFly using kernel.old' in the loader menu, so that the old kernel is loaded instead of the new one.
 
-Additional upgrading instructions can be found in */usr/src/UPDATING* in the source tree. Online it can be found **[here](http://gitweb.dragonflybsd.org/dragonfly.git/blob_plain/master:/UPDATING)**
+Additional upgrading instructions can be found in */usr/src/UPDATING* in the source tree. They can also be found online, **[here](http://gitweb.dragonflybsd.org/dragonfly.git/blob_plain/master:/UPDATING)**