head	1.4;
access;
symbols
	rpm-4_4_8-release:1.4
	rpm-4_4_7-release:1.4
	rpm-4_4_6-release:1.4
	rpm-4_4_5-release:1.4
	rpm-4_4_4-release:1.4
	rpm-4_4_3-release:1.4
	jbj_before_tklcpatches:1.4
	rpm-4_4_2-release:1.4
	pjones-sparse-experiment:1.4.0.6
	rpm-4_4_1-release:1.4
	rpm-4_4-release:1.4
	rpm-4_4:1.4.0.4
	rpm-4_3_1-start:1.4
	rpm-4_3:1.4.0.2
	rpm-4_2_1-release:1.3
	rpm-4_1_1-release:1.3
	rpm-4_2-release:1.3
	rpm-4_2:1.3.0.4
	rpm-4_1-release:1.3
	rpm-4_1:1.3.0.2
	rpm-4_0_4-release:1.1.2.1
	jbj-before-beecrypt:1.1.2.1
	rpm-4_0_3-release:1.1.2.1
	jbj_b4_rollback:1.1.2.1
	rpm-4_0:1.1.0.2;
locks; strict;
comment	@# @;


1.4
date	2003.12.30.13.14.50;	author jbj;	state Exp;
branches;
next	1.3;

1.3
date	2002.04.07.19.52.43;	author jbj;	state Exp;
branches
	1.3.4.1;
next	1.2;

1.2
date	2001.03.16.20.23.49;	author jbj;	state Exp;
branches;
next	1.1;

1.1
date	2001.03.16.20.23.42;	author jbj;	state dead;
branches
	1.1.2.1;
next	;

1.1.2.1
date	2001.03.16.20.23.42;	author jbj;	state Exp;
branches;
next	1.1.2.2;

1.1.2.2
date	2002.03.19.23.54.11;	author jbj;	state Exp;
branches;
next	;

1.3.4.1
date	2003.12.30.13.17.46;	author jbj;	state Exp;
branches;
next	;


desc
@@


