*** Note that Rod Whitby is no longer able to maintain PNR                  ***
*** Please address all questions to the HPLX-L mailing list                 ***
*** Please address all bug reports to davidb@netmedia.net.il <David Becher> ***

===== Palmtop News Reader (PNR) Version 4.0
===== Palmtop News Reader Threader & Indexer (PNRTI) Version 4.0

===== Copyright (c) 2001 David Becher
===== Copyright (c) 1997 - 2000  Rod Whitby
===== Copyright (c) 1995 - 1996  Michael J. Leaver

! IMPORTANT !
-------------

If you have an older version of PNR installed and are installing a NEW 
RELEASE of PNR you must follow these steps:
                   -----------------------

  1. Remove PNR from the application manager (move to its icon and press F4)
  2. Re-install PNR.EXM into the application manager as per normal (press F2)

If those steps are not followed, PNR will crash your palmtop when executed.
If it does, just press Ctrl-Alt-Del, restart the application manager, and
follow the two steps above!

If you are updating from PNR version 2, and have existing folders that you
wish to preserve, then you will also need to convert your old folders into
new folders.  *** See the manual PNR.DOC for step by step directions. ***

If you are updating from version 3.x, make sure to copy the file "pnrmime.txt"
to your spool directory!

Instructions
------------

PNR is a FREEWARE offline news reader for HPx00LX palmtops:

        o System Manager compliant.
        o It won't work on HP-95LX's as far as I know.
        o Compatible with the HP200LX TCP/IP Development Kit (LXTCP).

For full instructions read the MEMO file PNR.DOC. There is also a FAQ
(Frequently Asked Questions) file provided called PNRFAQ.TXT.

For quick installation edit the file PNR.CFG, move it to C:\_DAT, and install
PNR.EXM (not PNR.EXE) as per normal. Then read the instructions on how to get
and thread your news and mail.If you are updating from version 3.x, make sure
to copy the file "pnrmime.txt" to your spool directory (you may modify this
file if you dont like the MIME message, but you need the file to be there)!


Files
-----

PNR.DOC         - *** READ THIS FIRST *** MEMO format documentation for PNR
PNR.CFG         - Configuration file for PNR
PNR.EXE         - The MS-DOS version of PNR
PNR.EXM         - The HPx00LX SysMgr compliant version of PNR
PNR.ICN         - Icon for PNR
PNRFAQ.TXT      - A Frequently Asked Questions file
PNRMIME.TXT     - A text message added to MIME ENCODED files
PNRTI.EXE       - Threading program for use with PNR
PNRTI.ICN       - Icon for PNRTI
README          - This file


PNR Version 4.0
---------------

*** Note that Rod Whitby is no longer able to maintain PNR                  ***
*** Please address all questions to the HPLX-L mailing list                 ***
*** Please address all bug reports to davidb@netmedia.net.il <David Becher> ***

PNR Version 4.0 was COMPLETELY modified, written, debugged and packaged
on my HP200LX using Borland Turbo C++ v1.0

1. Major changes between version 4.0 and version 3.6:

PNR can now create messages with MIME attachments. When attaching a file to
a message, it is automatically MIME encoded, so you can safely attach BINARY
files. (But dont send them to the HPLX list.)

Also when replying or forwarding messages you have the option of ATTACHING
the original message. So if the original message had a mime attachment or
was in a format which PNR cannot read, you can forward the message to a 
mail client which is smarter!

The otpion of creating a special header when sending a message, was removed.

2. Major changes between version 3.6 and version 3.5:

PNR was made smaller both in the executable code size and in the amount of
data needed. This should give you more memory to read more mail in PNR.EXM

PNR.EXM and PNR.EXE may use different editors. See PNR.CFG for details.

When running PNR.EXM, PNR.EXE, or PNRTI.EXE, a lock file is created in the
spool directory to prevent you from running another application in the
PNR "family", and trashing the index files. LXMTA should be modified to
do this as well. See the FAQ for details.

