From owner-svn-doc-head@FreeBSD.ORG Wed Mar 6 16:13:12 2013 Return-Path: <owner-svn-doc-head@FreeBSD.ORG> Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 4F603D53; Wed, 6 Mar 2013 16:13:12 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 3D6683E7; Wed, 6 Mar 2013 16:13:12 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r26GDC6w081629; Wed, 6 Mar 2013 16:13:12 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r26GDCu9081628; Wed, 6 Mar 2013 16:13:12 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201303061613.r26GDCu9081628@svn.freebsd.org> From: Warren Block <wblock@FreeBSD.org> Date: Wed, 6 Mar 2013 16:13:12 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41106 - 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-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head <svn-doc-head.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-head>, <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head> List-Post: <mailto:svn-doc-head@freebsd.org> List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>, <mailto:svn-doc-head-request@freebsd.org?subject=subscribe> X-List-Received-Date: Wed, 06 Mar 2013 16:13:12 -0000 Author: wblock Date: Wed Mar 6 16:13:11 2013 New Revision: 41106 URL: http://svnweb.freebsd.org/changeset/doc/41106 Log: Add tip showing the use of pkg_version to test version number strings. Modified version of patch submitted by Frederic Culot with pkgng addition suggested by Jason Helfman. PR: docs/176685 Submitted by: Frederic Culot <culot@FreeBSD.org> 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 Wed Mar 6 16:02:19 2013 (r41105) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Wed Mar 6 16:13:11 2013 (r41106) @@ -1025,6 +1025,27 @@ DOS2UNIX_REGEX= .*\.(c|cpp|h)</programli incorrectly treated as a newer version since 20000801 is a numerically greater value than 1).</para> + <tip> + <para>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 + <application>pkgng</application> equivalent is + <command>pkg version -t</command>. For example:</para> + + <screen>&prompt.user; <userinput>pkg_version -t 0.031 0.29</userinput> +></screen> + + <para>Or, for <application>pkgng</application> + users:</para> + + <screen>&prompt.user; <userinput>pkg version -t 0.031 0.29</userinput> +></screen> + + <para>The <literal>></literal> output indicates that + version 0.031 is considered greater than version 0.29, + which may not have been obvious to the porter.</para> + </tip> + <para>In situations such as this, the <makevar>PORTEPOCH</makevar> version should be increased. If <makevar>PORTEPOCH</makevar> is nonzero it is appended