From nobody@FreeBSD.org  Sat Jun  6 15:55:12 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 49C791065670
	for <freebsd-gnats-submit@FreeBSD.org>; Sat,  6 Jun 2009 15:55:12 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 1C9D28FC1E
	for <freebsd-gnats-submit@FreeBSD.org>; Sat,  6 Jun 2009 15:55:12 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n56FtBLZ055091
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 6 Jun 2009 15:55:11 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n56FtBFu055090;
	Sat, 6 Jun 2009 15:55:11 GMT
	(envelope-from nobody)
Message-Id: <200906061555.n56FtBFu055090@www.freebsd.org>
Date: Sat, 6 Jun 2009 15:55:11 GMT
From: Glen Barber <glen.j.barber@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch][doc] Add 'make installworld' section to jails-build.html
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         135316
>Category:       docs
>Synopsis:       [patch][doc] Add 'make installworld' section to jails-build.html
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    manolis
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 06 16:00:14 UTC 2009
>Closed-Date:    Mon Jun 08 16:32:14 UTC 2009
>Last-Modified:  Mon Jun 08 16:32:14 UTC 2009
>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@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:

From: Manolis Kiagias <manolis@FreeBSD.org>
To: Glen Barber <glen.j.barber@gmail.com>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/135316: [patch][doc] Add 'make installworld' section to
 jails-build.html
Date: Sat, 06 Jun 2009 23:31:46 +0300

 Glen Barber wrote:
 >> 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@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>
 >  
 >   
 
 Hi Glen,
 
 The above HTML file is produced from this original SGML one:
 
 http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO8859-1/books/handbook/jails/chapter.sgml?rev=1.17;content-type=text%2Fplain
 
 Detailed information on syntax and build procedures may be found on the
 FreeBSD Doc Primer:
 
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/
 
 It would be best for us if you could supply a patch against the SGML
 file. If this is too much trouble, please send you submission in plain
 text,  and will take care of the formatting.
 
 Thanks!

From: Glen Barber <glen.j.barber@gmail.com>
To: bug-followup@FreeBSD.org, glen.j.barber@gmail.com
Cc:  
Subject: Re: docs/135316: [patch][doc] Add 'make installworld' section to 
	jails-build.html
Date: Sat, 6 Jun 2009 18:10:10 -0400

 Hi, Manolis.
 
 Thanks for the point in the right direction.
 
 I'll submit a corrected patch, hopefully within the next day.
 
 Thanks!
 
 --Glen Barber

From: Glen Barber <glen.j.barber@gmail.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/135316: [patch][doc] Add 'make installworld' section to 
	jails-build.html
