Date: Mon, 28 Oct 2013 19:24:11 +0000 (UTC) From: Eitan Adler <eadler@FreeBSD.org> 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 Message-ID: <201310281924.r9SJOB1t001243@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 <title>Automated Package List Creation</title> <para>First, make sure your port is almost complete, with only - <filename>pkg-plist</filename> missing.</para> + <filename>pkg-plist</filename> missing. You may then run + <command>make <maketarget>makeplist</maketarget></command> to + generate a <filename>pkg-plist</filename> automatically. Thie + file must be double checked for correctness.</para> - <para>Next, create a temporary directory tree into which your - port can be installed, and install any dependencies.</para> - - <screen>&prompt.root; <userinput>mkdir /var/tmp/`make -V PORTNAME`</userinput> -&prompt.root; <userinput>mtree -U -f `make -V MTREE_FILE` -d -e -p /var/tmp/`make -V PORTNAME`</userinput> -&prompt.root; <userinput>make depends PREFIX=/var/tmp/`make -V PORTNAME`</userinput></screen> - - <para>Store the directory structure in a new file.</para> - - <screen>&prompt.root; <userinput>(cd /var/tmp/`make -V PORTNAME` && find -d * -type d) | sort > OLD-DIRS</userinput></screen> - - <para>Create an empty <filename>pkg-plist</filename> - file:</para> - - <screen>&prompt.root; <userinput>:>pkg-plist</userinput></screen> - - <para>If your port honors <makevar>PREFIX</makevar> (which it - should) you can then install the port and create the package - list.</para> - - <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/`make -V PORTNAME`</userinput> -&prompt.root; <userinput>(cd /var/tmp/`make -V PORTNAME` && find -d * \! -type d) | sort > pkg-plist</userinput></screen> - - <para>You must also add any newly created directories to the - packing list.</para> - - <screen>&prompt.root; <userinput>(cd /var/tmp/`make -V PORTNAME` && find -d * -type d) | sort | comm -13 OLD-DIRS - | sort -r | sed -e 's#^#@dirrm #' >> pkg-plist</userinput></screen> - - <para>Finally, you need to tidy up the packing list by hand; it - is not <emphasis>all</emphasis> automated. - User configuration files should be + <para>User configuration files should be removed, or installed as <filename><replaceable>filename</replaceable>.sample</filename>. The <filename>info/dir</filename> file should not be listed @@ -10137,10 +10110,7 @@ etc/orbit.conf.sample <para>Alternatively, use the <command>plist</command> script in <filename>/usr/ports/Tools/scripts/</filename> to build the - package list automatically. The <filename>plist</filename> - script is a <application>Ruby</application> script that - automates most of the manual steps outlined in the previous - paragraphs.</para> + package list automatically.</para> <para>The first step is the same as above: take the first three lines, that is, <command>mkdir</command>,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310281924.r9SJOB1t001243>