###################
PDQUOTE version 1.0
###################

March 18, 2001
by Paul Dobbs, pdobbs@home.com
http://members.home.net/pdobbs
Telnet into PDBBS from my home page.

######################################################################
DISCLAIMER
######################################################################

 This thing is guaranteed to do nothing but take up space on
your hard drive. I'm not liable for screw-ups it may or may not cause.

######################################################################
WHAT IS IT?
######################################################################

 PDQuote is a baja module that is intended to be run from within your
command shells automatically, producing a witty, 1-line quote for your
users to enjoy. It comes with over 1400 quotes to begin with, and you
edit them, or add more! And its FAST! NO slowdown from it at all!

######################################################################
WHERE DID IT COME FROM?
######################################################################

 I use to run a system called Paranormal Discussions BBS from Oct. 11, 1993
to July 1999 (using Remote Access). On it I had run a few home-made programs,
one of which was this nice randomized quoter. I felt it was an excellent
starting point for familiarizing myself with BAJA for, my eventual return
to running PDBBS (which I hope will be before the end of March 2001).

 So, use it, enjoy it. Its free. Please feel free to email me and say hi.

######################################################################
HOW TO USE IT
######################################################################

[1] Place PDQUOTE.SRC in your SBBS \EXEC directory.
[2] Edit this one line in PDQUOTE.SRC 
    set QuotesFile "c:\\pdbbs\\exec\\pdquotes.dat"
    Change the drive and path to suit your system configuration. 
    Note, the two slashes ARE necessary, so don't lose one.
[3] Edit the command shell(s) you want this in, and place it where you want it
that shell. My method is to put it in ONE spot only - above the Main Menu
display prompt. In ANY command shell, you can pretty much search for the string:

# Display main Prompt

That'll get you to near the spot where the PRINT command is for your Main Menu
prompt, and then all you need to add to your command shell is this line:

EXEC_BIN "PDQUOTE"

So in the Renegade.src shell, you might have this

------------------------------snippet------------------------------
# Display main Prompt
EXEC_BIN "PDQUOTE"
compare_ars exempt T
if_true
	print "n\r\nbhTime Used: [c@TUSED@b]  "
else
	print "n\r\nbhTime Left: [c@TLEFT@b]  "
	end_if

print "bh(c?b=cHelpb)\r\nMain Menu m: n"
--------------------------------------------------------------------

This would display as:

(Your Main.asc menu)
A blank line
A randomly selected quote from PDQUOTES.DAT file
A blank line
Time Used: (or Time Left depending on time exemption flag)
(?=Help) Main Menu:

 Yes, keep the double quotes around the word PDQUOTE too. 

[4] Compile the PDQUOTE.SRC with baja.exe
    (In the \EXEC directory, type exactly 
     BAJA PDQUOTE
[5] Compile each of the command shells you added PDQUOTE to.

NOTE! If you do as I do by adding the quote after a menu, you need to keep your
menu to 20 or 21 lines maximum for screen length to get the quote to come up 
without causing a HIT RETURN prompt to pop in there before your Main Menu 
prompt (very annoying).


######################################################################
OTHER GOODIES???
######################################################################

Extra Goodies ? Oh yes.. yes indeed my friend. The pdquotes.dat is a plain
text file! That means, you can edit it to your hearts content. How? Easy..

-EDIT
 Open the file itself and just edit the line. ONE quote PER line. If you make
the quote longer than 80 charactors, it'll wrap on-screen.
-ADD
 Open the file, add your quote after the last line (it won't make it turn up
more often if you place it up top or anywhere else, its a random number
function that chooses a line number in the file to read). After you add your
line, edit the FIRST line. See that number? Thats the TOTAL number of quotes
in the file. Just increase that total by one. Save the file. You can edit on
the fly too - the file gets re-read each time PDQUOTE is called.

 So what you say? What else is cool? Well, you can add SBBS codes that display
system and user data.. so for example, you could add a line like this:

@BBS@ rocks, thats why you're here isn't it? :-)

Would translate into
YourBBSName rocks, thats why you're here isn't it? :-)

######################################################################
QUESTIONS?
######################################################################

 You have other questions? Don't be silly. Its too easy for that. Use, enjoy,
its free. I hope the free approach encourages others to also release free mods
for SBBS. This is my 1st. Feel free to email me and say hello, pdobbs@home.com

######################################################################
HISTORY
######################################################################

 This is the first verion dude!
 This is my first released Baja mod dude!
 There may well be more dude!
 Ok, so I need to stop using the word DUDE, dude..
