RFC: MacPorts policy should be that docs should not be built or installed by default

Ken Cunningham ken.cunningham.webuse at gmail.com
Fri Sep 20 04:40:29 UTC 2019


the documentation that comes along with many ports often seems like a heavy and arguably needless burden:

- huge bloat
- lots of often onerous, massive, fussy build deps
- often takes as much time to sort out doc building as building the port

and, the big one :

I bet almost nobody ever looks at them, much less uses them. 

Google can find what you are looking for in a tiny fraction of the time.

We just witnessed days spent trying to build some html files and a PDF for a certain few ports that was a moderate PITA, added tons of time to the port which could have been better spent elsewhere, added confusion and bloat in the portfile, and required an entire texlive infrastructure to support building it, but default, on every system that wants to build it.

I'm sure this has been bandied about for decades on MacPorts. 

Was it never decided to leave all the docs out, except for perhaps a few (not few hundred, like openssl, but a few like less than five) man pages?

An enabling +doc variant is noted in a few ports -- feel free if you're motivated, or no docs, but an expectation that docs should be included, if  there is that expectation, is wasting time, space, bandwidth, etc, etc...

I vote we expect ports to not include anything but a few man pages. Everything else should be either left out, or an optional variant. A note where the website is for documentation in the port notes would be more than sufficient.

Best,

Ken


More information about the macports-dev mailing list