----------------------------------------------------
Ultrafunk Popcorn POP3/SMTP e-mail client README.TXT
----------------------------------------------------


Release information:
--------------------
Release date   : 14.Sep.2001
Version        : Popcorn release 1.15
Author         : Ultrafunk
Web            : http://www.ultrafunk.com
Product page   : http://www.ultrafunk.com/products/popcorn/
User forum     : http://www.ultrafunk.com/support/forum/
Feedback email : rune@ultrafunk.com


What is Popcorn?
----------------
Popcorn is a freeware ultra-lightweight POP3/SMTP e-mail client, free from
unwanted and useless bloatware features. Being a true client/server
application, it does not work in the same way as a typical mail program.
This means that you're reading mail from a POP3 server directly, without
downloading it to a local mailbox on your PC (although you can save mail
messages locally if you want to). This makes it ideally suited for
"on the road" mail access, and for scanning, reading and sending mail over
slow internet connections.

Popcorn supports multiple user profiles, enabling you to read and send
mail from any number of different POP3 accounts. It is a small, portable
e-mail client, the kind you can carry with you on a floppy disk or download
quickly from the web without having to go through any installation procedures.
The user profiles and account information is NOT saved in the local registry,
but in a small, portable .INI-file that accompanies the application,
enabling you to easily move between locations.

Using Popcorn you can check and send mail from anywhere as long as you
have an Internet connection. You can also delete spam, old messages or see
if a message has attachments without downloading the messages from the
server first. It is perfect for cleaning up and administering multiple POP3
accounts.


System requirements:
--------------------
 Windows 95/98/ME, Windows NT 4, Windows 2000 or Windows XP

 Riched.dll version 2 is required.
  You can download release 5.0.152.0 of the Riched20.dll here:
  http://www.ultrafunk.com/products/popcorn/
  Download it only if Popcorn reports that you don't have the correct
  version on your computer.

 An updated Common Control Library (comctl32.dll) version 4.70 or later is required.
  The URL for finding the newest comctl32.dll is available here:
  http://www.ultrafunk.com/products/popcorn/
  Download it only if Popcorn reports that you don't have the correct
  version on your computer.


What's new in this release (1.15 - 14.Sep.2001)?
------------------------------------------------
New features:

* Popcorn can now save (and append) all outgoing mail to a single flat text file. The
  path and file name can be different for each profile. To enable this option, open the
  user profile manager, go to the Settings tab and check the "Append outgoing messages
  to a single text file" checkbox. Either select an existing path&file, or select the
  path and type the name of the file you want to create and append outgoing messages to.

* Popcorn now supports the "logon and authenticate on POP server before sending a message"
  SMTP authentication scheme. This can be enabled in the User Profile Manager on the
  "Identity and Servers" tab with the checkbox "Use POP authentication before message send"

* The User Profile Manager layout has now been and cleaned up.
  The "New...", "Clone...", "Delete..." and "Rename..." buttons are now available
  at all times (they are no longer on the "Identity and Servers" tab only).
  Grouping of controls on the same tab has also been reorganized and more logically
  placed

* Added "From:" field to the mail editor. This can be shown or hidden from the "+" button
  beside the "To:" field. If shown, it will list all profile addresses in the combo dropdown
  and show the current profiles Full Name and e-mail address, making it easy to send from any
  address defined in any user profile, or you can type in any address you want.

* Popcorn now reads and stores the Reply-To: field if it exists in all received messages.
  The Reply-To address will also be used correctly when replying or replying to all
  to a received message.

* Popcorn now accepts a command line argument that it uses to locate
  (if you supply a full path) the Popcorn INI file. If you supply only a filename,
  Popcorn will try to locate an INI file with the name given in the programs
  startup folder.

* Popcorn now has a "Mark for Deletion" sub-menu with items "Mark all Unread" og
  "Mark all Read" in addition to the existing ones.


Bug-fixes:

* Fixed a bug that made Popcorn display the wrong number of headers downloaded
  after messages has been deleted from the POP server.

* Fixed a bug where sometimes Popcorn would not empty the mail viewer window
  of a message that is beeing deleted. This could Popcorn to crash if you
  chose to save/print/reply etc... to the displayed message.

* The UsePOPServerStatus default setting has been changed from TRUE (on),
  to FALSE (off)

* The Popcorn readme file has now been renamed to PopReadme.txt, making it
  easier to separate from other readme files.

* Fixed bug that caused Popcorn to sometimes display the "You have new mail"
  message when retrieving the latest headers for a another profile 

