CVS commit: pkgsrc/net/hub

["Leonardo Taccari" <leot%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   leot
Date:           Tue Jan  1 00:17:29 UTC 2019

Modified Files:
        pkgsrc/net/hub: Makefile distinfo
        pkgsrc/net/hub/files: hub.1

Log Message:
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`


To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 pkgsrc/net/hub/Makefile
cvs rdiff -u -r1.8 -r1.9 pkgsrc/net/hub/distinfo
cvs rdiff -u -r1.5 -r1.6 pkgsrc/net/hub/files/hub.1

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/net/hub/Makefile
diff -u pkgsrc/net/hub/Makefile:1.14 pkgsrc/net/hub/Makefile:1.15
--- pkgsrc/net/hub/Makefile:1.14        Wed Dec 19 15:47:00 2018
+++ pkgsrc/net/hub/Makefile     Tue Jan  1 00:17:29 2019
@@ -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}

Index: pkgsrc/net/hub/distinfo
diff -u pkgsrc/net/hub/distinfo:1.8 pkgsrc/net/hub/distinfo:1.9
--- pkgsrc/net/hub/distinfo:1.8 Wed Dec 12 10:09:05 2018
+++ pkgsrc/net/hub/distinfo     Tue Jan  1 00:17:29 2019
@@ -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

Index: pkgsrc/net/hub/files/hub.1
diff -u pkgsrc/net/hub/files/hub.1:1.5 pkgsrc/net/hub/files/hub.1:1.6
--- pkgsrc/net/hub/files/hub.1:1.5      Wed Dec 12 10:09:05 2018
+++ pkgsrc/net/hub/files/hub.1  Tue Jan  1 00:17:29 2019
@@ -91,7 +91,7 @@ Create a new repository on GitHub and ad
 .
 .TP
 hub\-delete(1)
-Delete a repository on Github\.
+Delete a repository on GitHub\.
 .
 .TP
 hub\-fork(1)
@@ -117,6 +117,47 @@ List and create GitHub releases\.
 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"