Re: use of DOCS in port options

From: Daniel Engberg <diizzy_at_FreeBSD.org>
Date: Thu, 28 Aug 2025 20:32:00 UTC
On 2025-08-28 20:37, Gleb Popov wrote:
> On Thu, Aug 28, 2025 at 9:22 PM void<void@f-m.fm> wrote:
>> Hi,
>>
>> Can DOCS include MANPAGES?
>> I'd like to build my ports with just manpages and examples.
>> Does disabling DOCS globally also clobber ports manpages?
> I'm not a portmgr, so this is all my humble opinion:
> Ideally we should strive to separate DOCS and MANPAGES. But sometimes
> the software's buildsystem has a single "docs" switch that controls
> both manpages and html/pdf/etc. generation. In this case I don't go as
> far as decoupling DOCS and MANPAGES and stick with only DOCS.

However granularity comes at a cost (time and testing) and it makes 
little sense to add options if there's no support upstream.

Best regards, Daniel