* Reply To All now properly retains Cc recipients in the mail editor

* Fixed bug that caused the Delete marked items on Pop server toolbar button
  not beeing greyed out when not available

* Popcorn now properly receives mail headers dynamically as specified in the POP RFCs,
  it used to have a fixed maximum size of 15k. per header. Headers with many
  100+ recipients ("To:") could also crash Popcorn, this has now been fixed.

* Finally using the checkboxes in the inbox does not trigger changes in item activation,
  but you have to use Ctrl + mouseclick to be able to check & highlight items
  at the same time without clearing the current selection

* Fixed bug that did not allow POP and SMTP port numbers to be over 8148. They
  can now be between 0 and 65535 as specified in the TCP/IP specs.

* base64 encoded header fields are now properly decoded and displayed.


For more information about what has been updated (bugfixes and enhancements)
in previous releases, have a look at the "Release history" section at the end
of this document.


Getting started:
----------------
When you have installed or extracted popcorn.zip to a folder, it is ready for
use. Popcorn starts by asking you if you want to create a user profile if you
have not done so before. By answering yes, the User Profiles dialog will open,
and you'll have to click on the "New..." button to create and name a new profile.
Enter all the information needed to receive and send mail. It's important that
you fill out all the required fields correctly to be able to use all Popcorn
features.

The following fields are required in the "Identity and Servers" tab:

  * Full Name
  * E-mail Address
  * SMTP Server (if you want to send mail)
  * POP3 Server (if you want to receive mail)
  * POP3 User (to be able to log onto the POP server)
  * Password (to be able to log onto the POP server)
    Checking the "Remember password" option (default) will make Popcorn
	store the password, if you want Popcorn to prompt you for the password,
	un-check this checkbox.

The password field will always contain stars (******) even if no password
has been entered. Default settings are used in the "Settings" tab when you
create a new profile, change them as you see fit.

When you have entered the information needed to be able to send and receive
mail, click OK and Popcorn is ready for use. All user profile information and
program configuration is stored in an .INI file (popcorn.ini) residing in
the directory Popcorn was started from. If you wish to use Popcorn on other
computers or locations without re-entering user profile information, this file
contains all that is needed.


Using Popcorn:
--------------
Popcorn is a true server/client application. This means that all mail resides on
the POP3 server(s) that the user profiles specify. There is no local diskbased
inbox or outbox. When you retrieve mail, it resides only in memory on
the client computer. You can save mail to your harddisk as a text file,
but you must do so implicitly by choosing "Save Current Message..."

When you delete items from your local "Inbox", they will be removed
permanently from the account on the POP server (this is only possible if
the check box on the left hand side of the mail item is checked or the item
is highlighted in the inbox). You will be thoroughly warned before any mails
are deleted from the POP server. Emptying the local inbox, switching user profile
or exiting Popcorn will NOT delete any mail from the server, and upon exit,
no mail is left on the host computers local hard disk.

When composing new mails, replying to or forwarding mail using the built-in
editor, you can save outgoing messages manually or automatically. To save
them manually, select "Save Mail Draft..." from the menu. For automatic saving of
sent messages, you can either check the "Save outgoing" checkbox, or enable it
permanently through the Settings tab in the User Profile manager. Messages
saved in this way can be loaded into the mail editor through the "Open Mail Draft..."
item on the menu. The draft messages contain the recipient(s) and subject lines
in addition to the message content, so these fields will be automatically
restored in the editor when a mail draft is loaded. All maildrafts and outgoing
mails are saved as normal text files and they are fully readable and searchable
by programs like Notepad.


Uninstalling Popcorn:
---------------------
To uninstall Popcorn, delete the installation directory and all shortcuts.
No data or files are stored in the registry or other directories.


Planned features in future releases:
------------------------------------
These are some of the features that are planned for future Popcorn releases:

* Checking multiple POP accounts manually or automatically
* Being able to set fonts and colours for the inbox, mail viewer
  and the mail editor
* Simple address book
* Using Popcorn as the system default mail client (controlled individually
  for each user profile)
* Program help (optional) or online documentation
* MIME base64 attachment decoding and saving and MIME base64 attachment
  encoding and sending
* Support for viewing multipart/alternative MIME types, HTML and rich text
  e-mail through external apps
* Popcorn location roaming through the use of HTTP based user profiles
* Support for ESMTP and SMTP authentication (this might get implemented
  earlier if the demand is great enough)
* Diskbased Inbox and Outbox (optional)


Release history:
----------------
Release 1.10 - 10.Aug.2001

