Index: en_US.ISO8859-1/books/handbook/jails/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/jails/chapter.xml
+++ en_US.ISO8859-1/books/handbook/jails/chapter.xml
@@ -1313,14 +1313,34 @@
updates have the same limitations as if
&man.freebsd-update.8; were being run directly. The most
important one is that only -RELEASE versions of &os; are
- available with this method. To update the basejail to the
- latest patched release of the version of &os; on the host
- computer, use:
+ available with this method.
+
+ Update the basejail to the latest patched release of
+ the version of &os; on the host. For example, updating from
+ RELEASE-p1 to RELEASE-p2.
+
+ &prompt.root; ezjail-admin update -u
+
+ To upgrade the basejail to a new version, first
+ upgrade the host system as described in . Once the host has
+ been upgraded and rebooted, the basejail can then be
+ upgraded. &man.freebsd-update.8; has no way of determining
+ which version is currently installed in the basejail, so the
+ original version must be specified. Use &man.file.1; to
+ determine the original version in the basejail:
+
+ &prompt.root; file /usr/jails/basejail/bin/sh
+/usr/jails/basejail/bin/sh: ELF 64-bit LSB executable, x86-64, version 1 (FreeBSD), dynamically linked (uses shared libs), for FreeBSD 9.3, stripped
+
+ Now use this information to perform the upgrade from
+ 9.3-RELEASE to the current version of
+ the host system:
- &prompt.root; ezjail-admin update -r
+ &prompt.root; ezjail-admin update -U -s 9.3-RELEASE
- After updating the basejail, &man.mergemaster.8; can be
- run to update each jail's configuration files.
+ After updating the basejail, &man.mergemaster.8; must
+ be run to update each jail's configuration files.
How to use &man.mergemaster.8; depends on the purpose
and trustworthiness of a jail. If a jail's services or