In PNR.EXM, when creating a reply or a new mail/news message, you can switch 
from the dialog box to the standard Sytem Manager applications by using the
blue keys. You can now use the phone book application as an address book!

When saving a message to a folder, you are prompted with a "Combo box" which
has a drop down list of your existing folders.

When saving messages to folders, PNR tracks which were "sent" messages and 
which were "received" messages. Replying to Sent messages is treated as
resending them.

3. Major changes between version 3.5 and version 3.2:

PNR was made more robust in the face of disk full errors.  The
intention is that the worst that can happen is that all your
deleted and read messages are set back to being unread.

4. Major changes between version 3.2 and version 3.1:

The DOS executables (PNR.EXE and PNRTI.EXE) are now compiled in large mode,
which effectively removes the memory limits detailed below in version 3.1 and
earlier.  The capacity of the DOS version of PNR is now limited only by the
amount of free disk space to store the messages.  Note that the System Manager
compatible PNR.EXM still has the limits detailed in version 3.1 (the memory
limit is due to the 64k data limit imposed on EXM programs), so if you wish to
use PNR.EXM, you should limit the number of articles per folder to about 400.

PNRTI now threads mail and news instead of sorting alphabetically.  This means
that the order in which the articles were received is retained, except that
articles with the same subject (excluding a single "Re: " prefix) are grouped
together.  The nomailsort and nonewssort configuration options have been
renamed to nomailthread and nonewsthread, and will turn off the default
threading behaviour.  Note that the threading is only based on the subject
line, and does not take the References header into account.

5. Major changes between version 3.1 and version 3.0:

PNR now deletes any read news when you exit, and stores enough information
about the unread news so that LXPOP and LXNNTP can add any newly downloaded
messages to the unread news that was previously downloaded.  This allows you
to send replies or download a new batch of news before you have finished
reading the news you already have on the palmtop.

Don't forget that there is a memory-induced limit of about 400 messages of
unread news at any time, so if you have a large number of unread messages you
may want to save them to a new folder before downloading the new batch of
news (the number of folders is only limited by your disk space, but each
folder has a memory-induced limit of about 400 messages).

6. Major changes between version 3 and version 2:

Folders are now stored in separate folder files with corresponding article
index files.  The folder index file now contains an extra field for the
basename of the folder file.

The combination of this change, and the fact that folders are now stored in
Unix MMDF format, is the first step to mail and news interoperability between
the HP Palmtop and the Unix desktop.

This major format change also improves the speed of saving index files (as
article folder files and article index files for groups that have not been
modified do not need to be rewritten).

This change was also the enabling step for being able to re-save messages from
one folder to another.

Outgoing mail and news messages may now contain a Cc: header line.  Adding a
Cc: header line to a posted news article means that a copy of the article is
also mailed to any addresses in the Cc: header line.

The message handling routines have been improved to remove the 64KB limit on
message size.  The maximum size of a message is now 2048MB.

7. Major changes between version 2 and version 1.2:

PNR version 1.2 and earlier relied upon UQWK to gather mail and news.

Version 2 of PNR interfaces with the HP200LX TCP/IP Development Kit (LXTCP)
which includes clients for POP/SMTP and NNTP.

If you do not have access to a TCP/IP connection (either via dial-up PPP to an
ISP, a serial cable PPP connection or an PCMCIA ethernet card with a packet
driver), then you should NOT upgrade to version 2 or later of PNR, as the UQWK
support has been removed.  Just about every ISP uses PPP these days, so get
with the times and use PPP :-).

If you only have dial-up or direct-cable access to a Unix shell account, then
you can still use the 'slirp' program to emulate a PPP connection for LXPPP.


PNRTI
-----

1. Major changes between version 3.6  and version 3.5

The PNRTI program has been updated to operate with version 3.6 or later of PNR,
especially with regards to the "lock" file.



--
David Becher, 20/02/01.