New features:
    * You can now use the arrow keys (+ Page Up, Page Down, Home, End) properly
      for navigating in the inbox
    * Pressing enter in the inbox when it is focused downloads or shows the
      currently selected item
    * "Local" and "Local (partial)" (downloaded) items will be automatically
      displayed in the mail viewer when they are selected
    * The tab key can now be used to switch input focus between the inbox
      and mail viewer
    * You can now press space in the inbox to check (mark) and toggle the
      highlighted mail item for deletion
    * You can now use Ctrl+M to check (mark) and toggle the currently displayed
      mail item for deletion
    * You can now use the "*" (multiply key) to select and highlight the currently
      displayed message in the inbox
    * You can now goto the previous or next unread message in the inbox using
      "+" (pluss key) to goto the next, and "-" (minus key) to go to the previous
    * You can now goto the previous or next read message in the inbox using
      Shift + + (shift & pluss keys) to goto the next, and Shift + - (shift & minus keys)
      to go to the previous
    * The last downloaded header is now automatically highlighted (when appropriate),
      making it easy to see, and you can just press enter to download it
    * Popcorn now displays the cursor position on the statusbar for the mail
      viewer when it is focused (has keyboard & mouse input)
    * Popcorn now shows short help/description texts in the statusbar for all
      menu items in the main and mail editor windows
    * Main Popcorn menus have now been split up to prevent "menu clutter"
      > Edit : Moved items here from the Mail menu
      > View : New menu item, moved items here from the Mail menu
    * Improved error handling when deleting mail items from POP servers, if something
      fails during the delete operation, you can now cancel it and no mail will be
      deleted from the server
    * Popcorn now has a feature that will delete all mail items on the current
      POP server without having to download any headers. It can be accessed through
      the "Edit"->"Delete All Mail on POP server" item in the main window.
    * Find and Replace text has been implemented in the mail editor (available through
      the "Edit" menu.)
    * Find text has been implemented in the mail viewer (available through
      the "Edit" menu.)
    * The Mail Editor now has it's own accelerator keys (keyboard shortcuts) for all
      menu items (this did not function properly before!)
    * Popcorn now remembers and restores the size of the inbox and mail viewer windows
    * Loading and saving of maildrafts has been much improved. 
      > Now saves priority and read reciept notification
      > The "Message:" field no longer necessary (allthough it still loads "old"
        Popcorn maildrafts)
      > You can now load any text file containing an email with a full header
        as a maildraft
    * Popcorn now saves and restores which additional fields (Cc, Bcc) are shown
      in the mail editor 
    * The Transaction log now includes connection, DNS lookup info etc. in the tranlog
      (all activity before and after server connection)
    * The Transaction log window now has a context pop-up menu (right mouse click).
      This contains the following features:
      > "Save All Log entries" : Saves the whole log to a specified text file
      > "Copy selected to Clipboard" : Copies the highlighted entry to the clipboard
      > "Clear Transaction Log" : Clears the transaction log and window
	  > "Set Max Log Entries" : Allows you to specifiy (or disable) the number of
        lines the transaction log should contain.
    * The Transaction log window title now displays the name of the current profile
      and current number of log lines (or disabled)
    * Popcorn now supports Read/Unread flags (STATUS) set by the POP server
    * The Popcorn INI file now contains a setting called "UsePOPServerStatus"
      (for each profile) that enables/disables Popcorn support for the POP
      server STATUS flags
    * Popcorn now supports read reciept notification og send mail priority
      (low, normal, high) in the mail editor through the "Mail Properties"
      menu
    * The "Cc" and "Bcc" fields can now be toggled on and of using the "+" menu
      in the mail editor
    * "Get headers on startup" option will enable download of all or latest
      headers automatically on startup for the current profile. This option
      is available in the User Profile Manager on the Settings tab
    * Now displays name profile dialog when a profile is cloned,
      cloning can also be cancelled
    * There is now several new items on the tray icon context pop-up menu:
      > "Get Mailbox Info" : Displays info for the current account
      > "Check for New Mail" : Checks for new mail on the current server
      > "Compose New Mail" : Opens the mail editor for composing and sending
        a new mail
    * The mail viewer window now has a small selection margin at the leftmost side
      to make it easier to read and select text

