From owner-freebsd-ports@freebsd.org Sat Jun 8 18:29:31 2019 Return-Path: Delivered-To: freebsd-ports@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6E4DF15AFCCA for ; Sat, 8 Jun 2019 18:29:31 +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 18ED06D75D for ; Sat, 8 Jun 2019 18:29:27 +0000 (UTC) (envelope-from rde@tavi.co.uk) Received: from kipling.tavi.co.uk (localhost [127.0.0.1]) by kipling.tavi.co.uk (Postfix) with ESMTP id CC3CD3E970 for ; Sat, 8 Jun 2019 19:29:18 +0100 (BST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=tavi.co.uk; h=date:from:to :subject:message-id:in-reply-to:references:mime-version :content-type:content-transfer-encoding; s=selector1; bh=yGiZ5eX bdNKyzY8I1XGbzBthUCY=; b=YIxXacwfmBCCBaT6Rxh3RfKFhPUVzK8BP7ydxlC 3Pbmk6gC8x2tAFJ3VUKU5MaM+pLBmtZ7Bw4U5Nmhn8x0VUJ8k3PRcFH+dpODSruG PEiNOeBDCxVBD8cvlPTHHr4zMujPD2Iv2pZ4lFrFIzw6PyTKwaO0S23+NUc1ucrq Wr+A= Received: from raksha.tavi.co.uk (raksha.tavi.co.uk [81.187.145.139]) (Authenticated sender: rde@tavi.co.uk) by kipling.tavi.co.uk (Postfix) with ESMTPA id 96C593E446 for ; Sat, 8 Jun 2019 19:29:18 +0100 (BST) Date: Sat, 8 Jun 2019 19:29:18 +0100 From: Bob Eager To: freebsd-ports@freebsd.org Subject: Re: Cleaning up pkg-message Message-ID: <20190608192918.5533b9c7@raksha.tavi.co.uk> In-Reply-To: References: X-Mailer: Claws Mail 3.16.0 (GTK+ 2.24.32; amd64-portbld-freebsd11.2) 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-Rspamd-Queue-Id: 18ED06D75D X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=tavi.co.uk header.s=selector1 header.b=YIxXacwf; dmarc=pass (policy=none) header.from=tavi.co.uk; spf=pass (mx1.freebsd.org: domain of rde@tavi.co.uk designates 81.187.145.130 as permitted sender) smtp.mailfrom=rde@tavi.co.uk X-Spamd-Result: default: False [-4.51 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; R_DKIM_ALLOW(-0.20)[tavi.co.uk:s=selector1]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; FROM_HAS_DN(0.00)[]; R_SPF_ALLOW(-0.20)[+a:kipling.tavi.co.uk]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-ports@freebsd.org]; TO_DN_NONE(0.00)[]; RCPT_COUNT_ONE(0.00)[1]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; RCVD_COUNT_THREE(0.00)[3]; DKIM_TRACE(0.00)[tavi.co.uk:+]; DMARC_POLICY_ALLOW(-0.50)[tavi.co.uk,none]; MX_GOOD(-0.01)[kipling.tavi.co.uk,khan.tavi.co.uk,mx444501.smtp-engine.com]; NEURAL_HAM_SHORT(-0.88)[-0.877,0]; RCVD_NO_TLS_LAST(0.10)[]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; IP_SCORE(-0.72)[asn: 20712(-3.53), country: GB(-0.09)]; ASN(0.00)[asn:20712, ipnet:81.187.0.0/16, country:GB] X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 08 Jun 2019 18:29:31 -0000 On Sat, 8 Jun 2019 12:16:05 -0600 Adam Weinberger wrote: > I want to get some stakeholder input on our pkg-message files. I think > we need to have a clear policy about what does and doesn't belong in > them, and I'd like to get your input. I agree. I recently noticed that one of my ports had been modified by the previous committer. I had a pkg-message which was short and contained concise, minimal information. I also has a README file, installed in /usr/local/share/doc/... if the DOCS option was selected. The committer folded the README file into pkg-message, and I disagree with this: 1) It added far too much bulk to pkg-message. 2) It meant that an end user (without access to the ports tree) didn't have an immediate way to see the README contents. 3) The committer tacked the README file onto pkg-message without noticing that there was a %%DOCSDIR%% to be expanded, so that is how it appears in pkg-message.