From owner-svn-doc-all@FreeBSD.ORG Tue Feb 4 20:45:44 2014 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 ESMTPS id 6BD4E563; Tue, 4 Feb 2014 20:45:44 +0000 (UTC) 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 486ED18D2; Tue, 4 Feb 2014 20:45:44 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s14Kji4P049791; Tue, 4 Feb 2014 20:45:44 GMT (envelope-from mat@svn.freebsd.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s14KjiiJ049790; Tue, 4 Feb 2014 20:45:44 GMT (envelope-from mat@svn.freebsd.org) Message-Id: <201402042045.s14KjiiJ049790@svn.freebsd.org> From: Mathieu Arnold Date: Tue, 4 Feb 2014 20:45:44 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43774 - 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.17 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: Tue, 04 Feb 2014 20:45:44 -0000 Author: mat (ports committer) Date: Tue Feb 4 20:45:43 2014 New Revision: 43774 URL: http://svnweb.freebsd.org/changeset/doc/43774 Log: Remove the pkg_install bits in favor of the pkg ones. Sponsored by: Absolight 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 Tue Feb 4 20:36:22 2014 (r43773) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Tue Feb 4 20:45:43 2014 (r43774) @@ -261,7 +261,7 @@ lib/X11/oneko/cat2.xpm lib/X11/oneko/mouse.xpm @dirrm lib/X11/oneko - Refer to the &man.pkg.create.1; manual page for details + Refer to the &man.pkg-create.8; manual page for details on the packing list. @@ -314,7 +314,7 @@ PLIST_DIRS= lib/X11/onekoThe price for this way of listing port's files and directories is that you cannot use command sequences - described in &man.pkg.create.1;. Therefore, it is suitable + described in &man.pkg-create.8;. Therefore, it is suitable only for simple ports and makes them even simpler. At the same time, it has the advantage of reducing the number of files in the ports collection. Please consider using this @@ -407,11 +407,7 @@ PLIST_DIRS= lib/X11/oneko - pkg_add package-name - - Or, for users of pkg: - - pkg add package-name + pkg add package-filename @@ -975,8 +971,9 @@ DOS2UNIX_GLOB= *.c *.cpp *.hPORTREVISION are used by automated - tools (e.g., &man.pkg.version.1;) to highlight the fact - that a new package is available. + tools (e.g., pkg version, see + &man.pkg-version.8;) to highlight the fact that a new + package is available. PORTREVISION should be increased each time a change is made to the port that changes the @@ -1085,16 +1082,9 @@ DOS2UNIX_GLOB= *.c *.cpp *.h The results of version number comparisons are not - always obvious. &man.pkg.version.1; can be used to test - the comparison of two version number strings. The - pkgng equivalent is - pkg version -t. For example: - - &prompt.user; pkg_version -t 0.031 0.29 -> - - Or, for pkgng - users: + always obvious. pkg version (see + &man.pkg-version.8;) can be used to test the comparison + of two version number strings. For example: &prompt.user; pkg version -t 0.031 0.29 > @@ -3499,9 +3489,9 @@ ALWAYS_KEEP_DISTFILES= yes Try to keep the COMMENT value at no longer than 70 - characters, as this line will be used by the - &man.pkg.info.1; utility to display a one-line summary - of the port; + characters, as this line will be used by pkg + info (see &man.pkg-info.8;) to display a + one-line summary of the port; @@ -3628,8 +3618,9 @@ ALWAYS_KEEP_DISTFILES= yes build target and then from within the install target. Also, the name of the dependency is put into the package so that - &man.pkg.add.1; will automatically install it if it is not - on the user's system. + pkg install (see &man.pkg-install.8;) + will automatically install it if it is not on the user's + system. @@ -3682,9 +3673,10 @@ ALWAYS_KEEP_DISTFILES= yes The dependency is checked from within the install target. Also, the name of the dependency is put into the package so that - &man.pkg.add.1; will automatically install it if it is not - on the user's system. The target - part can be omitted if it is the same as + pkg install (see &man.pkg-install.8;) + will automatically install it if it is not on the user's + system. The target part can be + omitted if it is the same as DEPENDS_TARGET. A quite common situation is when @@ -10400,10 +10392,10 @@ lib/X11/oneko/sounds/cat.au @dirrmtry share/doc/gimp This will neither print any error messages nor cause - &man.pkg.delete.1; to exit abnormally even if - ${PREFIX}/share/doc/gimp - is not empty due to other ports installing some files in - there. + pkg delete (see &man.pkg-delete.8;) to + exit abnormally even if + ${PREFIX}/share/doc/gimp is not empty + due to other ports installing some files in there. @@ -10412,11 +10404,12 @@ lib/X11/oneko/sounds/cat.au Empty directories created during port installation need special attention. They will not get created when installing the package, because packages only store the - files, and &man.pkg.add.1; creates directories for them as - needed. To make sure the empty directory is created when - installing the package, add this line to - pkg-plist above the corresponding - @dirrm line: + files, and both pkg add and pkg + install creates directories for them as needed. + To make sure the empty directory is created when installing + the package, add this line to pkg-plist + above the corresponding @dirrm + line: @exec mkdir -p %D/share/foo/templates @@ -10428,9 +10421,9 @@ lib/X11/oneko/sounds/cat.au If your port installs configuration files to PREFIX/etc (or elsewhere) do not simply list them in the - pkg-plist. That will cause - &man.pkg.delete.1; to remove the files carefully edited by - the user, and a re-installation will wipe them out. + pkg-plist. That will cause pkg + delete to remove the files carefully edited by the + user, and a re-installation will wipe them out. Instead, install sample file(s) with a filename.sample @@ -10473,7 +10466,7 @@ etc/orbit.conf.sample -s flag to &man.cmp.1; for more output. - See &man.pkg.create.1; for more information on + See &man.pkg-create.8; for more information on %D and related substitution markers. If there is a very good reason not to install a working @@ -10558,8 +10551,8 @@ etc/orbit.conf.sample If you need to display a message to the installer, you may place the message in pkg-message. This capability is often useful to display additional installation - steps to be taken after a &man.pkg.add.1; or to display - licensing information. + steps to be taken after a pkg install or to + display licensing information. When some lines about the build-time knobs or warnings have to be displayed, use ECHO_MSG. The @@ -10587,18 +10580,18 @@ etc/orbit.conf.sample <filename>pkg-install</filename> If your port needs to execute commands when the binary - package is installed with &man.pkg.add.1; you can do this via - the pkg-install script. This script will + package is installed with pkg add or + pkg install you can do this via the + pkg-install script. This script will automatically be added to the package, and will be run twice - by &man.pkg.add.1;: the first time as ${SH} - pkg-install ${PKGNAME} PRE-INSTALL and the - second time as ${SH} pkg-install - ${PKGNAME} POST-INSTALL. - $2 can be tested to determine which - mode the script is being run in. The - PKG_PREFIX environmental variable will be set - to the package installation directory. See &man.pkg.add.1; - for additional information. + by pkg the first time as + ${SH} pkg-install ${PKGNAME} + PRE-INSTALL and the second time as + ${SH} pkg-install ${PKGNAME} + POST-INSTALL. $2 can be + tested to determine which mode the script is being run in. + The PKG_PREFIX environmental variable will be + set to the package installation directory. This script is not run automatically if you install the @@ -10616,11 +10609,11 @@ etc/orbit.conf.sample This script executes when a package is removed. - This script will be run twice by &man.pkg.delete.1;. - The first time as ${SH} pkg-deinstall - ${PKGNAME} DEINSTALL and the second time as - ${SH} pkg-deinstall ${PKGNAME} - POST-DEINSTALL. + This script will be run twice by pkg + delete The first time as ${SH} + pkg-deinstall ${PKGNAME} DEINSTALL and the + second time as ${SH} pkg-deinstall + ${PKGNAME} POST-DEINSTALL. @@ -11061,8 +11054,8 @@ as .putsy.conf and edit it.pkg_add -r for several + of pkg will otherwise continue to install + the old version via pkg install for several weeks.