docs/135316: [patch][doc] Add 'make installworld' section to jails-build.html

[Glen Barber]

>Number:         135316
>Category:       docs
>Synopsis:       [patch][doc] Add 'make installworld' section to jails-build.html
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 06 16:00:14 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator:     Glen Barber
>Release:        7.2-STABLE
>Organization:
>Environment:
FreeBSD phoenix 7.2-STABLE FreeBSD 7.2-STABLE #0 r192129M: Thu May 14 22:53:56 UTC 2009     root at phoenix:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
Section 15.4 of the jail(8) documentation specifies to 'make world' when creating a jail.  Assuming subsequent jail creation will use the same userland / kernel, and are in sync with the host userland / kernel, the need to 'make world' may be unclear to new users after the userland is already built. 
>How-To-Repeat:

>Fix:
The attached patch adds a section for subsequent jails, replacing 'make world' with 'make installworld'.

Patch attached with submission follows:

--- /usr/share/doc/en_US.ISO8859-1/books/handbook/jails-build.html.original	2009-06-06 11:34:02.000000000 -0400
+++ /usr/share/doc/en_US.ISO8859-1/books/handbook/jails-build.html	2009-06-06 11:41:42.000000000 -0400
@@ -66,6 +66,30 @@
 vspace="0" border="0" alt="(4)" /></a>
 </pre>
 
+<p>If you already have done <kbd class="USERINPUT">make world</kbd> and are adding
+more jails to your system, you can exclude <kbd class="USERINPUT">make buildworld</kbd> 
+and, instead, use the following:
+<pre class="SCREEN">
+<samp class="PROMPT">#</samp> <kbd class="USERINPUT">setenv D <tt 
+class="REPLACEABLE"><i>/here/is/the/jail</i></tt></kbd>
+<samp class="PROMPT">#</samp> <kbd class="USERINPUT">mkdir -p $D</kbd> <a id="JAILPATH"
+name="JAILPATH"><img src="./imagelib/callouts/1.png" hspace="0" vspace="0" border="0"
+alt="(1)" /></a>
+<samp class="PROMPT">#</samp> <kbd class="USERINPUT">cd /usr/src</kbd>
+<samp class="PROMPT">#</samp> <kbd class="USERINPUT">make installworld DESTDIR=$D</kbd> <a
+id="JAILWORLD" name="JAILWORLD"><img src="./imagelib/callouts/2.png" hspace="0"
+vspace="0" border="0" alt="(2)" /></a>
+<samp class="PROMPT">#</samp> <kbd class="USERINPUT">cd etc/</kbd> <a id="AEN21716"
+name="AEN21716" href="#FTN.AEN21716"><span class="footnote">[1]</span></a>
+<samp class="PROMPT">#</samp> <kbd
+class="USERINPUT">make distribution DESTDIR=$D</kbd> <a id="JAILDISTRIB"
+name="JAILDISTRIB"><img src="./imagelib/callouts/3.png" hspace="0" vspace="0" border="0"
+alt="(3)" /></a>
+<samp class="PROMPT">#</samp> <kbd class="USERINPUT">mount -t devfs devfs $D/dev</kbd> <a
+id="JAILDEVFS" name="JAILDEVFS"><img src="./imagelib/callouts/4.png" hspace="0"
+vspace="0" border="0" alt="(4)" /></a>
+</pre>
+
 <div class="CALLOUTLIST">
 <dl compact="COMPACT">
 <dt><a href="jails-build.html#JAILPATH"><img src="./imagelib/callouts/1.png" hspace="0"


>Release-Note:
>Audit-Trail:
>Unformatted: