Pileus Git - ~andy/fetchmail/blob - README.packaging

   1 README.packaging
   2 ================
   3
   4 fetchmail 6.3 changes relevant for packagers
   5 --------------------------------------------
   6
   7 Greetings, dear packager!
   8
   9 The bullet points below mention a few useful hints for package(r)s:
  10
  11 - Please use OpenSSL and add --with-ssl to the ./configure command line.
  12   SSL/TLS support hasn't been enabled in the default build in order to maintain
  13   fetchmail 6.2 compatibility as far as possible.  SSL/TLS however is a highly
  14   recommended compilation option.
  15
  16 - Fetchmail now uses automake and supports all common automake targets and
  17   overrides such as "make install-strip" or "DESTDIR=..." for staging areas.
  18
  19 - The fetchmailconf script has been renamed to fetchmailconf.py, automake will
  20   install it into Python's top-level site-packages directory and byte-compile
  21   it (so you need to package or remove fetchmailconf.pyc and fetchmailconf.pyo
  22   as well).
  23
  24 - If you want to defeat Python byte-code compilation and would rather like to
  25   install fetchmailconf.py yourself, you can add
  26
  27       PYTHON=:
  28
  29   to the ./configure command or pass this in the environment.  This pretends
  30   that no Python interpreter were installed.
  31
  32 - The Makefile generates a two-line "fetchmailconf" /bin/sh wrapper script that
  33   executes the actual fetchmailconf.py with the python installation found at
  34   configuration time, so that users can still type "fetchmailconf" rather than
  35   "python fetchmailconf".
  36
  37 - Note that fetchmailconf.py supports a few command line arguments, so if you
  38   use local wrapper scripts, be sure they pass on their own arguments properly.
  39   Remember to use "$@" (with quotes) in shells, not $*.
  40
  41 - There is now a dummy fetchmailconf manual page which will just source (roff's
  42   ".so" command) the fetchmail manual page for now. You can of course keep your
  43   symlinks in place and ignore this dummy. IF you install the dummy and
  44   compress your man pages, be sure to test "man fetchmailconf", on some
  45   systems, you'll need to adjust the ".so" command to point to the compressed
  46   version.