4.1 Base Configuration

• Check Mail at Startup: Toggling this option on will force KNewMail to check your mail when the program is first started. This is recommended for users that have KNewMail in their 'Autostart' folder and have a constant connection to the net. For modem users, it is recommended that you leave this off. NOTE: This force check is actually done before the gui is displayed, so if you have a lot of mail waiting, or a server is not responding, the KNewMail dialog will not show up until the check is complete, just be patient.

• Check Time: This is the number of minutes that KNewMail will wait between checks. NOTE: The timer is reset if you choose to force check your mail.

4.2 Mailbox Configuration

• Server: This is the name of the server which your mail lies on. Usually something like 'mail.someplace.com'. New as of version 2.0 is the ability to check the local machine for new mail. To use this feature, enter the server name as the full path to the mail spool file. For example, for most systems, this path will be '/var/spool/mail'. You need to make sure you have the opening '/', this is how KNewMail determines if the address is local or remote. The trailing '/' is optional.

• Add Button: Use this button to add a server to the list to be checked for mail.

• Delete Button: Use this button to remove a server from the list. The server currently displayed will be removed.

• Username: This is the username that will be sent to the pop3 server when requested. If the server name is the localhost path, this field will be attatched to the end of the server name as the name of the file which contains your mail.

• Password: This is the password that will be send to the server when requested. If the server name is the localhost path, you can leave this field empty. NOTE: Passwords are saved to the configuration file in plain text. This means they can be read by anyone who has access to your account. If you don't want your password written to the file, leave the password field empty and turn off the 'Save Password' toggle.

• Port: This is the port that KNewMail will attempt to open the server at. The standard pop3 port is 110.  If the server name is the localhost path, this field will be ignored, so it can be blank or just left at 110.

• Save Password: If toggled to on, KNewMail won't ask for your password each time it checks. It will just use the password you entered for that server. If toggled to off, KNewMail will ask for your password for each server each time it checks mail.

4.3 Notification Configuration

• Message on Sreen. If toggled on, KNewMail will generate a dialog that will tell you that there are new messages waiting on the server.

• Show Headers: If toggled on, KNewMail will display the main dialog when ever newmail is detected, with the headers listed in the main window. This will force KNewMail out of docked mode if checked.

• Show Errors: More for debugging, if checked, this option will bring up a dialog whenever there is a server communications error. If this dialog comes up, KNewMail will stop processing mail until the OK button is pressed. This is to prevent multiple dialog boxes from appearing if KNewMail continually can't contact the server.

• Play Sound: If toggled on, the edit line in the sound options will be passed to the system via a system()' call whenever new mail arrives.

• Sound Edit Line: This should be the path to the sound you wish to play, preceeded by the program used to play it. For example, if you used bplay, you line should look like this: 'bplay $HOME/.knewmail/data/some_sound.wav'. This assumes you made a sub-directory called 'data' in the '.knewmail' dir. This path can point to any sound app and any file supported by that sound app. This line can also be set to 'system-bell' which will ring the system bell when new mail arrives.

• Automatic Launch: If toggled on, the edit line in the mail reader options will be passed to the system via a 'system()' call whenever new mail arrives.

• Mail Reader Edit Line: This is the command that will be passed to the system when new Mail arrives. This line should be the full path to a mail app, or the name of an app in your path. A '&' will be added to the end of this string to prevent KNewMail from freezing while your app executes.