Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 2 Sep 2014 13:17:11 -0400
From:      Adam Weinberger <adamw@adamw.org>
To:        Alexey Dokuchaev <danfe@FreeBSD.org>
Cc:        "svn-ports-head@freebsd.org" <svn-ports-head@freebsd.org>, "svn-ports-all@freebsd.org" <svn-ports-all@freebsd.org>, marino@freebsd.org, "ports-committers@freebsd.org" <ports-committers@freebsd.org>, Andrej Zverev <az@freebsd.org>, Raphael Kubo da Costa <rakuco@freebsd.org>
Subject:   Re: svn commit: r367002 - head/devel/cmake
Message-ID:  <920CCE92-B3FB-441C-904E-5F8F5E9F5AAF@adamw.org>
In-Reply-To: <20140902170825.GA50168@FreeBSD.org>
References:  <201409021339.s82DdX36038975@svn.freebsd.org> <A80106E3-30CD-4B45-859E-2F96BD1264FF@adamw.org> <CAD5bB%2BiLj%2BaHOHH1R-4ZXVj=JPMdnxe04C6w50WjHsVFe6Hnsw@mail.gmail.com> <5405E33B.3040906@marino.st> <EBCC13BE-C282-4072-AAE4-A2CB6AD91EAC@adamw.org> <5405E50B.1030100@marino.st> <30FDC48D-0DF1-4EBA-918D-878048101E21@adamw.org> <20140902170825.GA50168@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On 2 Sep, 2014, at 13:08, Alexey Dokuchaev <danfe@FreeBSD.org> wrote:

> On Tue, Sep 02, 2014 at 11:42:41AM -0400, Adam Weinberger wrote:
>> If it's on by default I don=92t see the problem. Who are we to decide =
that
>> nobody should ever be allowed to build a port without manpages?
>=20
> Correct way out is to talk with upstream (yes, in every violating =
case) to
> provide pregen'ed manpages and/or documentaion in the release tarball =
(or
> separate file alongside).

I do not disagree with you at all. If you can run autogen before you =
release a tarball, surely you can pre-build your manpages.

> Lots of people still build things from ports, either because they like =
it
> this way, or they're not happy with our official binary packages =
(wrong
> OPTIONS selection for them).  We should try to make their lives =
easier.

Agreed. Again with the end-user experience thing, our job is to =
anticipate what our end-users will want, and give them open doors to =
walk through. I definitely think that, here, for now, a non-zero segment =
of our user base would prefer no manpages to a dozen build-time =
dependencies. FreeBSD is usually excellent at this concept.

> I totally hate man/docs building.  It has nothing do with my CPU; =
those bits
> most likely will be the same everywhere.  Why not prebuild it then?

Again, I do not disagree with you at all. In the absence of pre-built =
manpages, however, mandatory sphinx is not the totally ideal solution.

# Adam


--=20
Adam Weinberger
adamw@adamw.org
http://www.adamw.org




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?920CCE92-B3FB-441C-904E-5F8F5E9F5AAF>