Bug-fixes:
    * A lot of usability "problems" have been improved (error dialogs etc...)
    * FIX: Popcorn unselected the current message in the inbox listview if
      it was checked off (meaning the wrong context menu shows up and other
      strange stuff!)
    * Partially downloaded content is now correctly decoded to 8 bit charset
    * Fixed bug with displaying the wrong current sort column on menus
    * Improved handling of mail sending/drafts and errors in the mail editor
    * Popcorn finally notifies you of new mail AFTER they have been downloaded! ;-)
    * Popcorn transmitted a single NULL character after the EOD sequence
      when transmitting SMTP data. This prohibited some SMTP servers from
      accepting mail data sent from Popcorn
    * Popcorn could cut off ends of mails received from Exchange POP servers 
      because Exchange reports wrong octet sizes when sending the LIST command.
      This bug affected mail download from all servers that do not strictly
      comply with RFC specifications
    * Popcorn did not always properly set the "Local (partial)" status for
      a downloaded message. This has now been fixed, even for POP servers
      that do not strictly follow RFC specifications. The "Local (partial)"
      status is now only set when the user chooses to download the top n
      lines of a message, and the complete message contains more lines than
      Popcorn received
    * Fixed bug with enabling/disabling (greying) edit boxes for getting top
      lines of messages with attachments or over a certain size in the User
      Profile Mananger, settings tab.
    * Popcorn now prompts you before exiting if you have any unsaved data
      in the mail editor



Release 1.04 - 10.Jan.2001

New features:
    * Popcorn can now save all downloaded mail items (with local or partial
      status) to single flat text file. When two or more mail items have
      been downloaded, select "File/Save All Local Mail..." or use the
      corresponding button on the toolbar to save all downloaded messages
      to the directory of your choice.
    * Popcorn can now automatically send a copy of each sent mail item
      to a specified e-mail address. Using this feature enables you to have a
      roaming outbox using a second (or the same) POP account. To use
      this feature, open the User Profile manager, check the
      "Auto Send Copy To:" checkbox in the "Identity & Servers" tab,
      and enter the desired destination address. You will be prompted
      each time you send mail from the mail editor if you want to send
      a copy to the specified address.
    * Popcorn now allows for selection of multiple headers in the inbox for
      deleting mail items on the POP server using the "standard" Microsoft
      list view methods (Shift, Ctrl, lasso). This can be used in combination
      with the checkboxes or separately. Using the ALT key when clicking on
      a header in the inbox allows you to select it without downloading the
      mail item.
    * Popcorn now handles being started from read only media such as a write
      protected floppy or a CD. It is preferable that there allready exists
      a Popcorn.ini file together with the executable. All changes done to
      any program setting or user profile will NOT be saved when you quit
      Popcorn, and you will be warned about this when Popcorn is started
      from any write protected (or read only) media.
    * Word wrapping in the Mail Editor can now be toggled on/off
      using the "Word Wrap" item on the Edit menu.
    * Popcorn now accepts using IP addresses for the POP and SMTP servers
      (enter an IP address in the "POP Server" and/or "SMTP Server" fields
      in the User Profile manager)
    * Popcorn can now redirect mail items you receive to one or more new
      recipients. Redirecting a mail item is almost like forwarding it,
      except that the mail is sent to the new recipient(s) EXACTLY like you
      received it (the originator address, date etc. is not changed).
      This feature is available through the Mail menu, or through the new
      redirect button on the toolbar (next to the forward button).
      PLEASE BE AWARE THAT THIS FEATURE IS EXPERIMENTAL!
    * Popcorn now properly decodes ISO MIME Base64 encoded header fields
      (sometimes present in mail sent with Microsoft Outlook).
    * Hyperlink URLs can now be turned off for the mail viewer and the
      mail editor, this has to be done by manually editing the Popcorn.ini
      file. Setting the "HyperlinkURLs" option to FALSE (under the 
      "[PopcornSettings]" section) will turn off automatic hyperlinking of
      URLs.

Bug-fixes:
    * Popcorn now remembers which tab was last displayed in the
      User Profiles Manager ("Identity & Servers" or "Settings")
      and restores this the next time the window is displayed.
    * Popcorn now updates, shows and uses the correct path for
      "Save Outgoing" (automatic saving of sent mail items) in the
      Mail Editor if you compose, reply to or forward a mail item and
      then change the user profile before sending it.
    * Fixed: Popcorn did not always set the correct button state
      for the Auto check button on the toolbar when changing the
      active profile.
    * The checkboxes in the inbox are now a contained in a separate
      column
    * Fixed: The Cc and Bcc fields in the mail editor did not allow input
      beyond the visible content area (no horizontal scrolling)
    * New logo in the about box and program icon



Release 1.02 - 08.oct.2000:

