X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=README.packaging;h=08d115d03d3bf3a476df4663ef9af34fcd4983ff;hb=53293ee30678d3db753e51820cc554c0b2b1bd97;hp=f26aa9fb9b1687b630091321b6603455b70ffa02;hpb=f20ed78e9ad30abb10bc877269240953f187404d;p=~andy%2Ffetchmail diff --git a/README.packaging b/README.packaging index f26aa9fb..08d115d0 100644 --- a/README.packaging +++ b/README.packaging @@ -1,35 +1,46 @@ README.packaging ================ -fetchmail 6.3.0 changes relevant for packagers ----------------------------------------------- +fetchmail 6.3 changes relevant for packagers +-------------------------------------------- Greetings, dear packager! -There are now some changes to the fetchmail 6.3.0 installation layout, -which are given as headwords below. - -- fetchmail now uses automake and supports all common automake targets - and overrides such as "make install-strip" or "DESTDIR=..." for staging - areas - -- the fetchmailconf script has been renamed to fetchmailconf.py, - automake will install it into Python's top-level site-packages directory - and byte-compile it (so you need to package or remove - fetchmailconf.pyc and fetchmailconf.pyo as well) - -- the Makefile generates a two-line "fetchmailconf" /bin/sh wrapper - script that executes the actual fetchmailconf.py with the python - installation found at configuration time, so that users can still type - "fetchmailconf" rather than "python fetchmailconf" - -- note that fetchmailconf.py supports a few command line arguments, so - it you use local wrapper scripts, be sure they pass on their own - arguments properly. - -- there is now a dummy fetchmailconf manual page which will just source - (roff's ".so" command) the fetchmail manual page for now. You can of - course keep your symlinks in place and ignore this dummy. IF you - install the dummy and compress your man pages, be sure to test "man - fetchmailconf", on some systems, you'll need to adjust the ".so" - command to point to the compressed version. +The bullet points below mention a few useful hints for package(r)s: + +- Please use OpenSSL and add --with-ssl to the ./configure command line. + SSL/TLS support hasn't been enabled in the default build in order to maintain + fetchmail 6.2 compatibility as far as possible. SSL/TLS however is a highly + recommended compilation option. + +- Fetchmail now uses automake and supports all common automake targets and + overrides such as "make install-strip" or "DESTDIR=..." for staging areas. + +- The fetchmailconf script has been renamed to fetchmailconf.py, automake will + install it into Python's top-level site-packages directory and byte-compile + it (so you need to package or remove fetchmailconf.pyc and fetchmailconf.pyo + as well). + +- If you want to defeat Python byte-code compilation and would rather like to + install fetchmailconf.py yourself, you can add + + PYTHON=: + + to the ./configure command or pass this in the environment. This pretends + that no Python interpreter were installed. + +- The Makefile generates a two-line "fetchmailconf" /bin/sh wrapper script that + executes the actual fetchmailconf.py with the python installation found at + configuration time, so that users can still type "fetchmailconf" rather than + "python fetchmailconf". + +- Note that fetchmailconf.py supports a few command line arguments, so if you + use local wrapper scripts, be sure they pass on their own arguments properly. + Remember to use "$@" (with quotes) in shells, not $*. + +- There is now a dummy fetchmailconf manual page which will just source (roff's + ".so" command) the fetchmail manual page for now. You can of course keep your + symlinks in place and ignore this dummy. IF you install the dummy and + compress your man pages, be sure to test "man fetchmailconf", on some + systems, you'll need to adjust the ".so" command to point to the compressed + version.