[MacPorts] #50023: Clarification of variant specifiers in section 3.1.10 of guide
#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 Keywords: | Port: ------------------------+--------------------- The following patch clarifies a paragraph describing the output of the `port variants` command. {{{ 456,457c456,458 < 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.
Variant lines that have a <option>+</option> are
enabled by default; such variants can be
explicitly disabled on the command line by prefixing their
names with <option>-</option>.
}}} -- Ticket URL: <https://trac.macports.org/ticket/50023> MacPorts <https://www.macports.org/> Ports system for OS X
#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@…): Sorry, forgot to say that the file to be patched is `/trunk/doc- new/guide/xml/using.xml`. Replying to [ticket:50023 alexreg@…]:
The following patch clarifies a paragraph describing the output of the `port variants` command.
{{{ 456,457c456,458 < 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.
Variant lines that have a <option>+</option> are
enabled by default; such variants can be
explicitly disabled on the command line by prefixing their
names with <option>-</option>.
}}}
-- Ticket URL: <https://trac.macports.org/ticket/50023#comment:1> MacPorts <https://www.macports.org/> Ports system for OS X
#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 cal@…): That change removes the explanation of negative variant output, e.g. in `port variants nginx -spdy`. Please restore it. Additionally, we prefer unified patches, since they are easier to review and apply when the file has changed meanwhile. Additionally, the using.xml file uses spaces for indentation, please keep it that way. -- Ticket URL: <https://trac.macports.org/ticket/50023#comment:2> MacPorts <https://www.macports.org/> Ports system for OS X
#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
#50023: Clarification of variant specifiers in section 3.1.10 of guide --------------------------+--------------------- Reporter: alexreg@… | Owner: markd@… Type: enhancement | Status: new Priority: Normal | Milestone: Component: guide | Version: Resolution: | Keywords: Port: | --------------------------+--------------------- Changes (by mf2k@…): * version: 2.3.4 => * type: submission => enhancement Comment: FYI, a "submission" ticket type is only for a new port submission. -- Ticket URL: <https://trac.macports.org/ticket/50023#comment:5> MacPorts <https://www.macports.org/> Ports system for OS X
#50023: Clarification of variant specifiers in section 3.1.10 of guide --------------------------+--------------------- Reporter: alexreg@… | Owner: markd@… Type: enhancement | Status: closed Priority: Normal | Milestone: Component: guide | Version: Resolution: fixed | Keywords: Port: | --------------------------+--------------------- Changes (by cal@…): * status: new => closed * resolution: => fixed Comment: Thank you: r143651. -- Ticket URL: <https://trac.macports.org/ticket/50023#comment:6> MacPorts <https://www.macports.org/> Ports system for OS X
participants (1)
-
MacPorts