[MacPorts] #50023: Clarification of variant specifiers in section 3.1.10 of guide

[MacPorts]

#50023: Clarification of variant specifiers in section 3.1.10 of guide
-------------------------+---------------------
  Reporter:  alexreg@…   |      Owner:  markd@…
      Type:  submission  |     Status:  new
  Priority:  Normal      |  Milestone:
 Component:  guide       |    Version:  2.3.4
Resolution:              |   Keywords:
      Port:              |
-------------------------+---------------------

Comment (by alexreg@…):

 Here's a better update, which clarifies that variants can in fact be
 passed to the `variants` command itself, and that bracketed + means the
 variant is default.

 {{{
 --- using.orig.xml      2015-12-14 16:27:51.000000000 +0000
 +++ using.xml   2015-12-15 17:15:09.000000000 +0000
 @@ -439,7 +439,7 @@
                  your build at install time. See <link
 linkend="using.variants.invoking">Invoking Port Variants</link>
                  below to install ports that have variants.</para>

 -            <programlisting><prompt>$ </prompt><userinput>port variants
 apache2</userinput></programlisting>
 +            <programlisting><prompt>$ </prompt><userinput>port variants
 apache2 +universal</userinput></programlisting>

              <screen>
  apache2 has the variants:
 @@ -448,13 +448,15 @@
     openldap: Enable LDAP support through OpenLDAP
  [+]preforkmpm: Use prefork MPM
       * conflicts with eventmpm workermpm
 -   universal: Build for multiple architectures
 +  +universal: Build for multiple architectures
     workermpm: Use worker MPM
       * conflicts with eventmpm preforkmpm</screen>

              <para>This output lists all variants followed by their
 description. If a variant depends on or conflicts
 -                with other variants, a line with the details on that
 follows. Variant lines that have a
 -                <option>+</option> are enabled and those with
 <option>-</option> are disabled.
 +                with other variants, a line detailing that follows. A
 variant name prefixed by <option>+</option>
 +                indicates that it has been enabled (on the command line),
 while a prefix <option>-</option> indicates
 +                that it has been disabled. When bracketed, a prefix
 <option>+</option> means that the variant is enabled
 +                by default.
                  Any <option>[]</option> are derived from the
 <filename>Portfile</filename>.
                  While <option>()</option> are derived from the
 <filename>variants.conf</filename>.
                  See <xref
 }}}

 I hope that looks good to you as well.

-- 
Ticket URL: <https://trac.macports.org/ticket/50023#comment:4>
MacPorts <https://www.macports.org/>
Ports system for OS X