svn commit: r51452 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat
Date: Fri Mar  2 09:03:47 2018
New Revision: 51452
URL: https://svnweb.freebsd.org/changeset/doc/51452

Log:
  Replaces occurrences of 0.0.yyyymmdd by dyyyymmdd.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Tue Feb 27 17:54:32 2018	(r51451)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri Mar  2 09:03:47 2018	(r51452)
@@ -743,13 +743,14 @@ PORTEPOCH=	1</programlisting>
 	      looking 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
-	      <literal>0.0.<replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>
+	      <literal>d<replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>
 	      format, not
 	      <literal><replaceable>dd</replaceable>.<replaceable>mm</replaceable>.<replaceable>yyyy</replaceable></literal>
 	      or the non-Y2K compliant
 	      <literal><replaceable>yy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>
-	      format.  It is important to prefix the version with
-	      <literal>0.0.</literal> in case a release with an actual
+	      format.  It is important to prefix the version with a
+	      letter, here <literal>d</literal> (for date), in case a
+	      release with an actual
 	      version number is made, which would be
 	      numerically less than
 	      <literal><replaceable>yyyy</replaceable></literal>.</para>
@@ -935,8 +936,18 @@ PORTEPOCH=	1</programlisting>
 	<literal>piewm</literal> example above).  Otherwise, ask the
 	original author or use the date string the source file was
 	released on
-	(<literal>0.0.<replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
+	(<literal>d<replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>,
+	or
+	<literal>d<replaceable>yyyy</replaceable><replaceable>mm</replaceable><replaceable>dd</replaceable></literal>)
 	as the version.</para>
+
+      <tip>
+	<para>Use any letter. Here, <literal>d</literal> here stands
+	  for date, if the source is a <application>Git</application>
+	  repository, <literal>g</literal> followed by the commit date
+	  is commonly used, using <literal>s</literal> for snapshot is
+	  also common.</para>
+      </tip>
     </sect2>
   </sect1>