Date: Sun, 7 Jun 2009 09:33:04 -0400

 --001636c5b31f4de686046bc22af0
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: 7bit
 
 Attached is a .sgml patch.
 
 Thanks!
 
 -- Glen Barber
 
 --001636c5b31f4de686046bc22af0
 Content-Type: text/plain; charset=US-ASCII; name="jails-build.txt"
 Content-Disposition: attachment; filename="jails-build.txt"
 Content-Transfer-Encoding: base64
 X-Attachment-Id: f_fvnsmzjn0
 
 LS0tIC91c3IvZG9jL2VuX1VTLklTTzg4NTktMS9ib29rcy9oYW5kYm9vay9qYWlscy9jaGFwdGVy
 LnNnbWwub3JpZwkyMDA5LTA2LTA3IDA5OjA5OjExLjAwMDAwMDAwMCAtMDQwMAorKysgL3Vzci9k
 b2MvZW5fVVMuSVNPODg1OS0xL2Jvb2tzL2hhbmRib29rL2phaWxzL2NoYXB0ZXIuc2dtbAkyMDA5
 LTA2LTA3IDA5OjIyOjMyLjAwMDAwMDAwMCAtMDQwMApAQCAtMjQyLDEyICsyNDIsMjUgQEAKICAg
 ICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PnNldGVudiBEIDxyZXBsYWNlYWJs
 ZT4vaGVyZS9pcy90aGUvamFpbDwvcmVwbGFjZWFibGU+PC91c2VyaW5wdXQ+CiAmcHJvbXB0LnJv
 b3Q7IDx1c2VyaW5wdXQ+bWtkaXIgLXAgJEQ8L3VzZXJpbnB1dD4gPGNvIGlkPSJqYWlscGF0aCI+
 CiAmcHJvbXB0LnJvb3Q7IDx1c2VyaW5wdXQ+Y2QgL3Vzci9zcmM8L3VzZXJpbnB1dD4KLSZwcm9t
 cHQucm9vdDsgPHVzZXJpbnB1dD5tYWtlIHdvcmxkIERFU1RESVI9JEQ8L3VzZXJpbnB1dD4gPGNv
 IGlkPSJqYWlsd29ybGQiPgorJnByb21wdC5yb290OyA8dXNlcmlucHV0Pm1ha2UgYnVpbGR3b3Js
 ZDwvdXNlcmlucHV0PgorJnByb21wdC5yb290OyA8dXNlcmlucHV0Pm1ha2UgaW5zdGFsbHdvcmxk
 IERFU1RESVI9JEQ8L3VzZXJpbnB1dD4gPGNvIGlkPSJqYWlsd29ybGQiPgogJnByb21wdC5yb290
 OyA8dXNlcmlucHV0PmNkIGV0Yy88L3VzZXJpbnB1dD4gPGZvb3Rub3RlPjxwYXJhPlRoaXMgc3Rl
 cAogaXMgbm90IHJlcXVpcmVkIG9uICZvczsgNi4wIGFuZCBsYXRlci48L3BhcmE+PC9mb290bm90
 ZT4KICZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5tYWtlIGRpc3RyaWJ1dGlvbiBERVNURElSPSRE
 PC91c2VyaW5wdXQ+IDxjbyBpZD0iamFpbGRpc3RyaWIiPgogJnByb21wdC5yb290OyA8dXNlcmlu
 cHV0Pm1vdW50IC10IGRldmZzIGRldmZzICREL2RldjwvdXNlcmlucHV0PiA8Y28gaWQ9ImphaWxk
 ZXZmcyI+PC9zY3JlZW4+CiAKKyAgICAgPHBhcmE+SWYgeW91IGhhdmUgYWxyZWFkeSByZWJ1aWx0
 IHlvdXIgdXNlcmxhbmQgYW5kIGtlcm5lbCB1c2luZyA8Y29tbWFuZD5tYWtlIHdvcmxkPC9jb21t
 YW5kPiBvciAKKzxjb21tYW5kPm1ha2UgYnVpbGR3b3JsZDwvY29tbWFuZD4sIHlvdSBjYW4gc2tp
 cCB0aGUgYnVpbGR3b3JsZCBwcm9jZXNzIGFuZCBpbnN0YWxsIHlvdXIgZXhpc3RpbmcgdXNlcmxh
 bmQgaW50byBhIG5ldyBqYWlsLjwvcGFyYT4KKworICAgICAgPHNjcmVlbj4mcHJvbXB0LnJvb3Q7
 IDx1c2VyaW5wdXQ+c2V0ZW52IEQgPHJlcGxhY2VhYmxlPi9oZXJlL2lzL3RoZS9qYWlsPC9yZXBs
 YWNlYWJsZT48L3VzZXJpbnB1dD4KKyZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5ta2RpciAtcCAk
 RDwvdXNlcmlucHV0PiAKKyZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5jZCAvdXNyL3NyYzwvdXNl
 cmlucHV0PgorJnByb21wdC5yb290OyA8dXNlcmlucHV0Pm1ha2UgaW5zdGFsbHdvcmxkIERFU1RE
 SVI9JEQ8L3VzZXJpbnB1dD4gCismcHJvbXB0LnJvb3Q7IDx1c2VyaW5wdXQ+Y2QgZXRjLzwvdXNl
 cmlucHV0PiA8Zm9vdG5vdGU+PHBhcmE+VGhpcyBzdGVwCitpcyBub3QgcmVxdWlyZWQgb24gJm9z
 OyA2LjAgYW5kIGxhdGVyLjwvcGFyYT48L2Zvb3Rub3RlPgorJnByb21wdC5yb290OyA8dXNlcmlu
 cHV0Pm1ha2UgZGlzdHJpYnV0aW9uIERFU1RESVI9JEQ8L3VzZXJpbnB1dD4gCismcHJvbXB0LnJv
 b3Q7IDx1c2VyaW5wdXQ+bW91bnQgLXQgZGV2ZnMgZGV2ZnMgJEQvZGV2PC91c2VyaW5wdXQ+IDwv
 c2NyZWVuPgorCiAgICAgPGNhbGxvdXRsaXN0PgogICAgICAgPGNhbGxvdXQgYXJlYXJlZnM9Imph
 aWxwYXRoIj4KIAk8cGFyYT5TZWxlY3RpbmcgYSBsb2NhdGlvbiBmb3IgYSBqYWlsIGlzIHRoZSBi
 ZXN0IHN0YXJ0aW5nIHBvaW50Lgo=
 --001636c5b31f4de686046bc22af0--

From: Glen Barber <gjb35@drexel.edu>
To: bug-followup@FreeBSD.org,glen.j.barber@gmail.com
Cc:  
Subject: Re: docs/135316: [patch][doc] Add 'make installworld' section
 to jails-build.html
