On Tue, Nov 28, 2006, Doug Henry wrote:

> I was wondering if the options to packages are documented anywhere?  Just a
> simple description of what they provide is sufficient.  Many are self
> explanatory, but things like "imapd::with_replication" are not, at least not 
> to
> me.

We try hard to make them self-explaining as good as possible and in
addition we name them equal in different packages if they do the
same (typical example is "with_ssl" for enabling SSL/TLS support or
"with_x11" for X11 support in dozend of packages), but beside this there
is unfortunately no further description or even a full documentation
what each particular option is for. This is certainly a shortcoming in
our packages.

I also wanted to add a short description text at the end of the
"%option" lines in our packages, but at the time we invented our
"%option" extension, I'd not found a reasonable way to _store_ those
informations in the RPM itself (our %options are just "Provides" headers
as they have to be "PreReq"'ed in other packages and AFAIK there is no
possibility to store a comment or something like this in a "Provides"
header) -- hence this whole stuff was left out at all :-(

In case a package %option is not clear the best I can recommend
you is to look into the .spec file (just lookup the package under
http://www.openpkg.org/product/packages/ and navigate to its
.spec file hyperlink) and there look for the '%if "%{with_xxx} ==
"yes"' parts. Most options just enable or disable some Autoconf
"configure" options of the underlying program (in your example
"--enable-replication" is passed which AFAIK builds stuff related to
this: http://cyrusimap.web.cmu.edu/imapd/install-replication.html).

                                       Ralf S. Engelschall
                                       [EMAIL PROTECTED]
                                       www.engelschall.com

______________________________________________________________________
The OpenPKG Project                                    www.openpkg.org
User Communication List                      openpkg-users@openpkg.org

Reply via email to