@DataBase DMThor.guide
@$VER 1.53 (11MAY97)

DMThor v1.53 by Troy Emerson Bouchard

@Node Main "DMThor v1.53 by Troy Emerson Bouchard"

			      @{b} -= DMThor =-@{ub}
			 The Digest Creator for Thor
			    -= Release 1.53 =-
			     -= John 3:16 =-

@{b}General information@{ub}
     @{" About           " Link "About"}
     @{" Disclaimers     " Link "Disclaimers"}
     @{" How to register " Link "Register"}
     @{" Distribution    " Link "Distribution"}
     @{" Special Thanks  " Link "Thanks"}
     @{" History         " Link "History"}

@{b}Installation and usage@{ub}
     @{" Installation    " Link "Installation"} And Requirements

@EndNode

@Node About "DMThor About"
@{b}@{u}DMThor About@{ub}@{uu}
This program will read in a conference name and copy all
messages in that conference to a text file in a digest format.

Post them to your web site or to/on a listserver.

This program can be used to store all your message traffic outside
the Thor database and in an ASCII file.  You can then later
(if you want to) parse it back into the Thor database with
Sort Mail (I hope).

I haven't tried to parse the digest back into the Thor database
so if someone does - then please report the results back to me.

That would be just peachy!

I can be reached at either of the following ways for any questions
comments/bug reports etc...

   @{i}Internet: @{ui}

     EMail: tbouchar@ptialaska.net
       WWW: http://www.ptialaska.net/~tbouchar
      News: alt.sys.amiga.thor @{b}Not Recommended!! @{ub}
 Mail List: thor-dev@thule.no

   @{i}Snail-Mail: @{ui}

   @{b}Send comments to:@{ub}

     Snowy Hill Solutions
     ATTN: Troy E. Bouchard
     811 Thorsheim St.
     Kodiak, AK 99615

@EndNode
@Node Disclaimers "DMThor Disclaimer"
@{b}@{u}DMThor Disclaimer@{ub}@{uu}

I have made every effort possible to make sure that DMThor will operate
as programmed, however, no warranty of any kind, expressed or implied,
is made by me.	I will not be liable for any kind of damages direct or
indirect to your computer.  In no event will I be liable for any damage,
loss of profits or savings resulting in the use of this program (script).
@EndNode

@Node Register "DMThor Registration"
@{u}@{b}DMThor Registration@{uu}@{ub}

DMThor is Shareware, I would like you to at least send me an EMail
saying you are using it.  If you do use it on a regular basis please tell
me so.	I would like to say that after 30 days of regular use you MUST
register it - but I see that all the time and I don't like it - so I won't.

When you have EMailed me - telling me you are using it - you will be put
on a "list" (if you want) of 'unlimited' free updates to the script.  You
will also get free support, and a clear conscience.

If you want to use this script in a business environment then please
send me an EMail and we can work out a 'Deal'.
@EndNode

@Node Installation "DMThor Install Guide"
@{u}@{b}DMThor Installation@{uu}@{ub}

Installation is easy and painless!  Just copy DMThor.thor to
your [VOLUME]:Thor/rexx directory and run it!

When you run DMThor a ListView will pop up asking you to choose a
System. Go ahead and choose your favorite system!  Another ListView
will pop up asking you to choose a Conference.	Choose one!.  Once you've
chosen your conference DMThor will create a file in the T: directory
called CONFNAME.DD_MMM_YYYY (e.g. EMail.digest, Miami-L.25_APR_1997 etc.)

@{b}NOTE:@{ub} If you have a long conference name, DMThor (THOR) will
	  Save the message truncated. e.g. REALYLONGFILENAMEONMYAMIGA
	  will become REALYLONGFILE

That's all there is to it!  DMThor will read the conference and you will
see a progress bar adding messages to your file!

There will be two progress bars - one for adding the topics and one
for adding the messages - so don't freak out when you see that happen!

