<pre style='margin:0'>
Ryan Schmidt (ryandesign) pushed a commit to branch master
in repository macports-guide.
</pre>
<p><a href="https://github.com/macports/macports-guide/commit/e095a93e13cd4995d6b3bebaddb8a34df286536b">https://github.com/macports/macports-guide/commit/e095a93e13cd4995d6b3bebaddb8a34df286536b</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit e095a93e13cd4995d6b3bebaddb8a34df286536b
</span>Author: Ryan Schmidt <ryandesign@macports.org>
AuthorDate: Sat Aug 22 04:18:44 2020 -0500
<span style='display:block; white-space:pre;color:#404040;'> Rewrite version section
</span>---
guide/xml/portfile-keywords.xml | 16 +++++++++++++++-
1 file changed, 15 insertions(+), 1 deletion(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-keywords.xml b/guide/xml/portfile-keywords.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 414aa52..db9748b 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-keywords.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-keywords.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -48,7 +48,21 @@
</span> <term>version</term>
<listitem>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <para>The version of the ported software.</para>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <para>The version of the software. Version numbers are often dotted
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ decimals, though some projects may use other formats.</para>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <para>The version keyword should adhere as closely as possible to the
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ format used by the upstream project (e.g., as reported by a program's
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <literal>-v</literal> or <literal>--version</literal> flag or on the
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ project's web site), omitting any preceding <literal>v</literal> or
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ other extraneous characters that are not part of the version number.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ Especially, the version should not be misformatted merely to accommodate
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ an unusual distfile name. For example, if the distfile name is
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <literal>foo-v1_2_3.tar.gz</literal> and the project reports its version
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ as <literal>v1.2.3</literal>, the version keyword should be set to
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <literal>1.2.3</literal> and distname should be overridden as needed
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ (ideally by transforming the version using a procedure such as
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <code>string map</code>).</para>
</span>
<programlisting>version 1.23.45</programlisting>
</listitem>
</pre><pre style='margin:0'>
</pre>