meillo@67: Howto report bugs
meillo@67: =================
meillo@67: 
meillo@67: All non-trivial software has bugs and so does masqmail.
meillo@67: 
meillo@67: If you discover a bug then please report it. Your bug reports are an
meillo@67: important help in improving masqmail.
meillo@67: 
meillo@67: Valuable bug report include the following information. The first two
meillo@67: are essential, the others can also be added on request.
meillo@67: 
meillo@67: - A good description of what you consider to be the bug.
meillo@67: 
meillo@67: - The version of masqmail that was used. (The output of: masqmail -bV).
meillo@67: 
meillo@67: - A description on how to reproduce it. This includes information on
meillo@67:   other software that is involved.
meillo@67: 
meillo@67: - The configuration files. These are probably the contents of
meillo@67:   /etc/masqmail/*. Don't forget to substitute confidential data with
meillo@67:   placeholders.
meillo@67: 
meillo@67: - The relevant log files. Have a look at the value of use_syslog and
meillo@67:   log_dir in masqmail.conf. If use_syslog is enabled, the files are
meillo@67:   probably some of /var/log/mail*. If you don't use syslog, then the
meillo@67:   files reside unter the path assigned to log_dir, or by default in
meillo@67:   /var/log/masqmail/. Take care to substitute confidential data if you
meillo@67:   send debug files. (It's good to run masqmail with `-d 5' or `-d 6' to
meillo@67:   generate debugging data that may help to track down the bug.
meillo@67: 
meillo@67: Report the bug to the mailing list <masqmail@marmaro.de>. You don't
meillo@67: have to be subscribed to write to the list. Please tell us if you're
meillo@67: not subscribed so that we set you on CC. If you want to subscribe, send
meillo@67: a mail with subject ``subscribe masqmail'' to <minimalist@marmaro.de>.