From owner-svn-doc-all@FreeBSD.ORG Mon Oct 28 19:24:12 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 2D3AF364; Mon, 28 Oct 2013 19:24:12 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 1A0742789; Mon, 28 Oct 2013 19:24:12 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9SJOB5O001244; Mon, 28 Oct 2013 19:24:11 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9SJOB1t001243; Mon, 28 Oct 2013 19:24:11 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201310281924.r9SJOB1t001243@svn.freebsd.org> From: Eitan Adler Date: Mon, 28 Oct 2013 19:24:11 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43056 - head/en_US.ISO8859-1/books/porters-handbook X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 Oct 2013 19:24:12 -0000 Author: eadler Date: Mon Oct 28 19:24:11 2013 New Revision: 43056 URL: http://svnweb.freebsd.org/changeset/doc/43056 Log: Explain a much better way of automatically generating a packing list now that makeplist is available. Leave mention of the older scripts as long as they exist. Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Oct 28 19:17:08 2013 (r43055) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Oct 28 19:24:11 2013 (r43056) @@ -10092,39 +10092,12 @@ etc/orbit.conf.sample Automated Package List Creation First, make sure your port is almost complete, with only - pkg-plist missing. + pkg-plist missing. You may then run + make makeplist to + generate a pkg-plist automatically. Thie + file must be double checked for correctness. - Next, create a temporary directory tree into which your - port can be installed, and install any dependencies. - - &prompt.root; mkdir /var/tmp/`make -V PORTNAME` -&prompt.root; mtree -U -f `make -V MTREE_FILE` -d -e -p /var/tmp/`make -V PORTNAME` -&prompt.root; make depends PREFIX=/var/tmp/`make -V PORTNAME` - - Store the directory structure in a new file. - - &prompt.root; (cd /var/tmp/`make -V PORTNAME` && find -d * -type d) | sort > OLD-DIRS - - Create an empty pkg-plist - file: - - &prompt.root; :>pkg-plist - - If your port honors PREFIX (which it - should) you can then install the port and create the package - list. - - &prompt.root; make install PREFIX=/var/tmp/`make -V PORTNAME` -&prompt.root; (cd /var/tmp/`make -V PORTNAME` && find -d * \! -type d) | sort > pkg-plist - - You must also add any newly created directories to the - packing list. - - &prompt.root; (cd /var/tmp/`make -V PORTNAME` && find -d * -type d) | sort | comm -13 OLD-DIRS - | sort -r | sed -e 's#^#@dirrm #' >> pkg-plist - - Finally, you need to tidy up the packing list by hand; it - is not all automated. - User configuration files should be + User configuration files should be removed, or installed as filename.sample. The info/dir file should not be listed @@ -10137,10 +10110,7 @@ etc/orbit.conf.sample Alternatively, use the plist script in /usr/ports/Tools/scripts/ to build the - package list automatically. The plist - script is a Ruby script that - automates most of the manual steps outlined in the previous - paragraphs. + package list automatically. The first step is the same as above: take the first three lines, that is, mkdir,