[MacPorts] #62182: boost: don't install docs by default

[MacPorts]

#62182: boost: don't install docs by default
-------------------------+-----------------------
 Reporter:  mascguy      |      Owner:  michaelld
     Type:  enhancement  |     Status:  assigned
 Priority:  Normal       |  Milestone:
Component:  ports        |    Version:
 Keywords:               |       Port:  boost
-------------------------+-----------------------
 Presently, the default footprint of `boost` is a bit... well... heavy.

 Of the 38,258 files installed, 24,216 of those are documentation-related:

 {{{
 $ port contents boost | wc -l
    38258
 $ port contents boost | ggrep "/opt/local/share/doc/boost" | wc -l
    24216
 $ port contents boost | ggrep --invert-match "/opt/local/share/doc/boost"
 | wc -l
    14042
 }}}

 And while HFS compression does reduce the storage footprint for those
 docs, it's still significant. (Note that the first figure - 46 MB - is the
 actual storage usage, with HFS compression. The second figure indicates
 the size without, illustrating how large the documentation footprint is.)

 {{{
 $ gdu -hs /opt/local/share/doc/boost
 46M     /opt/local/share/doc/boost
 $ gdu -hs --apparent-size /opt/local/share/doc/boost
 248M    /opt/local/share/doc/boost
 }}}

 Not only that, but the sheer number of files causes the installation to
 take up to several minutes on slower Macs. An uninstall takes a
 significant amount of time too.

 So, I'd suggest we add a new `docs` variant, disabled by default. That
 would significantly reduce the overall footprint of the port, and improve
 install/uninstall time.

-- 
Ticket URL: <https://trac.macports.org/ticket/62182>
MacPorts <https://www.macports.org/>
Ports system for macOS