[Gpg4win-commits] r340 - trunk/doc/website
scm-commit at wald.intevation.org
Fri Aug 4 00:08:02 CEST 2006
Date: 2006-08-04 00:08:02 +0200 (Fri, 04 Aug 2006)
New Revision: 340
Turn this more into a step-by-step guide.
--- trunk/doc/website/reporting-bugs.htm4 2006-08-03 08:03:47 UTC (rev 339)
+++ trunk/doc/website/reporting-bugs.htm4 2006-08-03 22:08:02 UTC (rev 340)
@@ -8,15 +8,33 @@
<h1>How to report a problem</h1>
+<h2>1. Check whether you are using the newest version of Gpg4win</h2>
+The download button ontop of the Gpg4win homepage shows
+the current version of Gpg4win.
+TODO: Where can you see the version number of a installed
+<h2>2. Check whether it is really a Gpg4win bug</h2>
Gpg4win integrates a number of tools that are
actually maintained by other development teams.
Therefore problems and bugs of general nature,
i.e. not related to the cross-compilation and/or
packaging by the Gpg4win team, should be reported
to the respective project teams:
@@ -36,49 +54,66 @@
GnuPG and GPGol bug tracking</a>
Of course, it is not always easy to decide whether
it is a bug of Gpg4win or a module.
In these cases and depending on the type of the
problem, either ask on one of the Gpg4win forums
or mailing lists for advice or create a Gpg4win bug report.
+<h2>3. Check whether the problem is already reported</h2>
+Search through the list of open bugs and try to
+identify whether one of the entries already describes
+your problem. Add your additional comments there.
-<h2>General hints for reporting bugs</h2>
+<h2>4. Provide version number</h2>
-When you report a bug, please
+If you report a new bug or add comments to a existing
+bug report, describe the exact version of the Windows System,
+Gpg4win, and if appropriate of MS Office and Outlook.
-<li> first check whether your problem has been
- already reported and add your comments.
-<li> provide the exact version of the Windows System,
- Gpg4win, and if appropriate of MS Office and Outlook.
-<li> if possible provide a step by step method
- how you reproduce the bug.
-<li> if appropriate, attach a debug log.
+<h2>5. Notes how to reproduce the bug</h2>
+If possible provide a step by step method
+how you reproduce the bug.
-<h2>Creating debug log information</h2>
+<h2>6. Add debug information</h2>
+If appropriate, attach a debug log of the
+procedure where you produced the bug.
+<h3>Creating debug log information</h3>
GPGME is a middle layer between GnuPG and all
Gpg4win modules except for GPGee.
To obtain detailed debugging information, you
must enter something like this on the DOS prompt:
"c:\Program Files\Microsoft Office\OFFICE11\OUTLOOK.EXE"
In this case the communication between GPGol and Outlook
will be logged into the file \tmp\gpgme.log.
GPGol has an extra debug options which helps to understand the
@@ -86,18 +121,23 @@
feature is often more important than the above noted gpgme logging.
To enable it, go to the GnuPG tab in Outlook's option page, click on
the "Advanced" button and enter
-into the "Debug output" field.
+into the "Debug output" field.
-<b>Please note</b> that you should search for passwords
+<em>Please note</em> that you should search for passwords
in these files and replace them by XXX before submitting the log
file(s) to a bug tracker.
If you feel able to, just send a excerpt with the relevant
More information about the Gpg4win-commits