README.packaging
================
-fetchmail 6.3.0 changes relevant for packagers
-----------------------------------------------
-(These should apply to all 6.3.X versions)
+fetchmail 6.5 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
+- Fetchmail requires OpenSSL v1.1.1 or newer.
-- 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
- 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.
+
+ 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.