<pre style='margin:0'>
Rainer Müller (raimue) pushed a commit to branch master
in repository macports-ports.

</pre>
<p><a href="https://github.com/macports/macports-ports/commit/9ebf8f61b0a26cb0e1559df1710a50b793462f68">https://github.com/macports/macports-ports/commit/9ebf8f61b0a26cb0e1559df1710a50b793462f68</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 9ebf8f6  github portgroup: Remove docs moved to the guide
</span>9ebf8f6 is described below

<span style='display:block; white-space:pre;color:#808000;'>commit 9ebf8f61b0a26cb0e1559df1710a50b793462f68
</span>Author: Rainer Müller <raimue@macports.org>
AuthorDate: Tue Mar 13 13:04:38 2018 +0100

<span style='display:block; white-space:pre;color:#404040;'>    github portgroup: Remove docs moved to the guide
</span><span style='display:block; white-space:pre;color:#404040;'>    
</span><span style='display:block; white-space:pre;color:#404040;'>    Remove the documentation from the file to avoid duplication as it was
</span><span style='display:block; white-space:pre;color:#404040;'>    moved to the guide.
</span>---
 _resources/port1.0/group/github-1.0.tcl | 78 ++-------------------------------
 1 file changed, 4 insertions(+), 74 deletions(-)

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/_resources/port1.0/group/github-1.0.tcl b/_resources/port1.0/group/github-1.0.tcl
</span><span style='display:block; white-space:pre;color:#808080;'>index faee453..4043ea0 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/_resources/port1.0/group/github-1.0.tcl
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/_resources/port1.0/group/github-1.0.tcl
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -31,81 +31,11 @@
</span> #
 # This PortGroup accommodates projects hosted at GitHub.
 #
<span style='display:block; white-space:pre;background:#ffe0e0;'>-# Usage:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# After the PortSystem 1.0 line, put:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   PortGroup           github 1.0
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# Then, replace the name and version lines with:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   github.setup        author project version [tag_prefix]
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# The port's name will be set to the GitHub project name. If that's not correct,
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# override it by setting the port name as usual, for example:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   github.setup        someone someproject 1.2.3
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   name                myportname
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# The tag_prefix is optional, and refers to any characters that may appear
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# before the actual version number when you view the list of tags for this
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# project on GitHub. For example, if the tags are named like "v1.2.3" then
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# tag_prefix should be specified as "v":
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   github.setup        someone someproject 1.2.3 v
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# Some projects use GitHub's "releases" service to offer distfiles:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# Documentation:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# https://guide.macports.org/#reference.portgroup.github
</span> # 
<span style='display:block; white-space:pre;background:#ffe0e0;'>-# https://github.com/blog/1547-release-your-software
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# If the project offers a "release", that's probably the best distfile to use
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# for the port. To do this, use:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   github.tarball_from releases
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# GitHub imposes no naming convention for "release" distfiles, so you may need
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# to set distname as you would for other ports.
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# Older projects use the discontinued "downloads" service. New "downloads" can
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# no longer be created, but old ones are still available:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# https://github.com/blog/1302-goodbye-uploads
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# If the project doesn't have "releases" but does have "downloads", use them
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# this way (and set distname if needed):
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   github.tarball_from downloads
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# If neither "releases" nor "downloads" are available, GitHub can automatically
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# generate a distfile from a git tag or commit. This is the GitHub portgroup's
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# default behavior; to use this, simply don't set github.tarball_from. The
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# distname is irrelevant when fetching from a tag or commit, so don't set it
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# either.
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# If the project's developers do not tag their releases, encourage them to do
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# so. Until they do, or if you need to use a development version that's not
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# tagged, you can use a git commit hash and set the version field. If the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# project does not assign version numbers (or for development versions) you can
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# invent one, typically in the YYYYMMDD format corresponding to the date of the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# commit you picked. For example, if you want to use a commit with the hash
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# 0ff25277c3842598d919cd3c73d60768 that was committed on April 1, 2014, then
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# you would use:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   github.setup        someone someproject 0ff25277c3842598d919cd3c73d60768
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   version             20140401
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# Some projects' tag- or commit-based distfiles will not contain all the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# necessary files, if the project uses git submodules. If available, use a
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# distfile from "releases" or "downloads" instead, as described above. If the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# project does not provide those, encourage the project's developers to provide
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# releases. Until they do, fetch from git instead of from a distfile, and add a
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-# post-fetch block to fetch the submodules:
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   fetch.type          git
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   post-fetch {
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#       system -W ${worksrcpath} "git submodule update --init"
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-#   }
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# Documentation (sources):
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+# https://github.com/macports/macports-guide/blob/master/guide/xml/portgroup-github.xml
</span> 
 options github.author github.project github.version github.tag_prefix
 options github.homepage github.raw github.master_sites github.tarball_from
</pre><pre style='margin:0'>

</pre>