Probe House Software presents

                  R E J O I N D E R   v 1.0
                     QWK Offline Reader
  
                    William Wong, Mar 1995
                     Probe House Software

    * Introduction.
    * Installation.
    * The Main Menu bar.
    * The Editor Menu bar & Editor Keys.
    * The BBS Window.
    * The Conference Window.
    * The My Mail Window.
    * The Reply Mail Window.
    * The HitList Window.
    * The Mail Window.
    * The Bulletin Window.
    * News and Newfiles Window.
    * General Shortcut Keys.
    * Cross quote replies.
    * The Quote Header Line file.
    * The Tagline file.
    * The Signature file.
    * Configurating Rejoinder.
    * Editing a Text File.
    * New Development
    * Development, History, acknowledgement, address.

  Rejoiner is freeware - you can freely use and distribute it. If you
  like it, please let me know as it is a booster for software developer.
  Donations and gifts are always welcome.


Intro to Rejoinder
==================
The Rejoinder is a QWK reader for the Atari ST range of computers. 

* Full function - not crippleware.
* Full GEM - menus, windows, dialog boxes, toolbars and more.
* Hot keys on all major menu items.
* Fast window redraws.
* View up to 5 different mails at any one time.   [see note below ]
* Reply up to 5 different mails at any one time.  [see note below ]
* Builtin windowed editor with many advanced features.
* Configurable tab size and word wrap position.
* Size of file being edited up to the limit of your computer RAM.
* Cross quote capability - quote from several different emails.
* Quoting can include mail author initials at beginning.
* Configurable quoting character.
* Able to re-edit your already replied mail.
* Change your reply mail header anytime.
* Display all mails to you in a single window.
* Display of all your replies in a single window.
* Display mails of interest you you in the HitList window.
* Replies will automatically enter your name in the From field, 
  with the To and Subject field automatically filled in.
* Private mail reply feature.
* Customerise to your favorite archiver.
* Advanced filter function - display only mails you want to view.
* Twit Filter to filter off mails you don't want to read.
* Display NEWS, BULLETIN and NEWFILES files in separate windows.
* Randomly selected tagline.
* Option to turn off tagline if desired.
* Automatic append of signature file to replies.
* Option to turn off signature file append if desired.
* Replies can have quote header line added.
* Option to turn off quote header line.
* Auto insertion of To , From  Date & Time into quote header lines.
* Integrated quote header line, tagline, signature file, Hitlist 
  and Twit list edition.
* SpeedoGDOS supported.
* External editor spawning capability.
* Don't need QWK index files, save on your download time.
* Online and context help with ST Guide.

Note: The amount of windows opened is dependant on your system.
      There are enhancement available that increase the number
      of windows you can open at any one time.


Installation
============
Rejoinder can be installed on any directory/drives on your system.
Just move the following into any directory and double clik on
RJD10.PRG it to start it.
1/ RJD10.PRG       -- the program
2/ REJOINDR.RSC    -- the resource file
3/ REJOINDR.TAG    -- the tagfile (optional)
4/ REJOINDR.HDR    -- the header line file (optional)
5/ REJOINDR.SIG    -- the signature file (optional)
6/ REJOINDR.HIT    -- the hitlist file (optional)
7/ REJOINDR.TWI    -- the twit list file (optional)

Move the following into your ST-Guide Hypertext directory
1/ REJOINDR.HYP   -- the hypertext help file.

Running Rejoinder for the first, you will be prompted to 
configure your directory path for QWK/Reply/Editor and
your archiver used for QWK.

If Rejoinder cannot find the REJOINDR.DAT or it is corrupted,
you will need to reconfigure the two items above again.

Note that rejoinder will create a working directory to unarchive
the QWK package into. You will need disk space on your system to
enble this to happen.


Main Menu Bar
=============
Below are a list of menu items and what they do. Keyboard shortcuts
where available are indicated on the menu itself. Note that all short
cuts usr the Alternate key.

