From owner-freebsd-ports@freebsd.org Sat Jun 8 18:37:32 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 21D5615B0138 for ; Sat, 8 Jun 2019 18:37:32 +0000 (UTC) (envelope-from adamw@adamw.org) Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 0F60E6DC94 for ; Sat, 8 Jun 2019 18:37:31 +0000 (UTC) (envelope-from adamw@adamw.org) Received: by mail-wm1-x342.google.com with SMTP id 207so84151wma.1 for ; Sat, 08 Jun 2019 11:37:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adamw-org.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=xykuTTg1RJLeW9YM1rtx64VMfpaWh/66W0TnE/jjUDs=; b=ea8dk9aK0H/YzrylzIZRkiHDD2ZjK2K1HIY+PTobwZypfTjK3aiLohD9UsEqKjtVeV qe5KA5pGE0/eI8PmmpnLwXhlJ1xvBypI77TLGRb4bglvLBNErOHbjBMouYHNaFMi8wIe OMVOiygVytS0o8GoXC9Z8yQPooci8xE/RyDLIhwG6KukniYx8SuFF1p+k1PRklCMIUg/ mGSeMZ5mN+WR85GmpdZn5wcbFjt1Apf/rVLHyBN2JNF/QxYFs5zalXZp6Nu50obAIr/t a6p32rTV2/WHLY//L5OhJLkNI9zuCWf+qKc48i4+NOz1I1U35jyN8U6oAOi+nuYd0isF ZL2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=xykuTTg1RJLeW9YM1rtx64VMfpaWh/66W0TnE/jjUDs=; b=hy+PFa4uBXt7AmxzKpxe/5dy++QPaCaHtA0Jk2OREAgwR/tV4rtD0pgz2cVf9eKvk8 n4ZCTfdp4RLobeepclIFl7vy8gBqq9aByQtHECOH1mq1WdvY4Mrm4e0m7RVc2dKIpDiI CLFkywVONKz+X0ESzz/fRaZxdVL35wkiN2FEUUh7tHEF8mlB/KfJ2d8zmYZ4VXb3kT6S Jc5T2F/93UwIzuP0pnm0OAjJZd32mAqSpKBHO1jIa9UH5KBXfNYxnipR1SG3wDOjYWu7 hwRyoQU32F6psV0jT6+uCKTnM5g3Nnk2MFDE4pQStKP5ioqlloAdnPblQBKN7U+q8WKu TbEQ== X-Gm-Message-State: APjAAAV1O1GecvKMPV2GyBUhGHWmm/r3o/eUIrActfo02MSmXH9gIsIN s3Wj6N4+WfUoH9FIuwMmB58bBVqGg37knAyWRDVYrTF08U4= X-Google-Smtp-Source: APXvYqzxtI6r6hJqCsNLLGCAZU0NrVjTo95eU+ncBm6HxZ4AjcgzBWVA9egrQeCEW7EvkRAARDrpCHd+SZX8pv/D1Kk= X-Received: by 2002:a05:600c:1150:: with SMTP id z16mr7406989wmz.168.1560019049989; Sat, 08 Jun 2019 11:37:29 -0700 (PDT) MIME-Version: 1.0 References: <20190608192918.5533b9c7@raksha.tavi.co.uk> In-Reply-To: <20190608192918.5533b9c7@raksha.tavi.co.uk> From: Adam Weinberger Date: Sat, 8 Jun 2019 12:37:14 -0600 Message-ID: Subject: Re: Cleaning up pkg-message To: Bob Eager Cc: FreeBSD Ports Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 0F60E6DC94 X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=adamw-org.20150623.gappssmtp.com header.s=20150623 header.b=ea8dk9aK; spf=pass (mx1.freebsd.org: domain of adamw@adamw.org designates 2a00:1450:4864:20::342 as permitted sender) smtp.mailfrom=adamw@adamw.org X-Spamd-Result: default: False [-3.62 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-0.999,0]; R_DKIM_ALLOW(-0.20)[adamw-org.20150623.gappssmtp.com:s=20150623]; FROM_HAS_DN(0.00)[]; R_SPF_ALLOW(-0.20)[+ip6:2a00:1450:4000::/36]; NEURAL_HAM_LONG(-1.00)[-1.000,0]; MIME_GOOD(-0.10)[text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-ports@freebsd.org]; DMARC_NA(0.00)[adamw.org]; TO_MATCH_ENVRCPT_SOME(0.00)[]; TO_DN_ALL(0.00)[]; DKIM_TRACE(0.00)[adamw-org.20150623.gappssmtp.com:+]; RCPT_COUNT_TWO(0.00)[2]; RCVD_IN_DNSWL_NONE(0.00)[2.4.3.0.0.0.0.0.0.0.0.0.0.0.0.0.0.2.0.0.4.6.8.4.0.5.4.1.0.0.a.2.list.dnswl.org : 127.0.5.0]; MX_GOOD(-0.01)[cached: alt1.aspmx.l.google.com]; IP_SCORE(-0.46)[ip: (2.42), ipnet: 2a00:1450::/32(-2.37), asn: 15169(-2.30), country: US(-0.06)]; NEURAL_HAM_SHORT(-0.65)[-0.652,0]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US]; RCVD_COUNT_TWO(0.00)[2] 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:37:32 -0000 On Sat, Jun 8, 2019 at 12:29 PM Bob Eager wrote: > > 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. Committers have the prerogative to alter pkg-message as required, but as the maintainer you have every right to object. Which port is it? I'd be happy to fix that for you. # Adam -- Adam Weinberger adamw@adamw.org https://www.adamw.org