Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 8 Jun 2019 12:37:14 -0600
From:      Adam Weinberger <adamw@adamw.org>
To:        Bob Eager <rde@tavi.co.uk>
Cc:        FreeBSD Ports <freebsd-ports@freebsd.org>
Subject:   Re: Cleaning up pkg-message
Message-ID:  <CAP7rwcgthT%2Bg-hOwEwJdntOwK7AmqC1FRfHx7Xdua5HS_aB=KQ@mail.gmail.com>
In-Reply-To: <20190608192918.5533b9c7@raksha.tavi.co.uk>
References:  <CAP7rwcin2C6LbKTKzDYe1Y1mzZN%2Bu7J-5MMEfjw7BgptKHs4mA@mail.gmail.com> <20190608192918.5533b9c7@raksha.tavi.co.uk>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Jun 8, 2019 at 12:29 PM Bob Eager <rde@tavi.co.uk> wrote:
>
> On Sat, 8 Jun 2019 12:16:05 -0600
> Adam Weinberger <adamw@adamw.org> 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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAP7rwcgthT%2Bg-hOwEwJdntOwK7AmqC1FRfHx7Xdua5HS_aB=KQ>