[MacPorts] #58338: lots-o-ports: decide on common variant name to build documentation: +docs or +doc

[MacPorts]

#58338: lots-o-ports: decide on common variant name to build documentation: +docs
or +doc
--------------------------+-----------------------
  Reporter:  blair        |      Owner:  michaelld
      Type:  enhancement  |     Status:  assigned
  Priority:  Normal       |  Milestone:
 Component:  ports        |    Version:
Resolution:               |   Keywords:
      Port:  cmake        |
--------------------------+-----------------------

Old description:

> Blair writes, specifically regarding "cmake":
> {{{
> It appears that +doc is more common than +doc (at least in my list of
> installed packages), as I have +doc in my
> ${prefix}/etc/macports/variants.conf, so suggest cmake switches over.
> }}}
>
> Michaelld writes:
> {{{
> I'm retitling this request, since IMHO it is valid to request a common
> variant name to build documentation. Rather than requesting I change the
> variant for one specific port, lets look at the overall ports and make a
> group decision on how to proceed.
> }}}

New description:

 Blair writes, specifically regarding "cmake":

 It appears that +doc is more common than +doc (at least in my list of
 installed packages), as I have +doc in my
 ${prefix}/etc/macports/variants.conf, so suggest cmake switches over.


 Michaelld writes:

 I'm retitling this request, since IMHO it is valid to request a common
 variant name to build documentation. Rather than requesting I change the
 variant for one specific port, lets look at the overall ports and make a
 group decision on how to proceed.

--

Comment (by mf2k):

 I wrote a python script to analyze the ports to get more accurate counts.
 There are a few python sub-ports that slightly increase the counts. Also
 some portgroups add doc(s) variants and so only need to be changed once. I
 also overcounted {{{-devel}}} sub-ports. Anyway, here are the results:

 ||= variant =||= port count =||
 ||docs||  363||
 ||doc||  104||
 ||with_docs||   31||
 ||other||   16||

 Plus there are sub-ports for documentation:
 ||= port name =||= port count =||
 ||*-doc|| 22||
 ||*-docs|| 239||

 I can also list the actual ports. Does anyone want me to add them in the
 description?

-- 
Ticket URL: <https://trac.macports.org/ticket/58338#comment:9>
MacPorts <https://www.macports.org/>
Ports system for macOS