Add README.packaging.

svn path=/trunk/; revision=4391

diff --git a/Makefile.am b/Makefile.am
index 9f7e73d3f0e94100f7cacede51db371a45ea2495..d765a6169595dd47ad4343bd75d940876f69a781 100644 (file)
--- a/Makefile.am
+++ b/Makefile.am
@@ -83,6 +83,7 @@ fetchmail.spec: Makefile.in specgen.sh
 DISTDOCS=      BUGS FAQ FEATURES NOTES OLDNEWS fetchmail-man.html \
                fetchmail-FAQ.html design-notes.html esrs-design-notes.html todo.html \
                fetchmail-features.html README.SSL README.NTLM \
+               README.packaging \
                fetchmail-SA-2005-01.txt \
                fetchmail-SA-2005-02.txt
 

diff --git a/README.packaging b/README.packaging
new file mode 100644 (file)
index 0000000..6e799a1
--- /dev/null
+++ b/README.packaging
@@ -0,0 +1,34 @@
+README.packaging
+================
+
+fetchmail 6.3.0 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.
+
+- 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.