Re: Documentation for port config options?

2008-04-05 Thread Matthew Seaman

Steven Friedrich wrote:

cups-base has several options:

 [X] GNUTLSBuild with GNUTLS library
 [ ] PHP   Build PHP support
 [ ] PYTHONBuild PYTHON support
 [ ] LIBPAPER  Build with libpaper support
 [ ] DNSSD Build with DNS_SD (avahi) support
 [ ] PAM   Build with PAM support
 [ ] LDAP  Build with LDAP support
 [ ] DBUS  Build with DBUS support

Where can I find documentation regarding these options, so I can determine 
which ones I need?


That's actually a pretty hard thing to do, given the current way the
ports tree operates.  If you're lucky the port maintainer will have
commented the ports' Makefile nicely for you.  Another good place to
look is the documentation included in the source tarball of whatever
it is you are trying to build.  In that case, it helps if you can
follow through the logic in the ports Makefile to see what it does
to change the build when the option is toggled -- usually it's by
tweaking the options to  the configure script in the package sources.
Other possibilities are searching the web or asking someone knowledgeable.

Unfortunately there isn't a sure-fire way of getting any sort of
reasonable explanation of how port options work.  There is a proposal
being discussed over on the freebsd-ports@ list about adding a one
line explanatory snippet for each option, which would actually make
a pretty big difference despite the limited space to work with.

Cheers,

Matthew

--
Dr Matthew J Seaman MA, D.Phil.   7 Priory Courtyard
 Flat 3
PGP: http://www.infracaninophile.co.uk/pgpkey Ramsgate
 Kent, CT11 9PW



signature.asc
Description: OpenPGP digital signature


Re: Documentation for port config options?

2008-04-05 Thread Maxim Khitrov
On Sat, Apr 5, 2008 at 4:09 PM, Steven Friedrich [EMAIL PROTECTED] wrote:
 cups-base has several options:

   [X] GNUTLSBuild with GNUTLS library
   [ ] PHP   Build PHP support
   [ ] PYTHONBuild PYTHON support
   [ ] LIBPAPER  Build with libpaper support
   [ ] DNSSD Build with DNS_SD (avahi) support
   [ ] PAM   Build with PAM support
   [ ] LDAP  Build with LDAP support
   [ ] DBUS  Build with DBUS support

  Where can I find documentation regarding these options, so I can determine
  which ones I need?

Your best bet is to figure out which dependencies each of the option
adds (by looking through the Makefile). This is usually pretty simple
to do as you have constructs such as if defined(WITH_X) require some
other port. You can then look at the pkg-desc file for each dependency
and decide if you need that software installed. I don't think there is
a better way at this time.

- Max
___
freebsd-questions@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-questions
To unsubscribe, send any mail to [EMAIL PROTECTED]