1.4
log
@- spelling corrections (#112728).
@
text
@/*! \page conditionalbuilds Passing conditional parameters into a rpm build

Source code is often built with optional features enabled or disabled.
When source code is packaged using rpm, the various features can be
chosen, added to a spec file, and a package will be produced with
binaries compiled with that feature set. This mechanism works fine
for packages with small feature sets, but does not work so well
for large, complicated, packages like the Linux kernel and/or
the Pine mailer which have a large number of features, as a given
feature set may not "work" for everyone.

RPM now has a supported mechanism to pass information from the rpm
command line to enable/disable features during a build. Two options have
been added to pass feature names from the rpm command line:
\verbatim
    --with <feature>	Enable <feature>
    --without <feature>	Disable <feature>
\endverbatim
The new options are implemented using popt to add aliases to the existing rpm
options --define to specify macros from the command line. The magic necessary
to add the new options is (from the file /usr/lib/rpm/rpmpopt*)
\verbatim
    rpmb	alias --with    --define "_with_!#:+       --with-!#:+"
    rpmb	alias --without --define "_without_!#:+    --without-!#:+"
\endverbatim
(Note: The obscure "!#:+" popt token above says "substitute the next command
line argument found here, and, additionally, mark the argument as used.")

For example, when rpm is invoked as
\verbatim
    rpm ... --with ldap ...
\endverbatim
then the popt aliases will cause the options to be rewritten as
\verbatim
    rpm ... --define "_with_ldap	--with-ldap" ...
\endverbatim
which causes a "%_with_ldap" macro to be defined with value "--with-ldap"
during a build.

The macro defined on the rpm command line can be used to conditionalize
portions of the spec file for the package. For example, let's say you
are trying to build the pine package using "--with ldap" to enable the
LDAP support in the pine mailer (i.e. configuring with "--with-ldap").
So the spec file should be written
\verbatim
    ...
    ./configure \
	%{?_with_ldap}   \
    ...
\endverbatim
so that, if "--with ldap" was used as a build option, then configure
will be invoked (after macro expansion) as
\verbatim
	./configure --with-ldap ...
\endverbatim
(Note: The obscure "%{?_with_ldap: ...}" rpm macro syntax above says "if the
macro "_with_ldap" exists, then expand "...", else ignore.")

The spec file should include a default value for the "_with_ldap" macro,
and should support "--without ldap" as well. Here's a more complete example
for pine:
\verbatim
    # Default values are --without-ldap --with-ssl.
    #
    # Read: If neither macro exists, then add the default definition.
    %{!?_with_ldap: %{!?_without_ldap: %define _without_ldap --without-ldap}}
    %{!?_with_ssl: %{!?_without_ssl: %define _with_ssl --with-ssl}}
    ...

    # You might want to make sure that one and only one of required and
    # mutually exclusive options exists.
    #
    # Read: It's an error if both or neither required options exist.
    %{?_with_ssl: %{?_without_ssl: %{error: both _with_ssl and _without_ssl}}}
    %{!?_with_ssl: %{!?_without_ssl: %{error: neither _with_ssl nor _without_ssl}}}

    # Add build dependencies for ssl and ldap features if enabled.
    # Note: Tag tokens must start at beginning-of-line.
    #
    # Read: If feature is enabled, then add the build dependency.
    %{?_with_ssl:BuildRequires: openssl-devel}
    %{?_with_ldap:BuildRequires: openldap-devel}
    ...

    # Configure with desired features.
    #
    # Read: Add any defined feature values to the configure invocation.
    %configure \
	%{?_with_ssl}		\
	%{?_without_ssl}	\
	%{?_with_ldap}		\
	%{?_without_ldap}
    ...

    # Conditional tests for desired features.
    #
    # Read: true if _with_ssl is defined, false if not defined.
    %if %{?_with_ssl:1}%{!?_with_ssl:0}
    ...
    %endif

\endverbatim

*/
@


1.3
log
@- speedup large queries by ~50%.
- revert to presentation ordering Yet Again (#62158).
- non-glibc: on upgrade, mergesort is much faster than quicksort.
@
text
@d1 1
a1 1
/*! \page conditionalbulds Passing conditional parameters into a rpm build
d51 1
a51 1
so that, if "--with ldap" was used as a build option, then confgure
@


1.3.4.1
log
@- spelling corrections (#112728).
@
text
@d1 1
a1 1
/*! \page conditionalbuilds Passing conditional parameters into a rpm build
d51 1
a51 1
so that, if "--with ldap" was used as a build option, then configure
@


1.2
log
@- add --with/--without popt glue for conditional builds(Tomasz Kloczko).
@
text
@d48 1
a48 1
	%{?_with_ldap:      %{_with_ldap}}   \
d70 7
d78 1
d81 2
a82 2
    %{?_with_ssl:   BuildRequires: openssl-devel}}
    %{?_with_ldap:  BuildRequires: openldap-devel}}
d89 10
a98 4
	%{?_with_ssl:       %{_with_ssl}}    \  
	%{?_without_ssl:    %{_without_ssl}} \  
	%{?_with_ldap:      %{_with_ldap}}   \
	%{?_without_ldap:   %{_without_ldap}}\
d100 2
@


1.1
log
@file conditionalbuilds was initially added on branch rpm-4_0.
@
text
@d1 88
@


1.1.2.1
log
@- add --with/--without popt glue for conditional builds(Tomasz Kloczko).
@
text
@a0 88
/*! \page conditionalbulds Passing conditional parameters into a rpm build

Source code is often built with optional features enabled or disabled.
When source code is packaged using rpm, the various features can be
chosen, added to a spec file, and a package will be produced with
binaries compiled with that feature set. This mechanism works fine
for packages with small feature sets, but does not work so well
for large, complicated, packages like the Linux kernel and/or
the Pine mailer which have a large number of features, as a given
feature set may not "work" for everyone.

RPM now has a supported mechanism to pass information from the rpm
command line to enable/disable features during a build. Two options have
been added to pass feature names from the rpm command line:
\verbatim
    --with <feature>	Enable <feature>
    --without <feature>	Disable <feature>
\endverbatim
The new options are implemented using popt to add aliases to the existing rpm
options --define to specify macros from the command line. The magic necessary
to add the new options is (from the file /usr/lib/rpm/rpmpopt*)
\verbatim
    rpmb	alias --with    --define "_with_!#:+       --with-!#:+"
    rpmb	alias --without --define "_without_!#:+    --without-!#:+"
\endverbatim
(Note: The obscure "!#:+" popt token above says "substitute the next command
line argument found here, and, additionally, mark the argument as used.")

For example, when rpm is invoked as
\verbatim
    rpm ... --with ldap ...
\endverbatim
then the popt aliases will cause the options to be rewritten as
\verbatim
    rpm ... --define "_with_ldap	--with-ldap" ...
\endverbatim
which causes a "%_with_ldap" macro to be defined with value "--with-ldap"
during a build.

The macro defined on the rpm command line can be used to conditionalize
portions of the spec file for the package. For example, let's say you
are trying to build the pine package using "--with ldap" to enable the
LDAP support in the pine mailer (i.e. configuring with "--with-ldap").
So the spec file should be written
\verbatim
    ...
    ./configure \
	%{?_with_ldap:      %{_with_ldap}}   \
    ...
\endverbatim
so that, if "--with ldap" was used as a build option, then confgure
will be invoked (after macro expansion) as
\verbatim
	./configure --with-ldap ...
\endverbatim
(Note: The obscure "%{?_with_ldap: ...}" rpm macro syntax above says "if the
macro "_with_ldap" exists, then expand "...", else ignore.")

The spec file should include a default value for the "_with_ldap" macro,
and should support "--without ldap" as well. Here's a more complete example
for pine:
\verbatim
    # Default values are --without-ldap --with-ssl.
    #
    # Read: If neither macro exists, then add the default definition.
    %{!?_with_ldap: %{!?_without_ldap: %define _without_ldap --without-ldap}}
    %{!?_with_ssl: %{!?_without_ssl: %define _with_ssl --with-ssl}}
    ...

    # Add build dependencies for ssl and ldap features if enabled.
    #
    # Read: If feature is enabled, then add the build dependency.
    %{?_with_ssl:   BuildRequires: openssl-devel}}
    %{?_with_ldap:  BuildRequires: openldap-devel}}
    ...

    # Configure with desired features.
    #
    # Read: Add any defined feature values to the configure invocation.
    %configure \
	%{?_with_ssl:       %{_with_ssl}}    \  
	%{?_without_ssl:    %{_without_ssl}} \  
	%{?_with_ldap:      %{_with_ldap}}   \
	%{?_without_ldap:   %{_without_ldap}}\
    ...
\endverbatim

*/
@


1.1.2.2
log
@Corrections from <rpm-list@@redhat.com>.
@
text
@d48 1
a48 1
	%{?_with_ldap}   \
a69 7
    # You might want to make sure that one and only one of required and
    # mutually exclusive options exists.
    #
    # Read: It's an error if both or neither required options exist.
    %{?_with_ssl: %{?_without_ssl: %{error: both _with_ssl and _without_ssl}}}
    %{!?_with_ssl: %{!?_without_ssl: %{error: neither _with_ssl nor _without_ssl}}}

a70 1
    # Note: Tag tokens must start at beginning-of-line.
d73 2
a74 2
    %{?_with_ssl:BuildRequires: openssl-devel}
    %{?_with_ldap:BuildRequires: openldap-devel}
d81 4
a84 10
	%{?_with_ssl}		\
	%{?_without_ssl}	\
	%{?_with_ldap}		\
	%{?_without_ldap}
    ...

    # Conditional tests for desired features.
    #
    # Read: true if _with_ssl is defined, false if not defined.
    %if %{?_with_ssl:1}%{!?_with_ssl:0}
a85 2
    %endif

@


