README.packaging - fetchmail in fetchmail

README.packaging
================

fetchmail 6.3 changes relevant for packagers
--------------------------------------------

Greetings, dear packager!

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.

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.

Gitorious