This is an old revision of the document!
Rewrite of bsd.apache.mk
(committed, see PR ports/156533)
apache13 is already deprecated upstream and apache20 will be deprecated with the release of apache24.
This means apache22 will be the default version as soon apache24 is in the ports tree.
Therefore Mk/bsd.apache.mk was rewritten to support this transition with a new logic and some new parameters.
| parameter | description |
|---|---|
| USE_APACHE | Set apache and apxs as build and run dependency |
| USE_APACHE_BUILD | Set apache and apxs as build dependency |
| USE_APACHE_RUN | Set apache and apxs as run dependency |
The following example is representative of all three possible parameters to use.
Examples:
| USE_APACHE= 22 | specify exact version |
| USE_APACHE= 1.3+ | specify [min] version, no [max] version |
| USE_APACHE= 13-22 | specify [min]-[max] range |
| USE_APACHE= -2.2 | specify [max] version, no [min] version |
Note:
- Values can be specified with and without “.” between major and minor version numbers. For example 22 is equal to 2.2
- If “+” is specified and no apache is installed, then ${DEFAULT_APACHE_VERSION} will be used.
- Valid version numbers are specified in the variable APACHE_SUPPORTED_VERSION below
- The following values for USE_APACHE are reserved and only valid in apache-server ports!
- USE_APACHE= common13, common20, and common22
Internal Variables to control which apache version will be chosen.
- DEFAULT_APACHE_VERSION= 13
- APACHE_SUPPORTED_VERSION= 13 20 22 # preferred version first
As soon apache24 hits the tree this will be changed to
- DEFAULT_APACHE_VERSION= 22
- APACHE_SUPPORTED_VERSION= 22 24 13 20 # preferred version first
Note for maintainers and porters
At the moment there are many ports with USE_APACHE= ab+ defined.
Those ports should be checked if they are really working together with apache24, else they should use the new form “[min]-[max]” or “-[max].”
Many ports don't use apache or apxs during build time, those ports should be changed to use USE_APACHE_RUN instead.
Future Improvements:
- New keywords @apadd and @apdel for usage in pkg-plist will be added as feature if the rewritten bsd.apache.mk went into ports/Mk. This is already implemented but not on high priority.