Change the date string for a port that has no version to something

that does not bump PORTEPOCH (which no one likes) and add a short
explanation.

PR:		docs/157792
Submitted by:	crees@
This commit is contained in:
Benedict Reuschling 2011-06-14 16:50:39 +00:00
parent e2409a9a4e
commit a88e07ba96
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=37382

View file

@ -1210,12 +1210,16 @@ PORTEPOCH= 1</programlisting>
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><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>
<literal>0.0.<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.</para>
format. It is important to prefix the version with
<literal>0.0.</literal> in case a release with an actual
version number is made, which would of course be numerically
less than
<literal><replaceable>yyyy</replaceable></literal>.</para>
</listitem>
</orderedlist>
@ -1353,11 +1357,11 @@ PORTEPOCH= 1</programlisting>
</informaltable>
<para>If there is absolutely no trace of version information in the
original source and it is unlikely that the original author will ever
release another version, just set the version string to
<literal>1.0</literal> (like the <literal>piewm</literal> example above). Otherwise, ask
the original author or use the date string
(<literal><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
original source and it is unlikely that the original author will
ever release another version, just set the version string to
<literal>1.0</literal> (like the <literal>piewm</literal> example
above). Otherwise, ask the original author or use the date string
(<literal>0.0.<replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
as the version.</para>
</sect2>
</sect1>