From owner-freebsd-ports@freebsd.org  Sat Apr 23 23:56:29 2016
Return-Path: <owner-freebsd-ports@freebsd.org>
Delivered-To: freebsd-ports@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 8104BB1A38B
 for <freebsd-ports@mailman.ysv.freebsd.org>;
 Sat, 23 Apr 2016 23:56:29 +0000 (UTC) (envelope-from rde@tavi.co.uk)
Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org
 [IPv6:2001:1900:2254:206a::50:5])
 by mx1.freebsd.org (Postfix) with ESMTP id 6F2CA16FE
 for <freebsd-ports@freebsd.org>; Sat, 23 Apr 2016 23:56:29 +0000 (UTC)
 (envelope-from rde@tavi.co.uk)
Received: by mailman.ysv.freebsd.org (Postfix)
 id 6A918B1A38A; Sat, 23 Apr 2016 23:56:29 +0000 (UTC)
Delivered-To: ports@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6A313B1A389
 for <ports@mailman.ysv.freebsd.org>; Sat, 23 Apr 2016 23:56:29 +0000 (UTC)
 (envelope-from rde@tavi.co.uk)
Received: from kipling.tavi.co.uk (kipling.tavi.co.uk [81.187.145.130])
 by mx1.freebsd.org (Postfix) with ESMTP id 3221C16FD
 for <ports@freebsd.org>; Sat, 23 Apr 2016 23:56:28 +0000 (UTC)
 (envelope-from rde@tavi.co.uk)
Received: from raksha.tavi.co.uk (raksha.tavi.co.uk [81.187.145.139])
 by kipling.tavi.co.uk (Postfix) with ESMTP id 178B99CC61
 for <ports@freebsd.org>; Sun, 24 Apr 2016 00:56:20 +0100 (BST)
Date: Sun, 24 Apr 2016 00:56:20 +0100
From: Bob Eager <rde@tavi.co.uk>
To: ports@freebsd.org
Subject: Best way to submit a port upgrade
Message-ID: <20160424005620.43a31661@raksha.tavi.co.uk>
X-Mailer: Claws Mail 3.12.0 (GTK+ 2.24.28; i386-portbld-freebsd10.1)
Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAMFBMVEUwXjFLc0vD0cS7y7zw9PDZ4tkWSRaVrZZ+m39qi2tXfVj////7+/utwK4IPggAOAAJUUA7AAABKklEQVQ4jWPYjQMwDFYJp0NKEKCNJmEf9h8CsimXiL2e33s3/e7F7K2Cs3f3dCMkQkMKj4YuCY3K3iR+e7fMaiSjvkX0/5cFGrWpe2uLzOpaExUVqMS/8PX/Re5ey960OLBTZpFA8+IlSBKPQ92zNyUUBsosN58uIY0k8f+/ONCoYytkVuhWzVwNkYiYbqk5M3NmOVBi41YZ8RsGF7shEtFb5KJ3r969CyixM7OTPeFUxG2IxLO8/9/SvqXlc+/x3h295YzLlj2nIRJQj//nRvc5TEIal8RsXBLVuCQwIgoq/u80DomP6HEOk/iOS+IJLonZOCT+ReOQ+Lkbh0QKLonbOCR+7MYhsRqHBJrVcIl/1TgklqKLQyQ+tGKIgyQOqXpjig94diZRAgAXmDX6jyWafAAAAABJRU5ErkJggg======
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports/>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 23 Apr 2016 23:56:29 -0000

Background: I have created various ports, but I have never upgraded one
to a new version (i.e. from a new distfile) before.

I now have an upgrade to a new version of the port. I have:

- Updated Makefile
- Updated pkg-plist
- Updated distinfo
- New files in files/
- New patches in files/

I am slightly unsure how to submit this. The options seem to be:

a) A recursive diff (I know about 'port diff').
b) An svn diff

The svn diff is more work but if it is much preferred then I can do it.

However, what about comments on each of my changes? Should there be
annotation on what I have done, and how do I specify that in the PR?

Sorry - I know these are basic questions. I am experienced in general,
but not in submitting port upgrades!