[Mrpostman-cvs] mrpostman/docs/html/en creatinglog.html,NONE,1.1

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/mrpostman/mrpostman/docs/html/en
In directory sc8-pr-cvs1:/tmp/cvs-serv9034

Added Files:
	creatinglog.html 
Log Message:
First version

--- NEW FILE: creatinglog.html ---
<html>
<head>
<title>Creating a debug log file for MrPostman</title>
</head>
<body>

<b>Creating a debug log file for MrPostman</b>

To assist the MrPostman developers in diagnosing and fixing your MrPostman problem, please follow the following steps to produce a
full log of your MrPostman output. It is advised to send this directly to a trusted developer when requested, rather than via the list to protect your privacy.

<ol>
<li>Save this <a href="logging.properties">logging configuration file</a> into your directory containing the MrPostman-xxxxx.jar file.

<li>Open a cmd window (shell/console window). Enure java is in your PATH (<a href="creatinglog.html#path">see here</a>)

<li>Type:
<pre>
java -Djava.util.logging.config.file=logging.properties -jar MrPostman-xxxxx.jar
</pre>
(change the xxxx bit to your real filename).
 This should launch the MrPostman GUI (you didn't turn the GUI option <a href="creatinglog.html#off">off</a> did you??).

<li>Attempt to collect mail in the normal way

<li>After you have received your error message, close MrPostman GUI.

<li>Locate the output log file. The log file will have been saved in your home directory. If you are using windows it may be in one of these (depending on version):
<ul>
<li>\Documents and Settings\java0.log
<li>\WINNT\profiles\you\java0.log
</ul>
(or similar. If you can't find it try doing a file search for java*.log, that may find it)

<li>Open the file in a text editor (notepad may struggle if the log file is too large. I recommend using JEdit available from sourceforge).

<li>Search and replace your pasword with *****. You may choose to do this for your username if you are really paranoid :-)

<li>Save, attach to email and send to one of the developers (see <a href="/en/contact.html">Contact us</a>) with 
as much of a description of what you were doing and what type of setup you have.

</ol>

Thanks very much - it really helps us and it will speed up your fix time.

<p>
Notes:

<p>
<a name="path"><i>Ensuring Java is in your PATH</i>
<p>

If you type 'java' then enter and it says:
<pre>The name specified is not recognized as an
internal or external command, operable program or batch file.
</pre>

It must be added. You can set this by typing:

<pre>
set PATH=%PATH%;"c:\Program Files\Java\bin"
</pre>

(or whatever path it is installed).

<a name="off">Showing a hidden GUI

The easiest way is to just run two copies of MrPostman at once. The second will pop the GUI. Check the option to Show next time. Close your two
copies and start again from step 2.

</body>

</html>