New features to troubleshoot a git-multimail installation

• One can now perform a basic check of git-multimail's setup by running the hook with the environment variable GIT_MULTIMAIL_CHECK_SETUP set to a non-empty string. See doc/troubleshooting.rst for details.
• A new log files system was added. See the multimailhook.logFile, multimailhook.errorLogFile and multimailhook.debugLogFile variables.
• git_multimail.py can now be made more verbose using multimailhook.verbose.
• A new option --check-ref-filter is now available to help debugging the refFilter* options.

Formatting emails

• Formatting of emails was made slightly more compact, to reduce the odds of having long subject lines truncated or wrapped in short list of commits.
• multimailhook.emailPrefix may now use the '%(repo_shortname)s' placeholder for the repository's short name.
• A new option multimailhook.subjectMaxLength is available to truncate overly long subject lines.

Bug fixes and minor changes

• Options refFilterDoSendRegex and refFilterDontSendRegex were essentially broken. They should work now.
• The behavior when both refFilter{Do,Dont}SendRegex and refFilter{Exclusion,Inclusion}Regex are set have been slightly changed. Exclusion/Inclusion is now strictly stronger than DoSend/DontSend.
• The management of precedence when a setting can be computed in multiple ways has been considerably refactored and modified. multimailhook.from and multimailhook.reponame now have precedence over the environment-specific settings ($GL_REPO/$GL_USER for gitolite, --stash-user/repo for Stash, --submitter/--project for Gerrit).
• The coverage of the testsuite has been considerably improved. All configuration variables now appear at least once in the testsuite.

This version was tested with Python 2.6 to 3.5. It also mostly works with Python 2.4, but there is one known breakage in the testsuite related to non-ascii characters. It was tested with Git 1.7.10.406.gdc801, 1.8.5.6, 2.1.4, and 2.10.0.rc0.1.g07c9292.

Documentation for git-multimail 1.4.