The FILE menu item
    Open QWK   : Allows you to open a new QWK package.
    Close QWK  : Close the current QWK package so that you can
                 open a new package.
    Pack Reply : Pack your replies into QWK format.
    Quit       : Quit to desktop.

The VIEW menu item
    BBS Window : Open the BBS Window. This list out all the available
                 conference in the BBS.
    My Mails   : Opens the My Mail Window
    My Replies : Opens the Reply Mail Window.
    HitList    : Opens the hitlist Window.
    Bulletin   : Opens a new window with a list of available bulletins.
    News       : Opens a new window with the BBS news.
    Newfiles   : Opens a new window to display the newfiles file.
    Welcome    : Opens a new window to display the BBS welcome file.
    Goodbye    : Opens a new window to display the BBS logoff file.

The OPTIONS menu item
    Edit files    : Enable you edit the Tagline, Signature, Quute 
                    Header Line, HitList, Twit list and any text files.
    System Info   : Shows you your systems information.
    Compression   : Configure the archiver used.
    File Location : Configure the directories of QWK.
    Desktop       : Configure the look and feel of Rejoinder.
    General       : Configure editor, quotes and others. General Options.
    Conf w/ Mail  : This toggles the BBS window to display between
                    conferences that have mail and all conferences.
    Kill Twit     : Enable/disable the Twit Filter function.

The Help menu item
    Contents  : Call ST Guide with the content.
    main menu : Call ST Guide with the main menu help.
    

Editor Menu Bar
===============
To activate an menu item, move the mouse over the menu title and click
the left button. The dropdown menu will appear.

Keyboard shortcuts are listed in the Editor Keys section.
Mouse usage for blocks selection and cursor movements are in the
Editor Block Selection area.

The FILE menu item
    Post it! : Put in the into your reply list.
    Import   : Import a text file into the edit buffer.
    Save     : Writes the edit buffer to disk.
    Abort    : Close window & throw away your edits.

The Edit menu item
    Paste Quote : Paste from the Quote buffer. See Mail Tool for 
                  more info.
    Cut         : Move the block into the copy buffer.
    Copy        : Copy the block into the copy buffer.
    Paste       : Insert from copy buffer into the line below the
                  cursor.
    Edit Header : Edit the email header of the current email.

The Search menu item
    Find          : Locate the string in the edit buffer.
    Find Again    : Locate the next occurance.
    Replace       : Replace a string.
    Replace Again :Replace again.


Editor Keys
===========
The following is a list of keyboard commands for the editor.

The editor menu are descriptions are in the Editor Menu area.
Mouse usage for blocks selection and cursor movements are in the
Editor Block Selection area.

Movement commands:
    Up arrow              up one line
    Down arrow            down one line
    Left arrow            move one character left
    Right arrow           move one character right
    Ctrl Right arrow      next word
    Ctrl Left arrow       previous word
    Shift Up arrow        page up
    Shift Down arrow      page down
    Shift Left arrow      first character on line
    Shift Right arrow     last character on the line
    Home                  jump to start of file
    Shift Home            jump to end of file

Delete commands:
    Ctrl-T               delete word
    Ctrl-Y               delete line
    Backspace            delete previous character
    Shift Backspace      delete to start of line
    Delete               delete next character
    Shift delete         delete to end of line

Filing commands:
    Ctrl-M               save & mail the email
    Ctrl-I               Import a text file into edit buffer
    Ctrl-S               Writes the edit buffer to disk
    Ctrl-U               Close window & throw away your edits.

Block commands:    
    Ctrl-B               Paste from the Quote buffer. See Mail Tool 
                         for more info.
    Ctrl-X               Move the block into the copy buffer.
    Ctrl-C               Copy the block into the copy buffer.
    Ctrl-V               Insert from copy buffer into the line below 
                         the cursor.
Search commands:
    Ctrl-F               Locate the string in the edit buffer.
    Ctrl-G               Locate the next occurance.
    Ctrl-R               Replace a string.
    Ctrl-L               Replace again.

