From nobody@FreeBSD.org  Mon Jun 11 06:27:06 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 5E29E106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 11 Jun 2012 06:27:06 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 4981A8FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 11 Jun 2012 06:27:06 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q5B6R5oA030902
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 11 Jun 2012 06:27:05 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q5B6R5bM030901;
	Mon, 11 Jun 2012 06:27:05 GMT
	(envelope-from nobody)
Message-Id: <201206110627.q5B6R5bM030901@red.freebsd.org>
Date: Mon, 11 Jun 2012 06:27:05 GMT
From: Roland van Laar <roland@micite.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Port upgrade documentation missing from Application Jail
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         168939
>Category:       docs
>Synopsis:       Port upgrade documentation missing from Application Jail
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          feedback
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jun 11 06:30:10 UTC 2012
>Closed-Date:    
>Last-Modified:  Mon Mar 25 11:54:07 UTC 2013
>Originator:     Roland van Laar
>Release:        
>Organization:
>Environment:
>Description:
Information about upgrading ports is missing from: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/jails-application.html.


Using portmaster results in an error to backup the port:


mkdir: /usr/ports/packages: No such file or directory

===>>> Creating a backup package for old version libiconv-1.13.1_2

===>>> Cannot cd into /usr/ports/packages/portmaster-backup to create a package
===>>> Aborting update

===>>> Update for converters/libiconv failed
===>>> Aborting update


>How-To-Repeat:
Install a Jail with nullfs according to http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/jails-application.html.

Build ports, update portstree, run portmaster -a
>Fix:
Add the following line to Handbook 16.6.1.2 step 5 and 16.6.1.4 Upgrading step 2:

ln -sf ../../s/packages usr/ports/packages

And add a small section/link to/about using portmaster to upgrade the ports.







>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->bcr 
Responsible-Changed-By: bcr 
Responsible-Changed-When: Mon Jun 18 18:14:49 UTC 2012 
Responsible-Changed-Why:  
I will work on this one. 

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

From: Benedict Reuschling <bcr@FreeBSD.org>
To: bug-followup@FreeBSD.org, roland@micite.net
Cc:  
Subject: Re: docs/168939: Port upgrade documentation missing from Application
 Jail
Date: Tue, 26 Jun 2012 19:52:32 +0200

 This is a multi-part message in MIME format.
 --------------060800050806050201060204
 Content-Type: text/plain; charset=ISO-8859-15
 Content-Transfer-Encoding: 7bit
 
 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 Can you check whether the attached patch is what you had in mind?
 
 Regards
 
 Benedict Reuschling
 FreeBSD Documentation Committer
 
 The FreeBSD Documentation Project
 FreeBSD German Documentation Project - https://doc.bsdgroup.de
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.8 (Darwin)
 Comment: GPGTools - http://gpgtools.org
 Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
 
 iEUEARECAAYFAk/p9uAACgkQTSZQLkqBk0heGwCgsW/iTyBIahnLDTdzr8S4V6/0
 MHoAl0t9zhk6y4oMTs/cRUsQ/h3JAIY=
 =vtHN
 -----END PGP SIGNATURE-----
 
 --------------060800050806050201060204
 Content-Type: text/plain; charset=UTF-8; x-mac-type="0"; x-mac-creator="0";
  name="pr168939.diff"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="pr168939.diff"
 
 Index: chapter.sgml
 ===================================================================
 --- chapter.sgml	(revision 39128)
 +++ chapter.sgml	(working copy)
 @@ -718,6 +718,7 @@
  &prompt.root; <userinput>ln -s ../s/usr-local usr/local</userinput>
  &prompt.root; <userinput>ln -s ../s/usr-X11R6 usr/X11R6</userinput>
  &prompt.root; <userinput>ln -s ../../s/distfiles usr/ports/distfiles</userinput>
 +&prompt.root; <userinput>ln -s ../../s/packages usr/ports/packages</userinput>
  &prompt.root; <userinput>ln -s s/tmp tmp</userinput>
  &prompt.root; <userinput>ln -s s/var var</userinput></screen>
  	  </step>
 @@ -909,6 +910,8 @@
  &prompt.root; <userinput>ln -s s/home home</userinput>
  &prompt.root; <userinput>ln -s ../s/usr-local usr/local</userinput>
  &prompt.root; <userinput>ln -s ../s/usr-X11R6 usr/X11R6</userinput>
 +&prompt.root; <userinput>ln -s ../../s/distfiles usr/ports/distfiles</userinput>
 +&prompt.root; <userinput>ln -s ../../s/packages usr/ports/packages</userinput>
  &prompt.root; <userinput>ln -s s/tmp tmp</userinput>
  &prompt.root; <userinput>ln -s s/var var</userinput></screen>
  	  </step>
 @@ -963,7 +966,11 @@
  	<para>Use &man.jls.8; to check if the jails started correctly.
  	  Do not forget to run mergemaster in each jail.  The
  	  configuration files will need to be updated as well as the
 -	  rc.d scripts.</para>
 +	  rc.d scripts.  To update the ports in the jails, you can use
 +	  <application>Portmaster</application> or
 +	  <application>portupgrade</application>.  See <xref
 +	  linkend="ports-upgrading"> for more information on using
 +	  these tools to upgrade ports.</para>
        </sect3>
      </sect2>
    </sect1>
 
 --------------060800050806050201060204
 Content-Type: application/octet-stream; x-mac-type="0"; x-mac-creator="0";
  name="pr168939.diff.sig"
 Content-Transfer-Encoding: base64
 Content-Disposition: attachment;
  filename="pr168939.diff.sig"
 
 iEYEABECAAYFAk/p9uAACgkQTSZQLkqBk0hD+gCgsAG0jCwx8i2rc5ZHdZBcdZ0sGbEAoNjM
 ok+XVlngU4mYxHETz4Pg6UOo
 --------------060800050806050201060204--
State-Changed-From-To: open->feedback 
State-Changed-By: bcr 
State-Changed-When: Tue Jun 26 18:17:46 UTC 2012 
State-Changed-Why:  
Set to feedback-state until we get an answer from the submitter about my patch.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=168939 
Responsible-Changed-From-To: bcr->freebsd-doc 
Responsible-Changed-By: bcr 
Responsible-Changed-When: Mon Mar 25 11:53:33 UTC 2013 
Responsible-Changed-Why:  
Back to the pool, not time to work on this at the moment. 

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