Query: variant +docs or +doc?

[Michael Dickens]

See < https://trac.macports.org/ticket/58338 > with title "lots-o-ports: decide on common variant name to build documentation: +docs or +doc".

There are approximately 128 ports that use +doc or +docs as the variant to build documentation. Of those, approximately 75 use +docs, while the rest -- approximately 53 ports -- use +doc.

[[I say "approximately" because I did a global search in the ports tree using a specific pattern ("variant doc " and "variant docs " with the extra space) as well as just {"variant doc" | grep docs}, the latter of which returns slightly different results (& I can think of lots of reasons why but the result are similar; hence "approximately ...).]]

Because we can individually set global default variants, one could choose to set both here to get documentation to build, but I'll agree with Blair that just setting one is preferable. Hence, it would not hurt to, as a group of developers the users of MacPorts, decide which variant name should be the sanctioned way to build documentation, and then tweak those non-conforming ports to use the correct variant name.

Please direct your thoughts to that ticket to keep everything easily in one place. This email is mostly to direct your attention to this specific ticket / topic. Thanks! - MLD