[pkgsrc/trunk]: pkgsrc/net/hub hub: Update to 2.7.0

[leot <leot%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/7a421f5391e5
branches:  trunk
changeset: 327412:7a421f5391e5
user:      leot <leot%pkgsrc.org@localhost>
date:      Tue Jan 01 00:17:29 2019 +0000

description:
hub: Update to 2.7.0

Changes:
2.7.0
-----
## Features
 * Add support for `hub pr list --state=merged`
 * Add base/head/merge commit SHA and merged date information to
   `hub pr list --format=FORMAT`
 * Un-deprecate converting issues to pull requests with
   `hub pull-request -i <issue>` 2a748a048d6903eca78332a484e63f8d647caf02

## Fixes
 * Improve detecting default `hub pull-request` base branch name
 * Avoid the `Aborted: the origin remote doesn't point to a GitHub repository`
   error by allowing other git remotes as fallback
 * Improve `hub create` dealing with an existing "origin" remote
 * Fix 256-color terminal support for macOS Terminal.app
 * Don't choke on literal `%` output characters when using `--format=FORMAT`
 * Replace deprecated Dial with DialContext

## Documentation
 * Document how we scan git remotes and branch tracking information
   https://hub.github.com/hub.1.html#CONVENTIONS
 * Indicate that long-form CLI flags with values must use the equal sign like `--message=VALUE`

diffstat:

 net/hub/Makefile    |   5 ++---
 net/hub/distinfo    |  10 +++++-----
 net/hub/files/hub.1 |  43 ++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 49 insertions(+), 9 deletions(-)

diffs (88 lines):

diff -r 15d96dab287a -r 7a421f5391e5 net/hub/Makefile
--- a/net/hub/Makefile  Mon Dec 31 23:03:02 2018 +0000
+++ b/net/hub/Makefile  Tue Jan 01 00:17:29 2019 +0000
@@ -1,7 +1,6 @@
-# $NetBSD: Makefile,v 1.14 2018/12/19 15:47:00 bsiegert Exp $
+# $NetBSD: Makefile,v 1.15 2019/01/01 00:17:29 leot Exp $
 
-DISTNAME=      hub-2.6.1
-PKGREVISION=   1
+DISTNAME=      hub-2.7.0
 CATEGORIES=    net
 MASTER_SITES=  ${MASTER_SITE_GITHUB:=github/}
 GITHUB_TAG=    v${PKGVERSION_NOREV}
diff -r 15d96dab287a -r 7a421f5391e5 net/hub/distinfo
--- a/net/hub/distinfo  Mon Dec 31 23:03:02 2018 +0000
+++ b/net/hub/distinfo  Tue Jan 01 00:17:29 2019 +0000
@@ -1,6 +1,6 @@
-$NetBSD: distinfo,v 1.8 2018/12/12 10:09:05 leot Exp $
+$NetBSD: distinfo,v 1.9 2019/01/01 00:17:29 leot Exp $
 
-SHA1 (hub-2.6.1.tar.gz) = 872a08ac985577518124cc75eadda63ccc447601
-RMD160 (hub-2.6.1.tar.gz) = 10537a5796d18c9e0267044a599f8028f7df29ca
-SHA512 (hub-2.6.1.tar.gz) = a3aed611455de88a5b410887717aeb28b8837a74b437848c53903ccc809e758678643471ee7b14903ee147417754b0d443aede63e4f69a0e4b252c6a5ab619e3
-Size (hub-2.6.1.tar.gz) = 994752 bytes
+SHA1 (hub-2.7.0.tar.gz) = 5742f0cd073cccbd1efa4071cc2dda47bf6685af
+RMD160 (hub-2.7.0.tar.gz) = e3b5fdf2aeffc5eafaff023ab13f4becab618c9e
+SHA512 (hub-2.7.0.tar.gz) = 77223b0860bac42195dfc43e9164f5da446e414e32d0d3caa931f30e5b06d6f65cd69caa2f5097285a91d2ddb48265dfedec9dd8b361417556ff38782fa1a17c
+Size (hub-2.7.0.tar.gz) = 997861 bytes
diff -r 15d96dab287a -r 7a421f5391e5 net/hub/files/hub.1
--- a/net/hub/files/hub.1       Mon Dec 31 23:03:02 2018 +0000
+++ b/net/hub/files/hub.1       Tue Jan 01 00:17:29 2019 +0000
@@ -91,7 +91,7 @@
 .
 .TP
 hub\-delete(1)
-Delete a repository on Github\.
+Delete a repository on GitHub\.
 .
 .TP
 hub\-fork(1)
@@ -117,6 +117,47 @@
 hub\-sync(1)
 Fetch from upstream and update local branches\.
 .
+.SH "CONVENTIONS"
+Most hub commands are supposed to be run in a context of an existing local git repository\. Hub will automatically detect the GitHub repository the current project belongs to by scanning its git 
remotes\.
+.
+.P
+In case there are multiple git remotes that are all pointing to GitHub, hub assumes that the main one is named "upstream", "github", or "origin", in that order of preference\.
+.
+.P
+When working with forks, it\'s recommended that the git remote for your own fork is named "origin" and that the git remote for the upstream repository is named "upstream"\. See 
\fIhttps://help\.github\.com/articles/configuring\-a\-remote\-for\-a\-fork/\fR
+.
+.P
+The default branch (usually "master") for the project is detected like so:
+.
+.IP "" 4
+.
+.nf
+
+git symbolic\-ref refs/remotes/origin/HEAD
+.
+.fi
+.
+.IP "" 0
+.
+.P
+where \fIorigin\fR is the name of the git remote for the upstream repository\.
+.
+.P
+The destination where the currently checked out branch is considered to be pushed to depends on the \fBgit config push\.default\fR setting\. If the value is "upstream" or "tracking", the tracking 
information for a branch is read like so:
+.
+.IP "" 4
+.
+.nf
+
+git rev\-parse \-\-symbolic\-full\-name BRANCH@{upstream}
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Otherwise, hub scans git remotes to find the first one for which \fBrefs/remotes/REMOTE/BRANCH\fR exists\. The "origin", "github", and "upstream" remotes are searched last because hub assumes that 
it\'s more likely that the current branch is pushed to your fork rather than to the canonical repo\.
+.
 .SH "CONFIGURATION"
 .
 .SS "GitHub OAuth authentication"