Other commands:
    ESC                  Expand/Restore window to full
    F9                   format paragarph
    Help                 Brings out the online help


Block selection in the Editor
=============================

Selecting a line
----------------
To select a line, just hold down the left mouse button for a 
second, until the mouse changes to a pointing hand. Now move
the mouse down a bit and the line will be selected.
Once selected you can use any of the block commands to manipulate
the line.

Selecting a block
-----------------
To select a block, just hold down the left mouse button for 
a second, until the mouse changes to a pointing hand. Once
the pointing hand is displayed, you can drag to block the 
lines of interest. Letting off the mouse button will complete
the blocking process. You can now use any of the block commands
to manipulate the block.

Moving the text cursor with a mouse
-----------------------------------
Just click on the text position you want the mouse to be at.


The BBS Window
==============
The BBS window displays all the conferences available on the BBS.

Selecting a conference
----------------------
To select a conference either double click on the line of the 
conference or move the hilite bar to the conference and press RETURN.

To see conferences with mail only
---------------------------------
To see a list on conferences with mail in them, select the Show Mail
menu item or type ALT-S.


The Hitlist Window
==================
This window displays all the mails that are of interest to you.
Whenever, such name or subject occurs in the To, From or Subject
of the mail header, it will be displayed in the Hitlist window.

To configure the hit list -
 1/ Select the menu item Edit Files, Hitlist File.
 2/ Enter in the keywords you want to response to.
 3/ Save the file  ( Ctrl-S ).
 4/ Close and reopen the hitlist windows to get a new display.

Icon functions - please see the My Mail Window.


The Conference Window
=====================
The conference window display all the available mail in the conference.

Viewing a mail
To view a mail, double click on the mail you want to view
     or
Move the the hilite bar over to the mail and press RETURN.

Entering a mail into the conference
-----------------------------------
Click on this icon to enter a mail into the conference 
or type Ctrl-E.
You will need to fill in a mail header dialog in before
editing the mail body.
if you want to use an external editor, select the external
editor radio button.

Filtering the mail
------------------
Click on this icon to Filter your mail or type Ctrl-F.
The filter allows you to filter off any unwanted mail from
being displayed. This enable you to quickly search for mails
to/from a particular person or of certain subject.

Sorting the list
----------------
Click on this icon to sort your mail or type Ctrl-S.
Select the field to sort you mail with.


Filtering your mail
===================
The filter dialog allows you to display any mail that matches your
filter. 

To select a field
-----------------
To select a field to filter, click on the tick box.
Untick the box to disable filtering of that field.

String to filter
----------------
Enter the string to filter in the space provide. The mail will be
displayed if this string occur in the field. You only need to enter
part of the string that is unique. Note that all fields are in
upper case. 


Twit Filter
===========
The Twit list filterin
----------------------
The twit list is a list of names or subjects that you don't 
want to see or read. Whenever, such name or subject occurs in
the To, From or Subject of the mail header, it will not be
displayed.

To configure the twit filtering, all you need to do is to enter 
a list of names or subjects ( aka keywords) that will be removed
from the display. To do this -
 1/ Select the menu item Edit Files, Twit File.
 2/ Enter in the keywords you want to filter off.
 3/ Save the file  ( Ctrl-S ).
 4/ Enable the Twit function under menu item Options.
 5/ Close and reopen your conference windows to get a new display.

That's it!


My Mail Window
==============
This window display all the mail send to you in all conferences.
You cannot enter a mail into this window.

Viewing a mail
--------------
To view a mail, double click on the mail you want to view
     or
Move the the hilite bar over to the mail and press RETURN.

Filtering the mail
------------------
      Click on this icon to Filter your mail or type Ctrl-F.
      The filter allows you to filter off any unwanted mail from
      being displayed. This enable you to quickly search for mails
      to/from a particular person or of certain subject.

