annotate docs/howto-report-bugs @ 323:29de6a1c4538

Fixed an important bug with folded headers! g_strconcat() returns a *copy* of the string, but hdr->value still pointed to the old header (which probably was a memory leak, too). If the folded part had been quite small it was likely that the new string was at the same position as the old one, thus making everything go well. But if pretty long headers were folded several times it was likely that the new string was allocated somewhere else in memory, thus breaking things. In result mails to lots of recipients (folded header) were frequently only sent to the ones in the first line. Sorry for the inconvenience.
author meillo@marmaro.de
date Fri, 03 Jun 2011 09:47:27 +0200
parents bce7604e0465
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
67
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
1 Howto report bugs
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
2 =================
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
3
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
4 All non-trivial software has bugs and so does masqmail.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
5
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
6 If you discover a bug then please report it. Your bug reports are an
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
7 important help in improving masqmail.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
8
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
9 Valuable bug report include the following information. The first two
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
10 are essential, the others can also be added on request.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
11
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
12 - A good description of what you consider to be the bug.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
13
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
14 - The version of masqmail that was used. (The output of: masqmail -bV).
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
15
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
16 - A description on how to reproduce it. This includes information on
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
17 other software that is involved.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
18
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
19 - The configuration files. These are probably the contents of
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
20 /etc/masqmail/*. Don't forget to substitute confidential data with
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
21 placeholders.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
22
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
23 - The relevant log files. Have a look at the value of use_syslog and
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
24 log_dir in masqmail.conf. If use_syslog is enabled, the files are
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
25 probably some of /var/log/mail*. If you don't use syslog, then the
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
26 files reside unter the path assigned to log_dir, or by default in
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
27 /var/log/masqmail/. Take care to substitute confidential data if you
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
28 send debug files. (It's good to run masqmail with `-d 5' or `-d 6' to
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
29 generate debugging data that may help to track down the bug.
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
30
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
31 Report the bug to the mailing list <masqmail@marmaro.de>. You don't
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
32 have to be subscribed to write to the list. Please tell us if you're
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
33 not subscribed so that we set you on CC. If you want to subscribe, send
bce7604e0465 updated README; added howto-report-bugs
meillo@marmaro.de
parents:
diff changeset
34 a mail with subject ``subscribe masqmail'' to <minimalist@marmaro.de>.