
    This is Pan, a powerful and user-friendly Usenet newsreader for GTK+.
    The latest info and versions of Pan can always be found at
    <http://pan.rebelbase.com/>.


REQUIREMENTS

    Pan requires these libraries:
    * GTK+ 2.16.0 or higher (optionally GTK+ 3.0.0 or higher)
      <http://www.gtk.org/>
    * GMime 2.4.0 or higher <http://spruce.sourceforge.net/gmime/>
      (optionally GMime 2.5.5 or higher for PGP cryptography support)

    The following libraries, which enhance Pan's functionality, are optional:
    * GtkSpell 2.0.7 or higher for spellchecking
      <http://gtkspell.sourceforge.net>
      (optionally GtkSpell 2.0.16 for spellchecking with GTK+ 3)
    * Enchant 1.6.0 or higher for spellchecking
      <http://www.abisource.com/projects/enchant/>
    * libnotify 0.4.1 or higher for notifications
      <http://www.galago-project.org/news/index.php>
    * GNOME Keyring 3.2.0 or higher for password storage
      <https://live.gnome.org/GnomeKeyring>
    * D-Bus for multiple Pan instances
      <http://www.freedesktop.org/wiki/Software/dbus>
    * GnuTLS 2.12.10 or higher for encrypted connections (TLS 1.0)
      <http://www.gnu.org/software/gnutls/>

    Remember to inquire ./configure --help for the appropriate flags to enable/disable these
    enhancements!

    Most Linux distributions already have these; they can also be downloaded
    from their home pages.

    On Debian-based systems (for example Ubuntu), you can install the
    requirements with the following command:

    sudo apt-get install <REQUIREMENT>

    On Fedora-based systems, run the following command to install the
    requirements:

    sudo yum install -y <REQUIREMENT>

    On Arch Linux, run the following command to invoke the package manager Pacman:

    sudo pacman -S <REQUIREMENT>


THE SALES PITCH

    Pan is good for Reading News.

        * Pan is the only Unix newsreader to score 100% on the
          Good Net-Keeping Seal of Approval newsreader evaluations.
        * Pan has keyboard bindings for mouse-free newsreading.
        * Basic newsreader features, such as reading and writing news,
          threading articles, and replying via email, are supported.
        * Articles can be sorted by author, date, subject, or the number
          of unread children in the thread.
        * Multiple connections are supported, so articles can be read
          while binaries are downloading.
        * Articles can be filtered by regular expression matching,
          read/unread state, binary/text, etc.
        * Works well as an offline reader.
        * Articles can be queued until you want to go online, and can be
          re-edited at any point before they're posted.
        * A flexible rules system allows you to delete, hide, download,
          or notify you of, etc. articles that match a subject, or are
          posted by a particular user, and so on.
        * The same system can be used to define automatic actions on behalf
          of the user: auto-download, auto-cache, auto-delete etc.
        * Groups can be filtered by regular expression matching
          subscribed/new/all, etc.

    Pan is good for Downloading Binaries.

        * Attached images can be shown inline.
        * Pan can download and thread articles as quickly as bandwidth allows.
        * uuencoded, mime, and yEnc attachments are all supported.
        * A task manager lets you reorder, cancel, and resubmit download tasks.
        * Multiple connections are supported, so many binaries can
          be downloaded simultaneously.
        * Multipart articles are automatically grouped together.
        * Non-binary, incomplete multipart, and saved messages can be filtered
          out of the article list.

    Pan is good for Uploading Content to Usenet.

        * Files can be attached to a Usenet article and are
          automatically yEnc-encrypted, threaded and referenced by Pan.
        * Articles can be encrypted and/or signed with a public/private PGP key,
          so your privacy and security are ensured.
        * Connections can be encrypted with the TLS 1.0 protocol (the successor
          to SSL 3.0).

    The rest of the sales pitch is at <http://pan.rebelbase.com/features/>.


UPGRADING

    Upgrading typically requires that you do the exact same procedure as
    in the 'INSTALL' file.


INSTALLATION

    See the file 'INSTALL' for instructions.


HOW TO REPORT BUGS

    See http://pan.rebelbase.com/bugs/ to report bugs.


CONTACT

    To get in touch with Pan authors, contributors, and other community members,
    subscribe to one of the Pan mailing lists.
    See http://pan.rebelbase.com/mailing_lists/ for more information.


LINKS

    Pan     : http://pan.rebelbase.com/
    GTK+    : http://www.gtk.org/
    GNOME   : http://www.gnome.org/
    GNU     : http://www.gnu.org/


=================================================================================================

RELEASE NOTES

*  Remember, if you have been using the localhost server with an stunnel setup and you change Pan
   to connect directly to the server using the actual server address, you should edit the existing
   server instead of creating a new entry. If you create a new entry, Pan will see this as a new
   server entirely even though you may be connecting to the same account as before.
   Your subscribed groups will be lost!
   By editing the existing the localhost:119 server entry, your subscriptions will be preserved.

*  For SSL support, remember to do a
      './configure --with-gnutls', or a respective 'sh autogen.sh --with-gnutls'

*  Directories to search for SSL certificates can be defined with the environment variable
      SSL_CERT_DIR or SSL_DIR

=================================================================================================


