FreeBSD Bugzilla – Attachment 160111 Details for
Bug 202491
[PATCH] Add new OPT_IMPLIES and OPT_PREVENTS macros to the Porter's Handbook
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
Remember
[x]
|
Forgot Password
Login:
[x]
[patch]
Patch to add new OPT_IMPLIES and OPT_PREVENTS to Porter's Handbook
OPT_IMPLIES_PREVENTS.patch (text/plain), 3.42 KB, created by
Ben Woods
on 2015-08-19 17:06:08 UTC
(
hide
)
Description:
Patch to add new OPT_IMPLIES and OPT_PREVENTS to Porter's Handbook
Filename:
MIME Type:
Creator:
Ben Woods
Created:
2015-08-19 17:06:08 UTC
Size:
3.42 KB
patch
obsolete
>Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml >=================================================================== >--- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml (revision 47286) >+++ en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml (working copy) >@@ -4015,6 +4015,84 @@ > must be added to <varname>OPTIONS_DEFINE</varname>.</para> > </note> > </sect3> >+ >+ <sect3 xml:id="makefile-options-implies-prevents"> >+ <title>Options Dependencies/Conflicts</title> >+ >+ <para>Where options have dependencies or conflicts between >+ each other, these should be registered using the >+ <varname><replaceable>OPT</replaceable>_IMPLIES</varname> >+ and <varname><replaceable>OPT</replaceable>_PREVENTS</varname> >+ macros.</para> >+ >+ <sect4> >+ <title><varname><replaceable>OPT</replaceable>_IMPLIES</varname></title> >+ >+ <para>If an option depends on other options, these should be >+ registered by a space separated list using the >+ <replaceable>OPT</replaceable>_IMPLIES macro. If the >+ option with dependencies is enabled, the dependent options >+ named in <replaceable>OPT</replaceable>_IMPLIES will get >+ enabled automatically.</para> >+ >+ <para>For example, if <replaceable>OPT1</replaceable> >+ depends on <replaceable>OPT2</replaceable> and >+ <replaceable>OPT3</replaceable>:</para> >+ >+ <programlisting>OPT1_IMPLIES= OPT2 OPT3</programlisting> >+ >+ <note> >+ <para>No notification or warning is provided in the build >+ output or the options configuration dialog to alert the >+ user that an option has been automatically >+ enabled.</para> >+ </note> >+ </sect4> >+ >+ <sect4> >+ <title><varname><replaceable>OPT</replaceable>_PREVENTS</varname></title> >+ >+ <para>If options conflict with each other, these should be >+ registered by a space separated list using the >+ <replaceable>OPT</replaceable>_PREVENTS macro. When an >+ option is enabled, if any of the conflicting options named >+ in <replaceable>OPT</replaceable>_PREVENTS are also >+ enabled, the port build will produce an error which >+ explains the conflicting options.</para> >+ >+ <para>For example, if <replaceable>OPT1</replaceable> >+ conflicts with <replaceable>OPT2</replaceable> and >+ <replaceable>OPT3</replaceable>:</para> >+ >+ <programlisting>OPT1_PREVENTS= OPT2 OPT3</programlisting> >+ >+ <note> >+ <para>No notification is provided in the options >+ configuration dialog to alert the user that conflicting >+ options have been enabled, however an error will be >+ generated during the port build explaining the >+ conflict.</para> >+ </note> >+ >+ <para>If options are conflicting because a maximum of one >+ option should be enabled in a list, then the >+ <literal>OPTIONS_SINGLE</literal> or >+ <literal>OPTIONS_RADIO</literal> macros should be used >+ in preference to the <replaceable>OPT</replaceable>_PREVENTS >+ macro. The <replaceable>OPT</replaceable>_PREVENTS macro >+ should be used for more complicated conflict scenarios, >+ for example:</para> >+ >+ <programlisting>OPTIONS_DEFINE= PORTS_SSL >+OPTIONS_SINGLE= GSSAPI >+OPTIONS_SINGLE_GSSAPI= GSSAPI_BASE GSSAPI_HEIMDAL GSSAPI_MIT GSSAPI_NONE >+ >+# Ensure port does not link with libcrypto.so from both base and ports >+GSSAPI_BASE_PREVENTS= PORTS_SSL</programlisting> >+ >+ </sect4> >+ >+ </sect3> > </sect2> > > <sect2 xml:id="makefile-options-auto-activation">
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
Attachments on
bug 202491
: 160111