Date: Wed, 6 Mar 2013 13:23:04 GMT From: Frederic Culot <culot@FreeBSD.org> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/176685: porters-handbook: add a tip related to PORTEPOCH Message-ID: <201303061323.r26DN4sv087187@freefall.freebsd.org> Resent-Message-ID: <201303061330.r26DU4sw087410@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 176685 >Category: docs >Synopsis: porters-handbook: add a tip related to PORTEPOCH >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Mar 06 13:30:04 UTC 2013 >Closed-Date: >Last-Modified: >Originator: Frederic Culot >Release: FreeBSD 10.0-CURRENT amd64 >Organization: FreeBSD >Environment: System: FreeBSD freefall.freebsd.org 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r247807: Mon Mar 4 19:35:47 UTC 2013 peter@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL amd64 >Description: I believe the tip mentioned in the attached patch could be of some help to junior porters as it saves them the need to dive into bsd.port.mk to learn how the check for ports versions going backwards is done. Regards, Frederic >How-To-Repeat: >Fix: --- book.xml.diff begins here --- Index: book.xml =================================================================== --- book.xml (revision 41102) +++ book.xml (working copy) @@ -1025,6 +1025,19 @@ incorrectly treated as a newer version since 20000801 is a numerically greater value than 1).</para> + <tip> + <para>In some cases comparing versions is not that + straightforward and &man.pkg.version.1; could be helpful + to test a pair of version number strings. For example: + </para> + + <screen>&prompt.root; <userinput>pkg_version -t 0.031 0.29</userinput></screen> + + <para>indicates that version 0.031 is to be considered + greater than version 0.29, which is not obvious at + first.</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 --- book.xml.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201303061323.r26DN4sv087187>