X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=README.packaging;h=08d115d03d3bf3a476df4663ef9af34fcd4983ff;hb=fd5cf7350bad7b8a596ec7a02df41043315566de;hp=6e799a15f0a0c03946b81ef1399091981b15304b;hpb=ed657cb2a081242f42a9ec6ee95c3e2d0da79c4d;p=~andy%2Ffetchmail diff --git a/README.packaging b/README.packaging index 6e799a15..08d115d0 100644 --- a/README.packaging +++ b/README.packaging @@ -1,34 +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. +The bullet points below mention a few useful hints for package(r)s: -- fetchmail now uses automake and supports all common automake targets - and overrides such as "make install-strip" or "DESTDIR=..." for staging - areas +- 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. -- 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) +- Fetchmail now uses automake and supports all common automake targets and + overrides such as "make install-strip" or "DESTDIR=..." for staging areas. -- 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. +- 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). -- 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. +- If you want to defeat Python byte-code compilation and would rather like to + install fetchmailconf.py yourself, you can add -- 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. + 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.