svn commit: r345057 - head/share/man/man7

[Conrad Meyer]

On Tue, Mar 12, 2019 at 3:18 AM Harry Schmalzbauer <freebsd at omnilan.de> wrote:
>
> Am 12.03.2019 um 10:27 schrieb Mateusz Piotrowski:
> > URL: https://svnweb.freebsd.org/changeset/base/345057
> >
> > Log:
> >    ports.7: Add an example of how to use flavors
> ...

Thank you, Mateusz.

Hi Harry,

> Since cem and dim seem to stumbled over the missing FLAVOR
> documentation, I see my main objection against current FLAVOR
> implementation confirmed:  Build stage must'nt silently chose a default
> FALVOR, but an OPTIONS-like dialog must inform the user and she _must_
> choose one.

Nah.  I don't like OPTIONS, and wouldn't prefer FLAVORS presented in that way.

I'm very appreciative of the work that went into FLAVORS.  It was a
needed step to make ports more maintainable, and it was well executed.
Kudos to everyone involved.  I ran into one rough edge around
documentation, and Mateusz was quick to fix it.

> The ports options framework is not really user friendly too,

Agree there...

> but does a
> basic job in guiding users.

I'm not sure that's true.

> ...
> Instructing users to set an environment variable to a value, which they
> have to lookup from a Makefile, is a very poor usability design, imho.

I agree — but I think pkg is the right tool for most users, and it
doesn't include things like OPTIONS at all.  And all flavors are
built.  I'm only munging around in the ports tree because this last
round of pkg builds, the builders decided not to compile a package or
two I needed, and we don't have any pkg stability build to build, so
they simply weren't installable.

Best,
Conrad