Be more specific about the linux_base-c6 conversion.

Reviewed by:	xmj

1 files changed, 20 insertions, 16 deletions

diff --git a/UPDATING b/UPDATING
index e8543cc830b7..2a276f462f62 100644
--- a/UPDATING
+++ b/UPDATING
@@ -135,30 +135,34 @@ you update your ports collection, before attempting any port upgrades.
   AFFECTS: users of emulators/linux_base-f10 and emulators/linux_base-c6
   AUTHOR: xmj@FreeBSD.org
 
-  The complete drop-in replacement linux-c6 port infrastructure is in ports 
-  and will shortly replace the current linux-f10- ports as default.
+  The complete drop-in replacement linux-c6 port infrastructure is in
+  ports and will shortly replace the current linux-f10- ports as default.
 
-  To switch to the linux-c6 infrastructure you should:
+  To switch to the linux-c6 infrastructure:
 
-  0. Backup all your vital information!
-  1. Remove the current linux base port and all linux-f10- ports.
-  2. Add the following lines to /etc/make.conf:
+  0. Back up all your vital information!
+  1. Remove the current linux base port and all linux-f10- ports:
+       # pkg delete -f linux_base-f10 linux-f10-\*
+  2. Add these lines to /etc/make.conf:
        OVERRIDE_LINUX_BASE_PORT=c6
        OVERRIDE_LINUX_NONBASE_PORTS=c6
-  3. Make sure no linux application is running.
-  4. Set appropriate sysctl (compat.linux.osrelease=2.6.18).
+  3. Make sure no Linux application is running.
+  4. Update the Linux kernel version in /etc/sysctl.conf:
+       compat.linux.osrelease=2.6.18
+     Make it take effect immediately:
+       # sysctl compat.linux.osrelease=2.6.18
   5. Install emulators/linux-c6.
 
-  That should be enough in most circumstances. If you experience difficulties,
-  please be sure to expand step 1 to:
+  These steps are usually sufficient. If there are difficulties, expand
+  step 1 to:
 
-  1a. Remove all ports which depend on linux base port.
-  1b. Remove linux base port.
-  1c. Clean /compat/linux/ directory.
+  1a. Remove all ports which depend on the linux base port.
+  1b. Remove the linux base port.
+  1c. Clean the /compat/linux/ directory.
 
-  Should you encounter any other difficulties not fixed by these extended
-  steps, please submit an issue report in Bugzilla and send an email to FreeBSD's
-  emulation@ mailing list.
+  If there are any other difficulties not fixed by these extended steps,
+  please submit an issue report in Bugzilla and send an email to
+  FreeBSD's emulation@ mailing list.
 
 20140909:
   AFFECTS: users seeing build errors about missing *.la files