<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>