os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

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

Browse source 
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
1 changed files with 11 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

18
en_US.ISO8859-1/books/porters-handbook/book.sgml
View file

@ -1210,12 +1210,16 @@ PORTEPOCH= 1</programlisting>
at the version string. In particular, make sure version at the version string. In particular, make sure version
number components are always delimited by a period, and number components are always delimited by a period, and
if the date is part of the string, use the 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 format, not
<literal><replaceable>dd</replaceable>.<replaceable>mm</replaceable>.<replaceable>yyyy</replaceable></literal> <literal><replaceable>dd</replaceable>.<replaceable>mm</replaceable>.<replaceable>yyyy</replaceable></literal>
or the non-Y2K compliant or the non-Y2K compliant
<literal><replaceable>yy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal> <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> </listitem>
</orderedlist> </orderedlist>
@ -1353,11 +1357,11 @@ PORTEPOCH= 1</programlisting>
</informaltable> </informaltable>
<para>If there is absolutely no trace of version information in the <para>If there is absolutely no trace of version information in the
original source and it is unlikely that the original author will ever original source and it is unlikely that the original author will
release another version, just set the version string to ever release another version, just set the version string to
<literal>1.0</literal> (like the <literal>piewm</literal> example above). Otherwise, ask <literal>1.0</literal> (like the <literal>piewm</literal> example
the original author or use the date string above). Otherwise, ask the original author or use the date string
(<literal><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>) (<literal>0.0.<replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
as the version.</para> as the version.</para>
</sect2> </sect2>
</sect1> </sect1>