New features:
    * Popcorn now supports "Cc" and "Bcc" in the mail editor (available throught
      the "+" button to the right of the "To:" field in the editor).
    * Popcorn can now prompt you for the POP account password before logging on
      instead of saving it in the Popcorn.ini file. Uncheck the "Remember
      password" option in the User Profile Manager if you want Popcorn
      to prompt you for the password.
    * Popcorn can now sort items in the inbox in ascending and descending order, either
      by clicking any of the column headers (from, subject etc) -- clicking the same
      header twice or more toggles between ascending/descending -- or through the inbox
      context menu or through the "Mail->Sort Mail Headers" menu.
    * Popcorn now has inbox header item hover high-light
    * Header/inbox colums can now be re-ordered through drag and drop, the ordering
      is saved and restored when Popcorn is restarted
    * The transaction log is now updated in "real time" if the window
      is open when sending or receiving mail
    * Added message server number column (also sortable)
    * Popcorn now saves messages as you see them in the mail viewer,
      the header setting (none, brief and full) is also preserved
      when saving a message

Bug-fixes:
    * Popcorn now has better busy handling in the inbox
    * Popcorn now decodes ISO quoted pritable strings in all header
      fields (it only decoded the from and subject fields in previous versions)
    * Fixed bug in ISO string decoder that would sometimes make Popcorn crash
    * Fixed bug -- clicking the transaction log icon on the toolbar
      now restores it and brings it to the front if it is allready open
    * Control tab order in the mail editor now works correctly
    * Fixed bug in the mail editor, it did not always update and show
      the correct cursor position.
    * Fixed bug in the user profile manager -- pressing ESC now closes
      the window when focus is on one of the two tabs
    * Fixed bug in 7 bit quoted printable decoder
    * Fixed crash if all profiles were deleted and then cancelled
    * Fixed POP command send/recieve sequence problems with some servers
    * Fixed crash if mail viewer context menu (right click) was displayed
      before any profiles had been created
    * Added space (empty line) between each session in the transaction log
    * Word wrapping is now enabled in the mail editor when replying and forwarding
      if quoting is NOT enabled



Release 1.01 - 28.aug.2000:

Bug-fixes:
    * About 30 smaller bugs and other various issues have been fixed.



Release 1.00 - 21.aug.2000:

New features:
    * Popcorn can now play a system defined sound ("Sounds Properties" in the
      control panel, either the "Exclamation" or "New Mail Notification" events)
      when a new mail arrives (specified on/off in each user profile)
    * Popcorn now always remembers and restores it's last size and position when it
      is re-started!
    * Popcorn can now be started as a minimized window either on the
      Taskbar or as a Tray Icon by setting "Run/Minimized" on any Popcorn
      shortcut icon, or through the "Window"->"Minimize To Tray Icon" menu item
      in Popcorn
    * Displays animating tray icon when receiving new mail and shows current
      profile and status in the tray icon tooltip message
    * On the Settings tab in User Profile Manager, "Prompt when changing profile" makes
      it possible to supress the warning dialog that pops up when changing profiles if
      the inbox contained any items.
    * Added statusbar to the Mail Editor window (shows cursor position and word wrap status)
    * Now shows size of mailbox on the POP server (for the current user)
      on the statusbar.
    * You can now sort inbox items using the list view column headers (by subject,
      by sender etc.). This is also available from the inbox context menu
      "Sort Mail Headers" and the "Mail"->"Sort Mail Headers" menu.
    * Now parses RFC-822 date/time strings in the inbox and during column sorting
    * Improved MIME parsing - better detection of attachments and content types

Bug-fixes:
    * Removed bug that would cause Popcorn to flash it's taskbar item when
      the application window is made inactive on Windows 2000
    * Better handling of aborting a connection or data send/retrieve
    * Popcorn now properly handles aborting message sending and deleting
    * Improved program progress feedback on the status bar
    * Removed potential crash from quoted printable decoder.
    * Fixed problem with the mail viewer and editor - it would sometime
      skip showing the first line of a message (None or brief header mode)
    * "Reply to all" now includes the "Cc" and "From" fields
    * Fixed bug in the user profile manager; Popcorn would not remember changes
      made when switching between profiles or when making new or cloning profiles
    * Popcorn no longer pops up more than one error dialog if it fails during
      automatic new mail checking
    * Fixed bug that would lead to a critical socket error if you chose to re-retrieve
      a mail item where you had previously retrieved only n lines of the total content
    * The mail editor now correctly detects when you have made changes to it's content
    * Popcorn now properly handles nicknames that are equal to the corresponding
      e-mail address, all duplicates are now removed from the recipient list

