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

Reply via email to