Date: Sun, 07 Jun 2009 09:53:08 -0400

 Good ol' Gmail destroyed my patch.  Hopefully this one will come out a little better. 
 
 -- Glen Barber
 
 
 --- /usr/doc/en_US.ISO8859-1/books/handbook/jails/chapter.sgml.orig	2009-06-07 09:09:11.000000000 -0400
 +++ /usr/doc/en_US.ISO8859-1/books/handbook/jails/chapter.sgml	2009-06-07 09:22:32.000000000 -0400
 @@ -242,12 +242,25 @@
        <screen>&prompt.root; <userinput>setenv D <replaceable>/here/is/the/jail</replaceable></userinput>
  &prompt.root; <userinput>mkdir -p $D</userinput> <co id="jailpath">
  &prompt.root; <userinput>cd /usr/src</userinput>
 -&prompt.root; <userinput>make world DESTDIR=$D</userinput> <co id="jailworld">
 +&prompt.root; <userinput>make buildworld</userinput>
 +&prompt.root; <userinput>make installworld DESTDIR=$D</userinput> <co id="jailworld">
  &prompt.root; <userinput>cd etc/</userinput> <footnote><para>This step
  is not required on &os; 6.0 and later.</para></footnote>
  &prompt.root; <userinput>make distribution DESTDIR=$D</userinput> <co id="jaildistrib">
  &prompt.root; <userinput>mount -t devfs devfs $D/dev</userinput> <co id="jaildevfs"></screen>
  
 +     <para>If you have already rebuilt your userland and kernel using <command>make world</command> or 
 +<command>make buildworld</command>, you can skip the buildworld process and install your existing userland into a new jail.</para>
 +
 +      <screen>&prompt.root; <userinput>setenv D <replaceable>/here/is/the/jail</replaceable></userinput>
 +&prompt.root; <userinput>mkdir -p $D</userinput> 
 +&prompt.root; <userinput>cd /usr/src</userinput>
 +&prompt.root; <userinput>make installworld DESTDIR=$D</userinput> 
 +&prompt.root; <userinput>cd etc/</userinput> <footnote><para>This step
 +is not required on &os; 6.0 and later.</para></footnote>
 +&prompt.root; <userinput>make distribution DESTDIR=$D</userinput> 
 +&prompt.root; <userinput>mount -t devfs devfs $D/dev</userinput> </screen>
 +
      <calloutlist>
        <callout arearefs="jailpath">
  	<para>Selecting a location for a jail is the best starting point.
 
 

From: Manolis Kiagias <manolis@FreeBSD.org>
To: Glen Barber <glen.j.barber@gmail.com>, bug-followup@FreeBSD.org
Cc: freebsd-doc@FreeBSD.org
Subject: Re: docs/135316: [patch][doc] Add 'make installworld' section to
 	jails-build.html
Date: Sun, 07 Jun 2009 16:57:26 +0300

 Glen Barber wrote:
 > The following reply was made to PR docs/135316; it has been noted by GNATS.
 >
 > From: Glen Barber <glen.j.barber@gmail.com>
 > To: bug-followup@FreeBSD.org
 > Cc:  
 > Subject: Re: docs/135316: [patch][doc] Add 'make installworld' section to 
 > 	jails-build.html
 > Date: Sun, 7 Jun 2009 09:33:04 -0400
 >
 >  --001636c5b31f4de686046bc22af0
 >  Content-Type: text/plain; charset=ISO-8859-1
 >  Content-Transfer-Encoding: 7bit
 >  
 >  Attached is a .sgml patch.
 >  
 >  Thanks!
 >
 >   
 
 Unfortunately it seems the mailer messed this up.
 Please try resending using different settings / mail account - if all
 else fails send directly to me in a gzipped file.
 Thanks!
Responsible-Changed-From-To: freebsd-doc->manolis 
Responsible-Changed-By: manolis 
Responsible-Changed-When: Sun Jun 7 16:01:45 UTC 2009 
Responsible-Changed-Why:  
I will handle this one 

http://www.freebsd.org/cgi/query-pr.cgi?pr=135316 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/135316: commit references a PR
Date: Mon,  8 Jun 2009 16:25:32 +0000 (UTC)

 manolis     2009-06-08 16:25:24 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/jails chapter.sgml 
   Log:
   Split the 'make world' step in two steps (buildworld/installworld).
   Note that 'buildworld' need only be done once.
   
   PR:             docs/135316
   Submitted by:   Glen Barber <glen.j.barber at gmail.com>
   
   Revision  Changes    Path
   1.18      +11 -6     doc/en_US.ISO8859-1/books/handbook/jails/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: manolis 
State-Changed-When: Mon Jun 8 16:31:54 UTC 2009 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=135316 
>Unformatted:
