4.1 Base Configuration4.2 Mailbox 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.
- Start Docked: If checked, when you launch your mail app through KNewMail, either by the toolbar, commands menu, or double clicking on a message, KNewMail will dock itself.
- Never Display Splash: Even though I spent hours and hours creating the splash image, I know it annoys some people. Just check this box and you will never again see the splash logo when you start KNewMail.
- 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.
- Socket Time Out Length: This is the number of seconds the program will wait per mailbox before timing out. For most POP servers this can be set to 8 seconds. If you have a slower server, you might have to make it longer.
4.3 Notification 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 using a basic encryption algorithm. This means they can be read by anyone who wants to spend the time decrypting it. If security is a major concern, 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.4 Interface 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.
- Show Status Dialog: This option will allow the Status Dialog to be displayed when needed. QT will only display a Status Dialog if the process is estimated to take longer than 3 seconds.
- Play Sound: If toggled on, the player specified will be used to play the sound via a system()' call whenever new mail arrives.
- Player Edit Line: This should be the full path to the sound app you wish to use, or the name of the app if it is already in your path. This line can also be set to 'system-bell' which will ring the system bell when new mail arrives.
- Sound Edit Line: This should be the path to the sound you wish to play.
- 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.
- 'To:' field: If set to parse from header, the 'To:' field will show the strings that are directly parsed from the header. If you set it to user@servername, that is what will be inserted into the list of messages. If set to disabled, the field will not appear in the window.
- Toolbar Position: This is the position that the toolbar will be set at.
- Statusbar Position: This is the position of the statusbar on the main window. Only bottom and disabled are supported.
Documentation written by Mike
Pilone
All documentation and source code may be freely distributed
as long as it remains in the same format.