Date: Fri, 3 May 2002 00:02:59 +0100 (BST) From: Harry Newton <harry_newton@telinco.co.uk> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/37693: Minor correxion to FreeBSD Porter's Handbook Message-ID: <200205022302.g42N2xd61725@basilisk.locus>
index | next in thread | raw e-mail
>Number: 37693
>Category: docs
>Synopsis: Minor correxion to FreeBSD Porter's Handbook
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu May 02 16:10:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator: Harry Newton
>Release: FreeBSD 4.5-STABLE i386
>Organization:
Gaudeamus
>Environment:
System: FreeBSD basilisk.locus 4.5-STABLE FreeBSD 4.5-STABLE #0: Sat Mar 16 20:08:45 GMT 2002 harry@basilisk.locus:/usr/obj/usr/src/sys/BASILISK i386
>Description:
A couple of mistakes / clarifications in Chapter 17, The FreeBSD Porter's
Handbook 'Automated package list creation'.
- Don't need to touch pkg-plist beforehand, in fact unless the >> operator
is used, this will give an error later on.
- small grammatical mistake ( 'into' missing )
- comm(1) requires input lines to be lexigraphically sorted, otherwise the
command doesn't work as expected. Failure to sort causes extra lines of the
@dirrm sort to be added to the packing list.
>How-To-Repeat:
Refer to Chapter 17 of FreeBSD Porter's Handbook
>Fix:
--- book.sgml Thu May 2 23:43:55 2002
+++ book.sgml_original Thu May 2 23:33:29 2002
@@ -3878,18 +3878,20 @@
<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. Create an empty
+ <filename>pkg-plist</filename>.</para>
- <para>Next, create a temporary set of directories into which
- your port can be installed, and install any
- dependencies.</para>
+ <screen>&prompt.root; <userinput>touch pkg-plist</userinput></screen>
+
+ <para>Next, create a new set of directories which your port can be
+ installed, and install any dependencies.</para>
<screen>&prompt.root; <userinput>mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/<replaceable>port-name</replaceable></userinput>
&prompt.root; <userinput>make depends PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>
<para>Store the directory structure in a new file.</para>
- <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) | sort - > OLD-DIRS</userinput></screen>
+ <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) > OLD-DIRS</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>
@@ -3900,7 +3902,7 @@
<para>You must also add any newly created directories to the packing
list.</para>
- <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) | sort - | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm #' >> pkg-plist</userinput></screen>
+ <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name && find -d * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm #' >> pkg-plist</replaceable></userinput></screen>
<para>Finally, you need to tidy up the packing list by hand; it isn't
<emphasis>all</emphasis> automated. Manual pages should be listed in
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200205022302.g42N2xd61725>