NewsWerthy William Werth Version INT

Found at: 0x1bi.net:70/textfiles/file?internet/nwerthy.man

                 NewsWerthy     (C) 1994, 1995 William Werth

                 Version 2.00

            I.   INTRODUCTION TO NEWSWERTHY                            2
                1.  WHAT IS NEWSWERTHY?                                2
                2.  SYSTEM REQUIREMENTS                                4
                3.  CONTACTING THE AUTHOR                              4
                4.  REGISTERING NEWSWERTHY                             4
                5.  DISCLAIMER                                         5
                6.  THANKS AND KUDOS                                   6
            II.  QUICK START PROCEDURE                                 6
            III. USING NEWSWERTHY                                      7
                1.  SETTING UP THE HOST (BBS) FOR SOUP PACKETS         8
                3.  UPLOADING A REPLY PACKET TO THE HOST (BBS)        10
                4.  READING THE MESSAGES IN THE MAIL PACKET           10
                5.  SEARCHING MESSAGES IN THE MAIL PACKET             12
                6.  REPLYING TO A MESSAGE                             13
                7.  POSTING A NEW MESSAGE TO A NEWSGROUP              15
                8.  SENDING AN EMAIL MESSAGE                          15
                10. SAVING MESSAGES                                   16
                11. PRINTING MESSAGES                                 17
                12. UQWK COMMANDS                                     17
                13. USING THE KEYBOARD                                17
                14. USING THE MOUSE                                   19
                15. CONFIGURATION                                     20
                        DIRECTORIES & UTILITIES                       20
                        MESSAGE OPTIONS                               21
                        DATA-BASING OPTIONS                           22
                        PRINTER OPTIONS                               23
                        COLORS SETUP                                  24
                16. VIEWING A FILE                                    24
                17. ABOUT NEWSWERTHY                                  24
            IV.  EXAMPLE USES OF NEWSWERTHY                           25
                1.  SEVERAL PACKETS, ONE REPLY PACKET                 25
                2.  WITH PGP                                          26
                3.  WITH LAPTOPS                                      26
                4.  WITH TAGLINE MANAGERS                             26
                5.  WITH MULTIPLE USERS                               27
            V.   GLOSSARY                                             28
            VI.  INDEX                                                30



            This section is an introduction to NewsWerthy and
            registration requirements.

            1.  WHAT IS NEWSWERTHY?

            NewsWerthy is an off-line message reader for the SOUP
            format. This is the format generated by uqwk, when used with
            the +L parameter (but not the only way to make a SOUP

            NewsWerthy can be used as a packet reader, or as a data-
            basing reader. With NewsWerthy you can read one packet, or
            messages from several packets at a time. Your position in
            the packet and which messages have been read are saved, so
            you can return to where you left off, and continue reading
            messages. If you want to keep any messages, they can be
            saved to folders. In data-basing mode you have several
            options as to how messages are expired, otherwise in packet
            mode they are deleted when a new packet is opened.

            NewsWerthy has a user interface with familiar pull down
            menus and context sensitive help that can be accessed easily
            with the keyboard or mouse. It has all the features you'll
            need to read, reply and save messages for later reference.
            It has several options for reading mail, depending on your
            preferences. You can easily read all messages, or just a few
            by using its search capabilities.


            * A data-base of all your messages or just the current
              packets messages can be read.

            * Shell to DOS anywhere (yes anywhere with Ctrl-S).

            * An address book for email addresses with an alias for each

            * Edit messages using your favorite editor.

            * Print all or part of a message.

            * Replies to a message in a newsgroup can be sent by email
              or to the newsgroup.


            * Replies can be re-sent if auto-saved.

            * Messages can be forwarded using email.

            * Automatically appends a signature file to your replies.

            * Save messages to a folder using a pick list of names up to
              80 characters long (no DOS filename limit).

            * Append or overwrite all or part of a message to a text

            * Delete unwanted messages.

            * Search for a message using any combination of 1) Key words
              in the message text 2) Subject 3) From.

            * Uses "smart searching" (remembers what you last searched
              for in a newsgroup).

            * All setup is integrated into the program, including color
              selection. No need to use a text editor on the
              configuration file.

            * Configurable to your message reading style.

            * Context sensitive help is displayed when F1 is pressed.

            * Pull down menus, with a hint line on the bottom of the
              screen, for the usage of each menu item.

            * Supports monochrome, B/W and color monitors.

            * Quoted text in messages is color highlighted.

            * Marks read, saved or killed messages.

            * Sort messages on date, author, subject or no sort.

            * Remembers what newsgroup and what message you were last
              reading, to easily pick up where you left off reading.

            * RFC-822, RFC-1036 & SOUP compliant.

            * Will optionally word wrap the displayed message.

            * Sorts mailing lists into their own separate "news" group.

            * Files can be attached to replies using UUEncode, XXEncode
              or Base64.


            * Attached files in a message, in any of the above three
              formats can be saved to a text file.

            * Different setups can be used for each user (see section IV
              of manual).


            An IBM PC or compatible with DOS 3.0 or higher. The monitor
            can be monochrome, hercules or color. A hard drive with
            several megabytes free.


            If you have any questions, comments or need technical
            support, feel free to contact me in one of the following

            1) By email at billw@eskimo.com

            2) I monitor the usenet newsgroup alt.usenet.offline-reader.

            3) By mail at the address listed for registration.

            4) In person at (206) 258-1755, evenings 5pm to 10pm Pacific
            time and weekends.


            Why register? Registering removes the opening unregistered
            message. The helpful (for new users) but somewhat annoying
            "Are you sure you want to edit the message selected?"
            message, plus several others are also disabled. Registered
            users who provide an email address will receive notice of
            any significant updates.

            There is also a 30 day evaluation period on the data-basing
            feature. After 30 days and 15 uses you will be asked to
            register. After 60 days and 30 uses, you will only be able
            to read new packets in the packet mode.

            Registered users will be able to use the protected mode
            version of NewsWerthy. It is the same as the shareware
            version, except that it requires a '286 or better CPU and
            uses virtual memory. This allows very large messages and

            newsgroups to be read, since it is not limited to
            conventional memory.

            Also if you find this program useful, you will surely want
            to see more features added. This can only happen if I
            receive your support. Many hours of work have gone into
            making this program, so send in the registration form and
            you will receive a registration number. Your registration
            will also be good on future updates.

            The registration form can be printed by pressing P at the
            opening screen.

            NewsWerthy is released as shareware. You are encouraged to
            make copies and distribute them for others to use. The only
            restriction is that the copies are in their complete and
            unmodified form. A list of all the files is in the
            README.TXT file.

            To continue using NewsWerthy past the evaluation period,
            send $25 US to the address below:

               William Werth
               4404 Terrace Dr. #4
               Everett, Wa 98203

            If you don't use the registration form, be sure and include
            your email address and the name to register NewsWerthy
            under, so I can send you a registration code number. If
            you'd like me to send your registration code by snail mail,
            include your mailing address.

            5.  DISCLAIMER

            This program has been thoroughly tested but due to the
            complex nature of today's hardware, the author, William
            Werth, makes no warranty of any kind, express or implied,
            including without limitation, any warranties of
            merchantability and/or fitness for a particular purpose.
            William Werth will not be liable for any damages, whether
            direct, indirect, special or consequential arising from
            failure of this program to operate in the manner desired by
            the user. William Werth shall not be liable for any damage
            to data or property which may be caused directly or
            indirectly by the use of this program.


            6.  THANKS AND KUDOS

            I want to thank my beta testers for making NewsWerthy what
            it is.

            Arnie, who named NewsWerthy.

            Also my girlfriend Juanita, who showed great patience while
            I worked many hours on NewsWerthy.

            Rachel Polanskis, who gave me the motivation to add
            attaching files.


            Be sure to read the README.TXT file for installation
            instructions. Once you've installed NewsWerthy you'll want
            to run NWERTHY.EXE.

            NewsWerthy is easy to use and takes a minimum of set-up. You
            can always hit the F1 key to get help, or wing it, since you
            will be warned of any non-recoverable actions. Most commands
            are executed with a single key press indicated by the
            highlighted letter in the menu or on the status line. On
            start up it will go straight to the configuration dialog if
            no previous set-up exists, otherwise Alt-c will get you to
            the configuration menu. If you are unsure of any
            directories, you can press Ctrl-S to shell to DOS. You will
            probably be able to use most of the defaults, but will need
            to set up the following:

            1. Download Directory - Enter the drive and directory where
                 the mail packet is located. A filename like ESKIMO.ZIP
                 or ESKIMO*.ZIP can be included too. Including the
                 filename in the registered version causes the file
                 dialog to be skipped, and instead goes directly to
                 unzipping the mail packet.

            2. Upload Directory - Press Tab to move to this field. Enter
                 the drive and directory where your communication
                 program expects to find files to upload. The reply
                 packet will be placed here and will be named similar to
                 the mail packet, except the extension will be .REP. I
                 named my mail packet ESKIMO.ZIP which then translates
                 to ESKIMO.REP for the reply packet.


                 Or instead, include the full pathname of the reply
                 packet to always create the same name for the reply
                 packet, no matter what the name of the mail packet.

            3. Work Directory - Press Tab to move to this field. Make
                 this a subdirectory of where NWERTHY.EXE is stored.
                 Something like C:\NWERTHY\ESKIMO will work fine. While
                 reading messages, files in this directory are read, so
                 be sure to put this one on the hard drive. Don't use a
                 ram drive, if you want NewsWerthy to remember your last

            3. Folders Directory - Press Tab to move to this field. Make
                 this a subdirectory of where NWERTHY.EXE is stored.
                 Something like C:\NWERTHY\FOLDERS

            4. Text Editor - Press Tab to move to this field. The editor
                 is only needed if you plan to edit files or reply to
                 messages. Enter the drive and directory where your
                 editor can be found. Select an editor that can handle
                 lines longer than 80 characters. Also error handling
                 works best if the editor returns an error level other
                 than 0 on failure. DOS Edit is a good editor to start
                 out with. No matter what editor you chose, make sure
                 you always save as a text (ASCII) file.

            Press Enter after any changes are made to save them or
            Cancel to ignore them.

            If you already have a SOUP packet, press F3 to unpack it.
            Select Yes when prompted to read it, and use the normal
            cursor keys, plus the space bar to view the messages.

            The manual can be printed by entering from the DOS prompt:

               COPY NWERTHY.DOC PRN  (press return)

            The manual is formatted for 51 lines per page with a top
            margin of .4 inches. The margins are 1.25 inches for 60
            characters per line. This should make it printable to single
            or continuous sheets with no changes needed.


            NewsWerthy contains plenty of on-line, context sensitive
            help (press F1) and is so easy to use you'll probably never
            need to read most of this. But if you are new to off-line


            mail reading, get stuck or just like reading manuals then
            here is what you'll need to know.


            NewsWerthy is designed to work with the SOUP format, which
            generally means using uqwk. Uqwk generates an AREAS file and
            .MSG files containing the messages from the newsgroups
            you're subscribed to, plus your email.

            First verify uqwk is available on your BBS. Don't enter uqwk
            to test this, instead enter man uqwk, and while you're at it
            you might want to at least read the first paragraph or two.
            If uqwk is not available, contact your system operator on
            how to generate SOUP packets.

            To automate using uqwk you'll want to use something like the
            following script on your host system. This script file is
            included in the distribution, but here is a copy for your
            reference. All lines that start with #, except the first are

            # Usage: soup [ upload ]

            # Process reply packet if requested
            if [ $# -gt 0 ]
              if [ $1 = "upload" ]
                echo start your upload of yourbbs.rep now!
                unzip -U yourbbs.rep
                uqwk -m -n +L -RREPLIES
                rm yourbbs.rep

            # Check for an existing packet
            if [ -f "yourbbs.zip" ]
              echo Warning - found an unsent yourbbs.zip file!
              sz -u yourbbs.zip

            # Copy your newsgroups file to a backup directory as a
            # precaution
            cp .newsrc backup


            # Collect your unread mail and news in SOUP format
            # change -B8000 to -B0 for no limit on packet size
            uqwk +m +n -z +L -B8000

            # Zip it up, and delete files if successful
            zip -m yourbbs AREAS *.MSG

            # Download it to your PC
            sz -u yourbbs.zip

            The above file (soup) must be first transferred to your BBS
            using the UNIX upload command rz at the UNIX prompt.

            Now you'll need to make the script executable and also make
            the backup directory. To do this, enter the following at the
            UNIX command prompt:
                chmod u+x soup
                mkdir backup

            You may also want to change all "yourbbs" entries to the
            name of your BBS.

            If you have any problems getting the above to work, what
            follows is further explanation of the script to help in
            locating the trouble. If a particular command works
            differently on your system, check the manual, for example
            "man zip". All lines starting in #, except the first are

            Here are the commands used for replies:

            rz - Starts the upload of the YOURBBS.REP using the zmodem
            protocol. If your communication package doesn't support
            zmodem, change this to something like rx.

            unzip -U yourbbs.rep - The -U switch forces the files in the
            archive to be uncompressed to uppercase, this may the
            default, but is included just to be sure.

            uqwk -m -n +L -RREPLIES - The +L indicates SOUP format, the
            -R contains the name of the file which points to the
            messages files (R0.MSG, etc.). The -m and -n ensure no mail
            or news is lost.

            rm yourbbs.rep - Deletes the reply packet.

            Here are the commands used for collecting news and mail:

            uqwk +m +n -z +L -B8000 - The +m and +n, indicate include
            mail and news. The -z is there just in case someone has set


            the environment variable for Zipnews format on your host (-z
            turns it off).

            zip -m yourbbs AREAS *.MSG - The -m deletes the AREAS and
            *.MSG files once successfully compressed into the packet.

            sz -u yourbbs.zip - The -u unlinks (deletes) the packet once
            successfully sent.


            Log onto your BBS and go to a UNIX command prompt. Then run
            the above SOUP UNIX script from the command line like so:
                soup download
            If your communications program has auto zmodem disabled you
            will need to start zmodem manually. The commands from the
            script can also be entered one at a time to get the same
            effect (skip the if then lines).


            Log onto your BBS and go to a UNIX command prompt. Then run
            the above UNIX script from the command line like so:
                soup upload

            If for some reason you encounter an error and your news is
            lost before you get a chance to read it, simply enter the
            following at the UNIX command prompt, to restore your news:
                cp backup\.newsrc .
            Then repeat the download process. Although this restores the
            news pointers, any email that was collected, will be lost.


            After hitting a random function key (if unregistered), you
            have two ways to get started. You can use either the menus
            at the top or the function keys at the bottom of the screen.
            Besides the initial setup or odd command, the function keys
            will be almost all you'll ever need.

            To prepare a packet for reading, select New Packet (F3).
            Select the packet using the dialog and press Enter to
            uncompress your mail and generate the necessary indexes.


            Next, to read your news and mail, select Read News (F4).
            Pressing the space bar will allow you to read your mail
            sequentially from start to finish. If you read most
            messages, you may want to select the "Esc to Index" option
            from the Message Options dialog under the setup menu.
            Otherwise use the "Standard" option and read the section on
            USING THE KEYBOARD to select and read those you're
            interested in.

            If you press the space bar to read a newsgroup, only unread
            messages are shown. To see read, plus killed messages, press
            the Enter key to read a newsgroup.

            NewsWerthy automatically puts mail from mailing lists into
            separate "news" groups. It does this by reading the message
            headers To:, Cc:, Sender: and Originator lines. This may not
            work 100% consistently, because mailing lists aren't 100%
            consistent. To help NewsWerthy be much more accurate in
            separating your personal mail, be sure to enter your email
            address in the Reply-To picklist (the Cc: line is checked
            from this). To make the mailing lists more accurate, add
            it's email address to the address book and check the mailing
            list box. Your email is also put into a group called "all",
            if you prefer to read it all together.

            One way to limit the messages you read is to generate kill
            files by selecting Kill while reading the message. This
            brings up a dialog that lets you choose between killing all
            messages that match that subject or all messages from that
            author. Wildcards can be used and are explained in the on-
            line help. Kill files can only be used if you reading
            messages in the data-basing mode.

            The message list defaults to a sort on the subject. This can
            be changed temporarily to sorting on the date, author or no
            sort as an aid in finding a message. A sort on none will
            display the messages in the order they were saved to the
            file, with the newest first. To change the sort, select Sort
            Messages from the status line of the messages list.

            Messages are flagged read after you view them. This is
            indicated by "READ" in the upper right of the message and an
            asterisk at the beginning of each message list entry. Read
            messages will be skipped if you're using the space bar,
            otherwise use the Enter key to read messages marked with an
            asterisk. The - and + keys can be used to go to a read
            message. To mark all messages as read or unread in a
            newsgroup, select the appropriate command from the
            Newsgroups list (the first list displayed after selecting
            Read Mail).


            If you come across a message that looks like gibberish, try
            pressing Alt-R, to ROT-13, the message. Hitting ALT-R twice
            restores a message back to its original state.

            If error messages occur while reading messages, the index or
            book mark files may have become corrupt or deleted. Select
            Restore Indexes from the News Incoming menu to generate new
            indexes (*.IDX) and book marks (*.BKM) from the message
            (*.MSG) files. You'll need to enter the filename of the
            packet if not present in the input line that appears. The
            name and extension is all that is required.


            You can select the messages you read by selecting Find from
            the message list. This brings up a dialog that lets you
            search messages three ways. A search can find any matches in
            the text, subject or author of the message. These can be
            used separately or in combination, with the messages that
            match appearing in a message list. More than one phrase can
            be entered on an input line, by separating them with
            semicolons (;). All searches are case insensitive (matches
            either upper or lower case).

            When you use the find dialog, you may notice that some of
            the input fields are already filled in. This is what I call
            "smart searching". If you usually search a newsgroup for the
            same text, NewsWerthy will remember this, and fill in the
            field for you. In order for this to work, you need to do two
            things: 1) Add the search string to the appropriate picklist
            (open the picklist by pressing the down arrow key, then
            press "Alt-A" to add it). 2) Select the search string from
            the picklist and press Enter to start your search. If there
            is no previous search string for the newsgroup, NewsWerthy
            will fill in the fields with whatever was used last.

            Messages can be searched on the text portion of the message.
            As an example, if you enter "10 speed;15 speed" (don't enter
            quotes) then any message with either the phrase "10 speed"
            or "15 speed" in it or in the subject will appear in the
            Matches in message list. When you read the messages, the
            line where the match occurred will be highlighted (only the
            first match is highlighted).

            Messages can be searched on the message Subject or From
            line. Messages that match anywhere in these lines will
            appear in the Matches in message list. If a message doesn't
            contain a From line, the To or Newsgroups line will be
            searched instead.

            Text in a single message can be searched by pressing "X" for
            Text search, from the message viewing screen. This operates
            similar to the Find command. The line that contains a match
            is highlighted in the center of the screen. This is useful
            for finding something in the middle of a long message such
            as a FAQ. Additional occurrences of the search phrase can be
            found by hitting the "+" key.

            6.  REPLYING TO A MESSAGE

            While reading a message, select Reply, which will bring up a
            dialog. Select Mail to send a private message, News to reply
            in the newsgroup, Forward to send the message by email to a
            friend or Mailing List (if an email message) to send a
            message to a mailing list (the email address in the To:
            line). Select Re-send Mail only from the auto-saved.replies
            folder to add that message to the reply packet. The default
            is to quote the message for all of the above, but Don't
            Quote can be selected to start from scratch. To send a new
            message use Post New Msg from the message list, or Send News
            or Send Mail from the Mail Outgoing menu, not the Don't
            Quote option.

            When a message is forwarded, a dialog lets you indicate who
            you want to send it to. A few extra header lines are added
            to indicate who the message was originally from. It is then
            quoted and loaded into your editor. This gives you a chance
            to delete a portion or add a note for the recipient.

            Read RFC1036 for detailed information on the message
            headers, otherwise read on. Only the Newsgroups and Subject
            are required, and should be entered in the Message Reply
            Options dialog as follows:

            To - This is the email address of the recipient of the email
            message. An alias from the address book can be entered here.
            An entry from the address book can be selected by pressing
            the down arrow key.

            Each alias in the address book must be unique and not
            contain an "@" character, but can contain spaces. The email
            address is substituted for the alias when the message is
            sent. Multiple email addresses and/or aliases can be entered
            on the email address line. The only limits being that not
            more than 255 characters can be entered and it can't expand
            to more than 1023 characters. Separate each address/alias
            with a single comma and a space (, ).


            Cc - This is used to send a Carbon Copy to 1 or more email
            recipients. The easiest way to send email to group of people
            is as follows: Define an alias in the address book that
            expands to all the email addresses in the group. Then enter
            just the alias on this line.

            Bcc - Virtually the same as Cc, except that this line may
            not appear in the header of each of the recipients messages.

            Newsgroups - The Newsgroup is filled in for you
            automatically. To post to a different newsgroup, select one
            from the pick list by pressing the down arrow key or enter
            it in. To cross-post the message to several newsgroups,
            separate each with a comma (,) and no spaces. Replying to a
            cross-posted message will maintain the original distribution
            unless you edit this line.

            Subject - NewsWerthy will add Re: to the current subject for

            Followup-To - This is used to indicate a different newsgroup
            for replies to be sent to.

            Keywords - A few well selected keywords identifying the
            message can be entered.

            Summary - A brief summary of the message.

            Reply-To - To indicate an email address to send replies to.

            Organization - To indicate the organization you belong to.

            Extra Header - To add any headers lines not listed above.
            You'll need to enter the name of the header ending with a
            colon (:), a space, and the contents of the header line.
            When adding a non-standard header line, start it with X-.

            To attach a file to your message select Attach File (Alt-F).
            Then select which encoding method you want to use.
            UUEncoding is probably the most universal format, but
            XXEncoding is more likely to make it to the recipient of the
            message un-altered. Choose Base64 if the recipient of the
            message uses a reader that supports MIME. Large files will
            be split into multiple messages of 850 lines each or about
            38k. There is a limit of 99 messages per attached file
            (about a 4 meg file). I don't recommend adding a signature
            to your message when using this option. NewsWerthy handles
            this fine, but other decoders may not be able to re-create
            the file, unless it is removed.


            The editor you've entered in the Directories Setup is used
            to enter the message. Save the file as a text (ASCII) file
            and exit from your editor once you're done. Signatures can
            automatically be appended to your messages. Simply use your
            editor to enter into a file the text you want appended to
            the end of each reply. Name this file NWERTHY.SIG and store
            it in the work directory.

            When you're finished reading your messages, any replies
            you've entered are compressed and stored in the Upload
            Directory. If you've selected Auto-Save Reply the message is
            also stored in the auto-saved.replies folder.


            Posting a new message is nearly the same as replying to a
            message. The main differences are as follows:

            To post a message to a newsgroup, select Post New Msg from
            the messages list. You'll need to enter a subject. Choose a
            descriptive topic, something like Help me, isn't likely to
            generate a lot of interest.

            You can also post a new message to a newsgroup by selecting
            Send News from the Mail Outgoing menu.


            To enter an email message, select Send Mail (F7) from the
            menu screen, enter an email address to send the message to
            (or pick one from the picklist) and proceed the same as for
            Post New Msg.


            Select Review Replies (F8) from the menu screen to read your
            replies. Select Read Stored (F6) from the menu screen to
            read messages saved to folders.

            While at the message list or message viewing screen, a
            message can be deleted or edited. A reply can also be edited
            by pressing R (Reply). When editing a reply, be careful what
            changes you make to the message header. A temporary file
            with an odd name ending in something like .AAA is created to


            edit the message. Select save and exit from your editor when

            Once you delete a message, its gone forever, so make backups
            if you can't afford to make mistakes.

            Replying to a reply, allows you to change any of the headers
            using the same dialog that you originally created it with.
            There are some restrictions though. The To line will be
            truncated to 255 characters, but can be re-entered, if this
            happens. The Extra Header line will only be automatically
            added to the dialog if it is present in the picklist. If you
            have added any header lines by manually editing the message,
            they will be lost.

            10. SAVING MESSAGES

            Selecting Save while viewing a message brings up a dialog.
            The default is to save to a SOUP format (binary mail)
            folder. If the current newsgroup name matches one in the
            newsgroup pick list, it is displayed, otherwise whatever was
            entered previously is used. The default can be used or one
            can be selected from the pick list.

            If you'd rather append or overwrite all or part of the
            message to a DOS text file, select Save to Text File. Use
            the dialog to select or enter a DOS filename for saving.
            Select the OK button to append or the Replace button to
            overwrite the selected file. To save only a portion of a
            message to a DOS text file, highlight it using Top  (mark
            top) and Bot (mark bottom), then save as described above.
            You can press Alt-T from the message to go directly to Save
            to File dialog.

            If the message contains an attached file, it can be saved to
            a file by selecting Save Attached File (Alt-A). The dialog
            that then appears works the same as the one to save to a
            text file. NewsWerthy supports the 3 most popular formats
            for DOS PC's, which are UUEncode, XXEncode and Base64.
            Base64 is part of MIME, and the only support for MIME found
            in NewsWerthy. If the attached file spans multiple messages,
            simply save them in order, appending them to the same file,
            to recreate the binary file.


            11. PRINTING MESSAGES

            Select print, to print the current message to your printer.
            If your printer is off-line, you'll be prompted until you
            either turn it on or select cancel. To print only a portion
            of a message, highlight it using Mark Top and Bottom, then
            select print.

            If you want the last page printed to eject, select this
            option from the Setup menu, in the Printer Options dialog.

            12. UQWK COMMANDS

            Uqwk provides commands to unsubscribe, subscribe, catchup or
            list newsgroups. A shell command can also be run, with the
            output from standard output mailed back to you. Normally you
            would enter an email message to uqwk.

            To simplify sending commands to uqwk, select Uqwk Cmds from
            the newsgroup list. Use this dialog as many times as you
            like. Some other readers are limited to only one message to
            uqwk. NewsWerthy avoids this limitation by saving your
            commands and then entering them in one message, and placing
            this at the end of the reply files.

            The current newsgroup is saved one key away in the Uqwk
            dialog. To unsubscribe to a newsgroup select Uqwk Cmds,
            Press down arrow and press Enter twice. That's all there is
            to it.

            13. USING THE KEYBOARD

            The following keys can be used in dialog boxes.

            Esc        - Exit this screen and go back to the previous
                         screen (exits program when menu is displayed).
                         Cancels any changes made.

            Enter,     - Enters any changes made or chooses the selected
                         button, same as selecting a button with the

            Tab        - Go to next option

            Shift-Tab  - Go to previous option.


            Down arrow - Opens up a history or pick list if available.

            Hot Key    - Press the letter that is highlighted of the
                         item desired. If the cursor is presently in an
                         input box, press and hold the Alt key, then the
                         highlighted letter.

            Supports some word star control key combinations one of
            which is:

            Ctrl-y     - Delete line.

            The following keys are used when viewing a message or list.

            Esc, Del       - Displays the message list if viewing a
                             message, or the newsgroup list if viewing
                             the messages list.

            Enter          - Go to next message unread message or
                             selects the message from a list.

            Tab            - Go to next subject.

            -              - Go back one message.

            +              - Go forward one message (even if read).

            , Ins   - Next page or next unread message if at end
                             of message.

            Page Down      - Next page, stops at the end of the message.

            Page Up        - Previous page, stops at the first line of
                             the message header if reading a message.

            Ctrl-Page Down - Goes to the last line in the message or

            Ctrl-Page Up   - Goes to the first line in the message.
                             header or list.

            Home           - Goes to the start of the message or the
                             first line displayed in a list (not
                             necessarily the first line in the list).

            End            - Goes to the end of the message or the last
                             line displayed in a list (not necessarily
                             the end of the list).


            Arrows         - Arrows scroll text up and down, right and

            Ctrl-arrows    - Right and left arrows in combination with
                             the control key, goes to the end of the
                             line or the start of the line.

            Note that by turning off the Num Lock on your keyboard,
            messages can be read using only the keys on the keypad. The
            Ins key is used to go to the next message instead of the
            space bar, and the Del key instead of the Esc key using this

            Pick lists are used to save information on disk, such as
            newsgroup names, email addresses, search phrases and such.
            They can be accessed by selecting an input line, then
            pressing the down arrow. If its a pick list (instead of a
            history list), you'll see several commands on the hint line.
            These are as follows:

            Add      - Press Alt-A to add an item to the pick list.
                       Duplicates aren't allowed.

            Edit     - Press Alt-E to Edit an item in the pick list.

            Delete   - Press Alt-D to delete an item from the pick list.

             14. USING THE MOUSE

            I won't go into too much detail, but here is how to use the
            mouse with NewsWerthy:

            The message or a list can be scrolled by clicking on the up
            or down arrow on the scroll bar to the right of the window.
            Hold the mouse button down while pointing at the position
            icon and slide it up or down to change position in the
            window. Clicking above or below the position icon, scrolls
            up or down a page at a time.

            Windows can be closed by clicking on the close icon in the
            upper left corner.

            Buttons and other objects are selected by a single click on
            them with the mouse pointer.

            An item in a list may open a new window if double-clicked.
            For example, in the message list, double-click on a subject
            to read that message. Double-clicking has the same effect as
            pressing the Enter key.

            Pressing the right mouse button with the pointer in the
            center portion of the window, has the same effect as
            pressing the Esc key.

            Double-clicking with the left mouse button on the message
            text is the same as pressing the Enter key.

            Clicking on any item in the status line (the bottom line)
            has the same effect as pressing the hot key.

             15. CONFIGURATION

            Should you need to verify or create directories, you can
            press Ctrl-S for a Dos Shell.

            Alt-c will get you to the configuration menu from the menu

            The Directories & Utilities dialog contains the following:

            1. Download Directory - Enter the drive and directory where
                 the mail packet is located. A filename like ESKIMO.ZIP
                 or ESKIMO*.ZIP can be included too. Including the
                 filename in the registered version causes the file
                 dialog to be skipped, and instead goes directly to
                 unzipping the mail packet.

            2. Upload Directory - Press Tab to move to this field. Enter
                 the drive and directory where your communication
                 program expects to find files to upload. The reply
                 packet will be placed here and will be named similar to
                 the mail packet, except the extension will be .REP. I
                 named my mail packet ESKIMO.ZIP which then translates
                 to ESKIMO.REP for the reply packet.

                 Or instead, include the full pathname of the reply
                 packet to always create the same name for the reply
                 packet, no matter what the name of the mail packet.

            3. Work Directory - Press Tab to move to this field. Make
                 this a subdirectory of where NWERTHY.EXE is stored.
                 Something like C:\NWERTHY\ESKIMO will work fine. While
                 reading messages, files in this directory are read, so
                 be sure to put this one on the hard drive. Don't use a
                 ram drive, if you want NewsWerthy to remember your last
                 session. This directory will be created if it doesn't
                 already exist.


            3. Folders Directory - Press Tab to move to this field. Make
                 this a subdirectory of where NWERTHY.EXE is stored.
                 Something like C:\NWERTHY\FOLDERS

            4. Text Editor - Press Tab to move to this field. The editor
                 is only needed if you plan to edit files or reply to
                 messages. Enter the drive and directory where your
                 editor can be found. Select an editor that can handle
                 lines longer than 80 characters. Also error handling
                 works best if the editor returns an error level other
                 than 0 on failure. No matter what editor you chose,
                 make sure you always save as a text (ASCII) file.

            The Message Options dialog contains the following:

            1. News Quote or Mail Quote Format - The first line of the
                 quoted text can contain information from the quoted
                 message's header, such as the name of the author or the
                 message Id. The newsgroup name can also be included.
                 The following variables can be used:

                 %A  Address (Email)
                 %D  Date
                 %F  Full address
                 %G  Groupname
                 %M  Message Id
                 %N  Name of author

                   On %D in %G you wrote:
                   In %M, %F wrote:

                 The above would expand to:

                 On 26 Aug 1994 08:30:00 -0800 in alt.usenet.offline-
                 reader you wrote:

                 In <2megq8$452@agate.berkley.edu>, William Werth
                 (billw@eskimo.com) wrote:

                 Note: %M is not present in an email message

            2. Quoting Characters(s) - When replying to a message, the
                 text of the message can be quoted. Up to two characters
                 can be added to the beginning of each quoted line. To
                 add a space use the underscore (_).

                 For example ">_" would add a ">" character and a space
                 at the start of each quoted line.


            3. Word Wrap - Select this option to avoid having to scroll
                 horizontally, to read lines longer then 78 characters.
                 They will wrap around to the next line instead. This
                 also will expand tabs to 8 spaces instead of one space.

            4. Quote with Initials - When replying to a message, the
                 text of the message can be quoted. In addition to the
                 two characters that can be added to the beginning of
                 each quoted line, the authors initials can be added.

            5. Message Reading Style - There are two ways to read
                 messages. The first "Standard" displays a message, then
                 returns to the message list, where you can select the
                 next message to view. You'll probably prefer this if
                 you are reading only a few of the messages. The second
                 "Esc to Index" displays a message, then goes to the
                 next unread message. Esc must be pressed to see the
                 message list. You'll probably prefer this if you are
                 reading most of the messages.

            6. Message Threading Style - Message subjects (along with
                 number of lines and the author) are displayed in a
                 selection list. There are two ways to sort the subject
                 and three ways to display it.

                 The first sorting method puts all subjects starting
                 with "Re:" with other messages starting with R (this is
                 the "Normal" sort). The second method ignores the
                 "Re:", and sorts on the text that follows, grouping
                 replies with the original message (this is the "Don't
                 sort on Re:" sort).

                 The second display method shows subjects without the
                 "Re:" (this is the "Don't display Re:" sort). The third
                 display method displays the subjects without the "Re:",
                 and one ">" appended in front of the subject for each
                 reference, in the References: line (this is the
                 "Indicate thread depth" sort). A maximum of ten ">"
                 will be added. This gives an indication of how long the
                 thread has been active. If it is an email message
                 instead of in a newsgroup, the subject with the "Re:"
                 will be displayed for this last option.

            The Data-basing Options dialog contains the following:

            1. Expiration Options - There are four different ways to
                 expire a message. When a new packet is opened, expired
                 messages are deleted. These options can be applied to
                 an individual newsgroup or from the Setup menu to apply
                 to all newsgroups.


                 Expire All Messages - This expires all messages in a
                 newsgroup. If selected from the Setup menu, this puts
                 NewsWerthy in packet mode (non-data-basing mode).

                 Expire Old Messages - This expires all messages older
                 than the "Expire Old Messages (Days)" amount.

                 Expire Read Messages - This expires all read messages.

                 Expire Killed Messages - This expires all messages
                 marked killed by matching entries in a kill file.

                 Save Read Messages - This saves read messages to the
                 folder named in "Save Read Messages to Folder" entry.
                 Saved messages are not deleted, and will not be saved,
                 if they have been previously saved.

            2. Expire Old Messages (Days) - Any messages older than this
                 number of days will be expired if "Expire Old Messages"
                 is also selected.

            3. Max. Messages in Newsgroup - When the number of messages
                 in a newsgroup exceeds this amount, the oldest messages
                 will be expired. New messages are then added, so the
                 actual number of messages in a newsgroup can exceed
                 this amount.

            The above options are also displayed at the top of the
            screen for the current newsgroup while reading messages. The
            options takes affect if set in the individual newsgroup or
            in the Setup menu for all newsgroups.

            4. Save Read Messages to Folder - Select a folder from the
                 picklist, where you want all read messages to be saved.
                 The messages will only be saved if "Save Read Messages"
                 is also selected. The message is not saved until a new
                 packet is opened.

            The Printer Options dialog contains the following:

            1. Lines to print per page - This is the number of line to
                 print per page for long messages. A printer that prints
                 using continuous feed paper usually prints 66 lines per
                 page. Subtract the number of lines you want for the top
                 and bottom margin and enter that number for this
                 setting. If you prefer no page breaks, set this to 0.

            2. Top Margin - The number of blank lines to print at the
                 top of every page.


            3. Eject Last Page - Select this to have the last page of
                 the message ejected when printed.

            The Colors Setup dialog - Colors can be easily changed using
                 the mouse, or through a combination of the tab and
                 arrow keys. Try changing only one color at a time and
                 then see its effect. Some changes effect only one
                 screen, but most change a similar type of object across
                 all screens.  There is also usually more than one place
                 where a color can be changed in the Colors dialog. Of
                 course this is only an option if you have a color

            16. VIEWING A FILE

            To view a text file select View File (F5) from the File
            Menu. Use the dialog to select a file. See USING THE
            KEYBOARD for the keys to use (same as those for a list).

            17. ABOUT NEWSWERTHY

            The replies to messages you enter are stored in several
            files ending with a .MSG extension. Replies to newsgroups
            are in R0.MSG. Mail replies are in R1.MSG. UQWK commands are
            in R2.MSG. Information for UQWK (or whatever you're using to
            process the SOUP reply packet) about the above files is
            stored in a REPLIES file. These are all zipped up
            automatically and stored in the upload directory under a
            file named the same as the SOUP packet, but ending in a .REP
            extension. If you were to manually create this rep packet
            you would enter: PKZIP YOURBBS.REP R?.MSG REPLIES at the DOS
            prompt. If the reply packet already existed you would add
            the -u switch to the above. Replies are deleted when a new
            packet is uncompressed.

            When an external program is run or the DOS shell is used,
            all but a few kilobytes of the executable is saved
            temporarily to either EMS, XMS or to disk, leaving more
            memory for a DOS shell or an external program like PKZIP. To
            make swapping more efficient (when there is no EMS or XMS
            memory) be sure to have either TEMP or TMP defined in you
            autoexec.bat file. These environmental variables are used
            for the swap file, and also for any temporary files created
            for editing a message.

            You will notice some files in your work directory with the
            extension .PL4, .PL5, .BKM, .DAT, .MSG and .IDX. Those

            ending in .PL4 and .PL5 are used to keep track of the kill
            files. Those ending in .BKM are used to keep track of which
            messages have been read. Those ending in .IDX contain the
            index information. Those ending in .DAT contain information
            about the newsgroups in the AREAS file. Those ending in .MSG
            are created by uqwk. Those ending with .PL and a number
            contain the pick lists.

            Once you've registered NewsWerthy, the file NWERTHY.KEY is
            generated. Don't delete this, else you'll have to enter your
            registration data again.

            You will notice that NewsWerthy doesn't put any .BAK files
            (backup files) in your work directory. This saves space and
            time but the trade-off is that if a disk error should occur
            while deleting or editing a message, the data could become
            corrupt or lost in that file. If you have critical
            information saved, I highly recommend that you make backups
            before editing or deleting any messages.

            The length of messages NewsWerthy can read is limited by the
            amount of free conventional memory in the shareware version.
            If a message is too long to fit in memory, you'll be given
            the option to save it to a file.


            In this section, I'll give examples of specific applications
            of using NewsWerthy. If you would like to contribute to this
            section, send me email about how you use NewsWerthy.


            You may want to read several packets, generate replies, and
            then upload a single reply packet. There are at least two
            possible ways to do this:

            1) If the news packets all have the same name, just reply no
            when prompted to delete the reply packet, and you can keep
            adding to it.

            2) If the news packets have different names, you will need
            to enter the full pathname of the reply packet for the
            Upload Directory, in the Directories & Utilities setup
            dialog. This will cause all replies to be added to this one
            reply packet.

            2.  WITH PGP

            Their are several ways to use PGP (Pretty Good Privacy) with

            1) I've included a batch file donated by a NewsWerthy user
            (it requires DOS 6.0 or better to run). I've called this
            pgpshell.bat. You'll want to edit it to include the name of
            your editor. In setup enter the pathname of this batch file
            for the Text Editor. When a message is edited the batch file
            will offer you a choice as to what you want done to the
            message. Then it calls your editor and you enter your
            message. And finally, the batch file executes the proper pgp
            commands to perform the desired function. If your not using
            PGS shell with PGP, you'll need to modify the batch file

            Last I checked, PGS was available in the security directory
            of SimTel as pgs099g.zip.

            2) Another option is to use AutoPGP. This is another shell
            for PGP that allows you to add commands (directives) to your
            replies and then modifies them according to those commands.

            AutoPGP is available at SimTel in the off-line directory as
            apgp212.zip. The next version of AutoPGP should be setup to
            automatically configure itself for use with NewsWerthy.

            3.  WITH LAPTOPS

            Many laptops have what is called a grey scale display. This
            looks similar to monochrome, but NewsWerthy will detect this
            as a color display. To make NewsWerthy detect this as a
            black & white display, for easier viewing, use DOS's mode

            There are two ways to do this. Either run the command "mode
            bw80" just before running NewsWerthy, or put this command in
            a batch file along with the command to start NewsWerthy, and
            run the batch file.


            There are several of these available at Simtel ftp sites.

            One which is easy to use is SigMX 3.30. It lets you pick
            from a list of taglines to use, and you can change the
            signature file by entering its filename. This is found in
            the SimTel/msdos/offline directory as SMX330.ZIP. The error
            checking for finding files it uses is poor, but other than
            that it works good. Make sure you indicate the correct
            location of the signature file. I don't recommend you use
            the same signature file used with NewsWerthy (NWERTHY.SIG).
            You'll want to make one that is formatted with shorter lines
            since SigMX puts the sig on the left side and a tagline on
            the right. You can copy SigMX's files into the same
            directory as NewsWerthy if you like.

            5.  WITH MULTIPLE USERS

            This feature is currently only available in the protected
            mode version.

            NewsWerthy defaults to saving its setup information in a
            configuration file named NWERTHY.CFG. To use other setups,
            start NewsWerthy like so:

               NWERTHY SETUP2.CFG

            If you only want to make a few changes, copy the default
            configuration file to the new file, then start NewsWerthy as
            shown above, and make the changes.

            To use NewsWerthy with multiple users, simply create a
            configuration file for each, and then each user starts
            NewsWerthy with the appropriate configuration file. Make
            sure that each user has a different work directory in their
            setup information.

            This feature can be used whenever you need to have a
            different setup, such as reading news from several BBS's
            where you'll need a separate work directory for each.


            You can read and navigate through a packet with the number
            pad almost exclusively. All the normal navigation keys are
            there, plus I've assigned the function of the space bar to
            the Ins key, the Del key acts like the Esc key, and the *
            key is the same as All Read.


            If you read a lot of messages, you may find this useful to
            avoid strain on your hand.

            The order of the newsgroups can be changed by pressing Shift
            and the up or down arrow key.

            If I only read a newsgroup occasionally, and don't want to
            save any messages, I'll use the "Expire All Messages"
            expiration option. When I'm done reading messages in the
            group I'll press Del to exit from it.

            If I want to save old messages, but don't read all the
            messages in the newsgroup, I'll use the "Expire Old
            Messages" expiration option. When I'm done reading messages
            in the group I'll press * to exit from it, marking all
            messages as read.

            If I want to be sure to read all messages in a newsgroup,
            but don't want to save them once read, I'll use the "Expire
            Read Messages" expiration option. When I'm done reading
            messages in the group I'll press Del to exit from it.

            If I'm reading my personal mail, I'll use the "Save Read
            Messages" expiration option. This way I'll save all messages
            sent to me. If the is a junk letter to me, I'll delete it so
            it won't be saved to a folder. If I want to save it in a
            different folder, I'll save it after reading it, so it won't
            be saved to the folder setup in the Data-basing Options

            V.   GLOSSARY

            ASCII text file - A file made up of only ASCII text
                 characters that represent numbers, letters, spaces,
                 line feeds and the like. The file name will generally
                 end with the .TXT extension (but could be anything).

            Base64 - Part of the MIME format. This is just one of many
                 formats it supports to transfer information without
                 using any 8-Bit characters.

            Bulletin Board - Also known as a BBS. A PC running a program
                 that allows other computers to connect through the
                 phone line. Once connected, a person can access
                 messages, files, games, etc. This may also be referred
                 to as the host system.


            Downloading - Copying a file from a Bulletin Board to your

            Hot key - Normally this is either a highlighted letter or
                 the first letter of a selection that will cause that
                 option to be selected (hitting the return key is not

            MIME - This stands for Multipurpose Internet Mail
            Extensions. The only support for MIME in NewsWerthy is
            attached files using Base64.

            Off-line - No connection between your PC and a Bulletin
                 Board, the opposite of on-line.

            Off-line mail reader - Allows reading of messages from a
                 Bulletin Board while not connected to the Bulletin

            On-line - Your PC connected to a Bulletin Board via your
                 modem and communications software running on your PC.

            Pathname - The drive, directory and filename of where a file
                 can be found.

            PC - Personal Computer, typically an IBM compatible or other
                 popular type.

            QWK format - An off-line mail format that is incompatible
                 with the SOUP format. This format contains CONTROL.DAT,
                 MESSAGES.DAT, *.IDX files, plus several other files.
                 NewsWerthy can't read messages in this format.

            Shareware - Try before you buy software, generally you have
                 30 days to try it out before sending your money or
                 discontinue using your copy. You are encouraged to
                 share it with friends and associates, provided that
                 copies are distributed in their complete and unmodified
                 form, and no amount is charged for the program, except
                 to cover distribution costs.

            Shell to DOS - A temporary exit to the DOS prompt to run a
                 program or a DOS command. Return to the previous
                 program by entering exit.

            Uploading - Copying a file from your PC to a Bulletin Board.


            VI.  INDEX                       Finding text in message     12
            + Msg                       11   Folders directory        7, 21
            - Msg                       11   Grey scale display          26
            Address book                13   Help                         6
            Alias                       13   Hot Key                 18, 29
            ASCII text file             28   Introduction                 2
            Attach File                 14   Keyboard usage              17
            Auto-Save Reply             15   Keys                        17
            Backup files                25   Kill                        11
            Base64                  14, 28   Mail packet
            Bot                         16     creating                   8
            Bulletin board              28     download directory     6, 20
            Colors                      24     downloading               10
            Configuration               20   Mailing lists               11
            CONTROL.DAT                 29   Mark as Read                11
            Cross-post                  14   Mark as Unread              11
            Data-basing Options     22, 28   Mark Bottom                 17
            Delete Message              15   Mark Top                    17
            Directories                      Message
              download               6, 20     attaching a file          14
              folders                7, 21     deleting                  15
              upload                 6, 20     editing                   15
              work                   7, 20     finding text in       12, 13
            Disclaimer                   5     posting                   15
            DOS shell                   29     printing                  17
            Download directory       6, 20     quote formats             21
            Downloading a file          28     read flag                 11
            Downloading mail packet     10     reading               11, 18
            Edit Message                15     replying                  13
            Editor                   7, 21     saving                    16
            Email                              searching                 12
              reading                   10     sorting                   11
              sending                   15   Message Header
            Entering an email message   15     Bcc(Blind Carbon Copy)    14
            Environment variable               Cc(Carbon Copy)           14
              TEMP                      24     Extra Header              14
              TMP                       24     Followup-To               14
            Expiration Options          22     Keywords                  14
              Expire All Messages       23     Newsgroup                 14
              Expire Killed Messages    23     Organization              14
              Expire Old Messages       23     Reply-To                  14
              Expire Read Messages      23     Subject                   14
              Save Read Messages        23     Summary                   14
            F1 key                       6     To                        13
            Features                     2   Message reading style       22
            File extensions                  Message threading style     22
              .BKM                      25   MESSAGES.DAT                29
              .DAT                      25   MIME                        29
              .IDX                      25   Mode command                26
              .MSG                      24   Mouse                       19
              .PL                       25     right button              20
              .REP                      24
                                         30  Multiple users              27

            New Packet                  10   Shareware                   29
            Newsgroup                        Shell to DOS                29
              catchup                   17   Signature file              15
              listing                   17   Smart searching             12
              subscribing               17   Sort Messages               11
              unsubscribing             17   SOUP script                  8
            NWERTHY.KEY                 25   System Requirements          4
            Offline                     29   Tabs                        22
            Offline mail reader         29   Taglines                    27
            Online                      29   Technical support            4
            Packet mode              2, 23   TEMP                        24
            Pathname                    29   TMP                         24
            Pc                          29   Top                         16
            PGP                         26   Upload directory         6, 20
            Pick list               19, 25   Uploading a file            29
            Posting to newsgroup        15   Uploading a reply packet    10
            Print message               17   Uqwk                         8
            Printer                          Uqwk commands               17
              eject page                24   UUEncoding                  14
              lines per page            23   View File (F5)              24
              top margin                23   Word star control keys      18
            Printing the manual          7   Word Wrap                   22
            Printing the registration        Work directory           7, 20
                form                     5   XXEncoding                  14
            Quote formats               21
            QWK format                  29
            Read News (F4)              11
            Read Stored (F6)            15
            Reading a message           18
            Reading messages            11
              errors                    12
            Reading style               22
            Registering NewsWerthy       4
              reviewing                 15
            Reply packet
              creating                  24
              upload directory       6, 20
              uploading                 10
            Reply to message            13
            Restore Indexes             12
            Review Replies (F8)         15
            RFC1036                     13
            ROT-13                      12
            Save Attached File          16
            Save message                16
            Save to Text File           16
            Search for text in messages
            Send Mail (F7)              15
            Set-up                       6
              multiple                  27