Re: use of DOCS in port options

On Thu, Aug 28, 2025 at 02:37:21PM EDT, Gleb Popov wrote:
> On Thu, Aug 28, 2025 at 9:22 PM void <[email protected]> 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.
> 

sub-packages solve this for all cases.  You might still have to build
them but they get their own package.