<pre style='margin:0'>
Marcus Calhoun-Lopez (MarcusCalhoun-Lopez) pushed a commit to branch master
in repository macports-ports.

</pre>
<p><a href="https://github.com/macports/macports-ports/commit/9c671597c599deb9950a36b4cad0a154c7b8b86a">https://github.com/macports/macports-ports/commit/9c671597c599deb9950a36b4cad0a154c7b8b86a</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit 9c671597c599deb9950a36b4cad0a154c7b8b86a
</span>Author: Marcus Calhoun-Lopez <mcalhoun@macports.org>
AuthorDate: Sat Mar 11 01:28:26 2023 -0700

<span style='display:block; white-space:pre;color:#404040;'>    lua: add comments
</span>---
 lang/lua/Portfile | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/lang/lua/Portfile b/lang/lua/Portfile
</span><span style='display:block; white-space:pre;color:#808080;'>index 92ecf603d21..76478c6dba5 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/lang/lua/Portfile
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/lang/lua/Portfile
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -3,6 +3,21 @@
</span> PortSystem                  1.0
 PortGroup                   makefile    1.0
 
<span style='display:block; white-space:pre;background:#e0ffe0;'>+# each version of Lua can (and does) break backwards compatibility
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# see, e.g.,
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     https://trac.macports.org/ticket/40423
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     https://trac.macports.org/ticket/46621#comment:20
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# so each major.minor version of Lua gets its own subport
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# if the `version` of the main port changes, please update `lua.default_version` in the lua PortGroup
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# increasing revisions of dependents:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     increasing the revision of dependents of subports should not be necessary since only the patch version of the subports change
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     if the major or minor version of the main port changes, increasing the revisions of dependents may be necessary if:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#         *) the `compat_branch` value increases as well
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#         *) the dependent port uses `lua.default_version`, whose values should be updated as well
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#         *) the dependent port uses `lua.modules`, whose versions will change
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> name                        lua
 conflicts                   lua50
 version                     5.3.6
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -22,6 +37,15 @@ checksums                   rmd160  cc715df991bccaec75a022404902200d984b002e \
</span>                             sha256  fc5fd69bb8736323f026672b1b7235da613d7177e72558893a0bdcd320466d60 \
                             size    303770
 
<span style='display:block; white-space:pre;background:#e0ffe0;'>+# Semantic Versioning uses x.y.z as the "version"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# in the Lua nomenclature, x.y is the version and z is the release
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     this causes notation conflict within the port
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     the lua PG has an option `lua.version` for consistency with the Lua language
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     the Portfile uses the name branch to avoid conflict with the MacPorts concept of version
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# see
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     https://semver.org
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+#     https://www.lua.org/versions.html
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> subport                     ${name} {
     patchfiles              patch-src-Makefile.diff
 
</pre><pre style='margin:0'>

</pre>