Sorting the list
----------------
      Click on this icon to sort your mail or type Ctrl-S.
      Select the field to sort you mail with.


The Reply Mail Window
=====================
This window display all your replies mail. 

Editing a reply
---------------
To edit a reply, double click on the mail you want to edit
     or
Move the the hilite bar over to the reply and press RETURN.

Deleting a reply mail
---------------------
      To delete a mail from the reply list, hilite the nail and
      click this icon or type Ctrl-X.
      Warning: Deleted reply mail cannot be recovered.

Filtering the replies
---------------------
      Click on this icon to Filter your mail or type Ctrl-F.
      The filter allows you to filter off any unwanted mail from
      being displayed. This enable you to quickly search for mails
      to/from a particular person or of certain subject.

Sorting the replies
-------------------
      Click on this icon to sort your mail or type Ctrl-S.
      Select the field to sort you mail with.
      

Quote buffer
============
Hilited blocks from mails are copied here to be later pasted in a 
reply. See Mail Tool and Editor Menu on usage.

To cross quote from different mails -
1/ Open the mail you want to quote from.
2/ Select the lines from that mail.
3/ Click the copy icon or type Ctrl-C to copy to the quote buffer.
4/ Go back to the editor window.
5/ Select from the editor menu 'paste quote' or type Ctrl-B.

Note- you can only do this with the internal editor.


The Mail Window
===============
The mail window displays the body of the mail.

To reply current mail
---------------------
      Click on this icon or type Ctrl-R
      You will need to fill in a mail header dialog in before
      editing the mail body.
      If you want to use an external editor, select the external
      editor radio button.

To copy a block to the quote buffer
-----------------------------------
      Select the block you want to copy to the quote buffer.
      To copy to the Quote buffer, click on this icon or type Ctrl-C.

To export the mail into a text file
-----------------------------------
      To export the mail in the window, click on this icon or type
      Ctrl-E. You will be prompted for the filename.
      
To move to the next or previous mail
------------------------------------
To move to the next or previous mail, click on the arrow buttons or
type Ctrl Right arrow for next mail and Ctrl Left arrow for
previous mail.


The Bulletin Window
===================
A list of available bulletin are displayed.
just click on the bulletin you wanr to view.

The news window
===============
This window displays the news of the BBS.

The newfiles window
===================
This window displays the newfiles of the BBS.


Quote header lines file
=======================
The quote header line are obtained from the REJOINDR.HDR file. You 
can edit this file by selecting from the Option menu, Edit files, 
Quote Header.

A quote header is a single line of text from the header file. It is
the first line of text when you reply to a mail. The quote header 
line is randomly selected if there are several of them.

See General Options for procedure to turn off this feature.

Occurances of following the token in the line will
   $to  will be replace by the mail author name
   $fr  will be replace by your name (usually)
   $dt  will be replace by the mail sending date
   $tm  will be replace by the mail sending time


Taglines file
=============
The tagline is obtained from the REJOINDR.TAG file. You can edit
this file by selecting from the Option menu, Edit files, tagline.

A tagline is a single line of text that is appended to the end of 
your reply. The tagline is randomly selected each time if there are
several of them.

See General Options for procedure to turn off this feature.


The signature file 
==================
The signature are obtained from the REJOINDR.SIG file. You can edit
this file by selecting from the Option menu, Edit files, signature.

The signature file appended to the end of before the tagline. This 
signature can contain your email address and other information you
want to always append in your reply.

See General Options for procedure to turn off this feature.


The Hitlist file 
================
This is a list of keywords that you are interested in. When ever
these keywords occurs in the mail header, the mail will end up in
the HitList window. See the HitList Window.


The Twit file 
=============
This is a list of keywords that you are not interested in. When ever
these keywords occurs in the mail header, the mail they will not be
displayed in any window. See the Twit Filter.


Text File
=========
You can edit any text file via the Options, Edit files, Text files
main menu item.

