From owner-freebsd-doc@FreeBSD.ORG Sun Jun 12 08:50:03 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DE1111065673 for ; Sun, 12 Jun 2011 08:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B4F478FC18 for ; Sun, 12 Jun 2011 08:50:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p5C8o25d007369 for ; Sun, 12 Jun 2011 08:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p5C8o22J007368; Sun, 12 Jun 2011 08:50:02 GMT (envelope-from gnats) Resent-Date: Sun, 12 Jun 2011 08:50:02 GMT Resent-Message-Id: <201106120850.p5C8o22J007368@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Chris Rees Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E3247106566C for ; Sun, 12 Jun 2011 08:40:32 +0000 (UTC) (envelope-from crees@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B94E58FC0C for ; Sun, 12 Jun 2011 08:40:32 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p5C8eWZD099693 for ; Sun, 12 Jun 2011 08:40:32 GMT (envelope-from crees@freefall.freebsd.org) Received: (from crees@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p5C8eWnu099686; Sun, 12 Jun 2011 08:40:32 GMT (envelope-from crees) Message-Id: <201106120840.p5C8eWnu099686@freefall.freebsd.org> Date: Sun, 12 Jun 2011 08:40:32 GMT From: Chris Rees To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/157792: [PATCH] Porter's Handbook clarification on date strings as PORTVERSIONs X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Chris Rees List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Jun 2011 08:50:03 -0000 >Number: 157792 >Category: docs >Synopsis: [PATCH] Porter's Handbook clarification on date strings as PORTVERSIONs >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: Sun Jun 12 08:50:02 UTC 2011 >Closed-Date: >Last-Modified: >Originator: Chris Rees >Release: FreeBSD 8.2-STABLE i386 >Organization: >Environment: System: FreeBSD freefall.freebsd.org 8.2-STABLE FreeBSD 8.2-STABLE #4 r220774: Mon Apr 18 13:56:14 UTC 2011 simon@freefall.freebsd.org:/usr/obj/usr/src/sys/FREEFALL i386 >Description: The Porter's Handbook recommends using the date string (yyyy.mm.dd) as the version for a port if there's no version around, which unfortunately causes problems when version [e.g.] 3.4.1.3 is found. This would cause a PORTEPOCH bump, which no-one likes. I've changed to suggested version string to 0.0.yyyy.mm.dd with a short explanation. >How-To-Repeat: >Fix: --- doc-phandbook-yymmdd-patch.diff begins here --- Index: en_US.ISO8859-1/books/porters-handbook/book.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1108 diff -u -r1.1108 book.sgml --- en_US.ISO8859-1/books/porters-handbook/book.sgml 3 Jun 2011 15:02:58 -0000 1.1108 +++ en_US.ISO8859-1/books/porters-handbook/book.sgml 12 Jun 2011 08:36:39 -0000 @@ -1210,12 +1210,15 @@ at the version string. In particular, make sure version number components are always delimited by a period, and if the date is part of the string, use the - yyyy.mm.dd + 0.0.yyyy.mm.dd format, not dd.mm.yyyy or the non-Y2K compliant yy.mm.dd - format. + format. It is important to prefix the version with + 0.0. in case a release with an actual version + number is made, which would of course be numerically less than + yyyy. @@ -1357,7 +1360,7 @@ release another version, just set the version string to 1.0 (like the piewm example above). Otherwise, ask the original author or use the date string - (yyyy.mm.dd) + (0.0.yyyy.mm.dd) as the version. --- doc-phandbook-yymmdd-patch.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: