<pre style='margin:0'>
Christopher Nielsen (mascguy) pushed a commit to branch master
in repository macports-guide.
</pre>
<p><a href="https://github.com/macports/macports-guide/commit/9a1d2f2256206ce8d97d04de52fcfda34ec3061d">https://github.com/macports/macports-guide/commit/9a1d2f2256206ce8d97d04de52fcfda34ec3061d</a></p>
<pre style="white-space: pre; background: #F8F8F8">The following commit(s) were added to refs/heads/master by this push:
<span style='display:block; white-space:pre;color:#404040;'> new 9a1d2f2 Add info on https://ports.macports.org to buildbot section, #63001
</span>9a1d2f2 is described below
<span style='display:block; white-space:pre;color:#808000;'>commit 9a1d2f2256206ce8d97d04de52fcfda34ec3061d
</span>Author: Jim DeLaHunt <from+project_by_git@jdlh.com>
AuthorDate: Sun May 30 21:26:30 2021 -0700
<span style='display:block; white-space:pre;color:#404040;'> Add info on https://ports.macports.org to buildbot section, #63001
</span><span style='display:block; white-space:pre;color:#404040;'>
</span><span style='display:block; white-space:pre;color:#404040;'> Guide section 4.8. "MacPorts' buildbot" did not mention the web page
</span><span style='display:block; white-space:pre;color:#404040;'> at https://ports.macports.org/ at all. Add a one-paragraph summary of
</span><span style='display:block; white-space:pre;color:#404040;'> what this page can do for port developers to the end of the section.
</span><span style='display:block; white-space:pre;color:#404040;'>
</span><span style='display:block; white-space:pre;color:#404040;'> Also, the previous part of the section mentioned the "waterfall" and
</span><span style='display:block; white-space:pre;color:#404040;'> "builders" pages on the https://build.macports.org web page, but did not
</span><span style='display:block; white-space:pre;color:#404040;'> mention the URL itself. So I added that URL. Also resequence the
</span><span style='display:block; white-space:pre;color:#404040;'> sentences to soften the claim that these views are "most useful", since
</span><span style='display:block; white-space:pre;color:#404040;'> I don't think these views are as good as the ports.macports.org page.
</span><span style='display:block; white-space:pre;color:#404040;'>
</span><span style='display:block; white-space:pre;color:#404040;'> This addresses Trac ticket #63001, "Guide: add description of web app
</span><span style='display:block; white-space:pre;color:#404040;'> at ports.macports.org", https://trac.macports.org/ticket/63001 .
</span>---
guide/adoc/portfiledev.adoc | 13 +++++++++++--
guide/xml/portfiledev.xml | 32 ++++++++++++++++++++++++--------
2 files changed, 35 insertions(+), 10 deletions(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/adoc/portfiledev.adoc b/guide/adoc/portfiledev.adoc
</span><span style='display:block; white-space:pre;color:#808080;'>index bf08362..66d616f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/adoc/portfiledev.adoc
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/adoc/portfiledev.adoc
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -968,7 +968,16 @@ See the https://build.macports.org/builders[list
</span> of builders] to find out which platforms these currently are.
If a build error occurred for a port its maintainer will be informed via an email so that problems which did not surface on the maintainer's machine will not go unnoticed.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-Port maintainers will find the https://build.macports.org/waterfall[waterfall] and the https://build.macports.org/builders[builders] views most useful since they give information about the build status and offer the possibility to build one's port(s) on specific builders.
</span>
Thus the buildbot helps to keep MacPorts consistent on various macOS versions, i.e., a maintainer does not need access to these versions anymore in order to assure that the port(s) maintained build without problems.
<span style='display:block; white-space:pre;background:#ffe0e0;'>-Currently only the default port variants will be built and kept.
</span>\ No newline at end of file
<span style='display:block; white-space:pre;background:#e0ffe0;'>+Currently only the default port variants will be built and kept.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+The web page at https://build.macports.org/[build.macports.org] offers several views of the recent builds and of their success.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Port maintainers will find the https://build.macports.org/waterfall[waterfall] and the https://build.macports.org/builders[builders] views most useful since they give information about the build status and offer the possibility to build one's port(s) on specific builders.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Also, a web page at https://ports.macports.org/[ports.macports.org] provides an alternate view of buildbot activity.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Enter the name of the port you are interested in.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+That takes you to a summary page, which shows the success or failure of the last recorded build on each OS version.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+See the "Port Health" indicators near the top.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Click on those indicators to to see a description of the latest build on build.macports.org.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Click the Build Information tab to see all recorded builds.
</span><span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfiledev.xml b/guide/xml/portfiledev.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index ee56ba6..6027e9c 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfiledev.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfiledev.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1147,20 +1147,36 @@ categories kde finance
</span>
<para>If a build error occurred for a port its maintainer will be informed via
an email so that problems which did not surface on the maintainer's machine will
<span style='display:block; white-space:pre;background:#ffe0e0;'>- not go unnoticed.
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- Port maintainers will find the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- <link xlink:href="https://build.macports.org/waterfall">waterfall</link>
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- and the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- <link xlink:href="https://build.macports.org/builders">builders</link>
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- views most useful since they give information about the build status and offer
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- the possibility to build one's port(s) on specific builders.</para>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ not go unnoticed.</para>
</span>
<para>Thus the buildbot helps to keep MacPorts consistent on various
macOS versions, i.e., a maintainer does not need access to these versions anymore in
order to assure that the port(s) maintained build without problems. Currently only
the default port variants will be built and kept.</para>
<span style='display:block; white-space:pre;background:#e0ffe0;'>+ <para>The web page at
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <link xlink:href="https://build.macports.org/">build.macports.org</link>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ offers several views of the recent builds and of their success.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ Port maintainers will find the
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <link xlink:href="https://build.macports.org/waterfall">waterfall</link>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ and the
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <link xlink:href="https://build.macports.org/builders">builders</link>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ views most useful, since they give information about the build status
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ and offer the possibility to build one's port(s) on specific builders.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ </para>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <para>Also, a web page at
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <link xlink:href="https://ports.macports.org/">ports.macports.org</link>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ provides an alternate view of buildbot activity.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ Enter the name of the port you are interested in.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ That takes you to a summary page, which shows the success or failure of
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ the last recorded build on each OS version.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ See the "Port Health" indicators near the top.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ Click on those indicators to to see a description of the latest build on
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ build.macports.org.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ Click the Build Information tab to see all recorded builds.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ </para>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> </section>
</chapter>
</pre><pre style='margin:0'>
</pre>