When you edit a text file, the same internal editor with same
Editor Menu and Editor Keys as when you reply a mail is used.
The only difference is that you will not be able to post the
text file nor edit the mail header (it don't have any).

To save the text file, select Save from the menu or type Ctrl-S.
To quit the window, select About from the menu or type Ctrl-U.


Shortcut Keys
=============
The following shortcut keys are available on all windows.
  Close a window               Ctrl-U
  Maximise/restore a window    Esc
  Iconise a window             Ctrl-Esc
  Cycle windows                Ctrl-Tab
  
  line Movement                Cursor keys
  Page Maovement               Shift cursor keys


Configurating
=============
The following are Rejoinder configurables :
   The archiver Compression type and archiver command.
   The QWK Directory, REPLY directory and the external editor.
   The Rejoinder Desktop look and Feel.
   The General Options for tagline, signature, header line, quote
       control and some editor variables.


Compression configuration
=========================
Rejoinder will need to know where the archiver and the command to
unarchive and archive the QWK package.

Selecting an Archiver
---------------------
Click on the archiver field and select via the file selector

Entering archiver commands
--------------------------
Enter the extract and move command line commands for the archiver
selected.


QWK Directory
=============
Rejoinder will need to know where the QWK package, Reply packet
and external editor.

The QWK directory is the location where all the QWK package are
store. The Reply directory is where you want the reply package
to be stored.

If you want to use an external editor, you need to configure
the full pathname of the editor.

Selecting the pathnmes
----------------------
Click on the field name and select via the file selector.


Desktop Look & Feel
===================
Select the colour and texture of the dialog boxes and 
background. The SpeedoGDOS font type and font size can 
also be selected here.

Select Apply to set the settings. Close to close the dialog.


General Options
================
The general options allows configurating of various component of 
the mail and the internal editor. Note that you must press the 
APPLY button to make the changes effective.

Mail
----
You can control the attachment of quote header line, tagline and 
signature file in your mail body. 
A tick in the tick box means the attachment is enabled. To unable
it, just untick the tick box.

Mail quotes
-----------
This controls the inclusion of the initials of the author in the
quote lines. To disable the inclusion, untick the tick box.
The quote character ype can also be changed here.

Editor control
--------------
The tab size can be changed to any value between 1 and 20. Tabs are
converted to pure spaces in the QWK format. 
The word wrap position can be
changed to any value between 1 to 99. Setting to 1 will probably
bomb the editor and is not advisable. Words are wrapped at spaces.


New development
===============
So, what can you expect from the next release ?
 o UUencode and UUdecode.      *
 o ROT13 support.
 o BlueWave support.
 o Talking email.              *
 o ANSI viewer.                *
 o Editor drag blocking.
 o Fidonet/Usenet support.
 o Builtin ZIP/LHARC/ZOO.
 o Internet SOUP support       *
 o Any other ideas.
 
 So if you have any ideas, let me know.
 
 * = source code already in hand. Just need to 'code it in'.


Development
===========
This program was developed on a 4Mb Tos 2.05 Mega STE with 170Mb HDD.
Currently I am using a TV, my monitor is back home. I am not shipping
my monitor for this. So if the screen looks funny, please feedback to
me.

The Hypertext source was created by using the Rejoinder builtin editor.

Software tools and package use:
  Program  : Pure C, Pure Debugger and GUI provided by BIG 1.88.
  Hypertext: Rejoinder (editor), ST-Guide and HCP

History
Ver 0.9:  Limited release in Singapore.
Ver 1.0:  Released to the public as freeware.

Feedback
  Please send feedback of any types to:
    Internet : wongck@ti.com

    Mail : William Wong
           990 Bendemeer Road,
           CC 5129,
           Singapore 1233,
           Republic of Singapore.

Acknowledgement
Borland Germany for the excellent Pure C and Pure debugger.
Claude Attard   for the cool BIG libraries.
Holger Weets    for the great ST-Guide and HCP software.
My students     for the interpretation.