@{b}New@{ub}
DMThor now has a delete messages requester.  If you want to delete
all the messages from the conference you just made a digest of - then
select OK - otherwise choose NO.
@EndNode

@Node Thanks "Acknowledgements"
@{b}@{u}DMThor Would Like to Thank:@{ub}@{uu}

    The Thor team for developing the Amiga's best news and mail
    software for @{b}@{u}ANY@{ub}@{uu} computer platform.

    Remco van Hooff - who helped me get rid of that annoying
    Message is deleted error and just some general scripting
    techniques!

    Bill Hawes for developing ARexx

    Matthew Dillon for creating DME.  THE editor for programmers
    and programming.
@EndNode

@Node Distribution "Distribution"
@{b}@{u}DMThor Distribution@{ub}@{uu}

DMThor.thor is freely distributable, but remains © Troy E. Bouchard.

It may not be included in any commercial distribution without prior
consent. Such consent is already given to include in on the Aminet CDs.

It may be included on magazine cover disks or CDs, notification must be
sent beforehand. A copy of the magazine and disk will be extremly
gratifying.
@EndNode

@Node History "DMThor History"
@{b}@{u}DMThor History@{ub}@{uu}

@{b}   History:  v1.0 - First release! - (07.27.96)@{ub}

@{b}	     v1.1 - First Update!  - (07.29.96)@{ub}
		    Added a Progress Bar
		    Updated the final REQUESTNOTIFY.

@{b}	     v1.2 - Second Update! - (07.30.96)@{ub}
		    Changed the WRITEBRMESSAGE to SAVEMESSAGE
			 (The digest looks better now)

	     @{b}NOTE:@{ub}  If you have a deleted message in the conference
		    SAVEMESSAGE will quit!  I don't know of a way
		    around this (yet) - any ideas?

@{b}	     v1.3 - Third Update! - (08.03.96)@{ub}
		    Fixed the problem with Conferences that have
		    spaces in their names.  A special thanks to
		    Remco van Hooff <rvhooff@GlobalXS.nl> for this fix!

	     @{b}NOTE:@{ub}  Remco also showed me where to go to fix the error
		    that will occur if you have a deleted message in
		    your conference.  I'll get that fixed soon.
		    Right now - I don't feel well.

@{b}	     v1.4 - Fourth Update! (08.07.96)@{ub}
		    Fixed the deleted message problem.	I would say
		    that this is temporary because usually when you
		    delete a message it's because that message is a
		    duplicate and this routine just puts that message
		    back in.  But not back in your conference - just
		    the digest.

@{b}	    v1.41 - Fourth update! +1 (08.12.96)@{ub}
		    This REALLY fixed the deleted message problem.  It
		    also fixed the MDF_UNRECOVERABLE error.  Thanks go
		    out (again) to Remco van Hooff - who helped me
		    figure this out.

@{b}	    v1.45 - Fourth update! +5 (09.30.96)@{ub}
		    Fixed the progress bar.  Was showing 100% all the
		    time.  Now counts the actual messages and not the
		    deleted ones also.	Added error checking.

@{b}	    v1.50 - Fith update! (12.02.96)@{ub}
		    Major re-write!  The script now reflects a true
		    digest!  No one told me I was doing things wrong.

		    There is now a 'TOC' and then the messages.

@{b}	    v1.52 - Fith update +2! (24APR97)@{ub}
		    Added a delete messages function.
		    Also changed the suffix to reflect the current date
		    so you won't have to guess when you created the
		    digest.

@{b}	    v1.53 - Fith update +3! (11MAY97)@{ub}
		    Cleaned up a few mistakes that Chryse pointed
		    out.  Thanks Chryse!  Amazing what you forget
		    when you are in a hurry to grind something out.

		    Fixed a problem with the delete progress bar
		    not actually following the amount of deleted
		    messages.

		    Fixed a lame bug ... left a line out that
		    caused the system to keep running even though
		    you told it to stop.
@EndNode
