Metropoli BBS
VIEWER: fl-chat.dox MODE: TEXT (CP437)

                     Subject : FUEL'S -!CRUEL CHATTER!-

┌─────────────────────────────────────────────────────────────────────────────┐
│ PROVIDER : FUEL - For Unlimited Electronic Loudness                         │
│                                                                             │
│ NAME     : CRUEL Chatter - Chatting Rulez, Until Everyone Leaves            │
│                                                                             │
│ CODER    : BRAINBREAKER - PREZ of FUEL                                      │
└─────────────────────────────────────────────────────────────────────────────┘


                Introduction.............. 1
                Installation.............. 2
                   - Why/Brief overview......[A]
                   - The installation........[B]
                Features...................3
                   - Capture your chat.......[A]
                   - Multi Chat-Screen.......[B]
                   - Use of macro's..........[C]
                   - Edit user stats.........[D]
                   - View system file........[E]
                   - View help...............[F]
                   - Beep user/sysop.........[G]
                   - Clear screen............[H]
                Disclaimer stuff <G>.......4
                Files......................5
                   - Used by the PPE.........[A]
                   - Included in ZIP.........[B]
                   - Configuration file      [C]
                   - File_Id.Diz.............[D]
                Greeeeetzz.................6
                More..more, more...........7


───────────────────────────────────────────────────────────────────────────────

Introduction                                                            -1-
------------

Well, normally I'm not really that set on making stupid DOX.  But I guess this
one requires some explanation {Darn Darn, bad luck for me}.


───────────────────────────────────────────────────────────────────────────────

Installation                                                            -2-
------------
a) Why to install this Cruel-Chatter !
--------------------------------------

First let's get you rollin' !  Let's install this PPE huh !
What do you mean - "Why should I install it!".

That's fairly simple you know :

            Because this chatter has got more features then the most chatters
            for PCBoard

     E.G. - Capture your chat  : * Good looking, readable Capture File
                                 * User can download his personal Capture File
                                   {If the sysop allows him to!}
                                 * Both the user and the sysop can TOGGLE their
                                   own Capture ON/OFF
          - Multi chat screens : * Jump from one screen to another
                                 * One default screen in which your boardname
                                   can be written in a COOL font !
                                 * A billion other for you to make ;-)
                                   {5 others are included}
          - Use of macro's     : * 5O Macro's for you to use
                                 * Use colors as much as you want, it won't
                                   mess up!
                                 * Toggle macro use ON/OFF inside the chatter
                                 * Add macro's INSIDE! the chatter
          - Edit user stats    : * Look at or change ANY users info
          - View system file   : * You can view ANY file you want
                                   {Includes: Any text file, Ansi codes,
                                    PCBoard @Codes}
                                 * Choose between Non-Stop Display or Line-
                                   Counting Display
          - View help          : * Both user and sysop can view a help file
                                 * The guy that's NOT viewing the help file
                                   will have to look at some cool sentences
          - Clear screen       : * Woow !! ;-)

Kay!  I guess I have convinced you huh!
What do you mean "NO!"!!  Get lost dude..


b) Installation !
------------------

So for all you guys who are still reading this part ;-) let's install the PPE..

First and for all, I hope you Unzipped this using the -D (Create Directory)
option.  Make sure that all files named SCREEN*.* are located in the subdir.
"DATA\" !!

There are two ways off going about it:

  1:      - Edit your PCBTEXT file
          - Press F3
          - Type 333 and press enter
          - Now change that line to something like this:
                  !DRIVE:\PCBDIR\PPLDIR\FL-CHAT.PPE
                   └┬───┘ └─┬──┘ └──┬─┘ └────┬────┘
                    │   ┌───┘    ┌──┘        │
                    │   │   ┌────┴───┐       │
              E.G. !C:\PCB\PPL\FL-CHAT\FL-CHAT.PPE
          - Press escape
          - Installed !

  2:      - Run PCBSETUP.EXE
          - Press G
          - Press H
          - Now change one of these lines to something like explained earlier.
          - Exit PCBSETUP {Don't forget to save when exiting}
          - Installed !


───────────────────────────────────────────────────────────────────────────────

Features included                                                       -3-
-----------------

Let's talk a bit about the stuff you can do with this chatter.
You already saw a brief summary on the features in this PPE, well, now I'll
try to give some kinda description about how, why, when, where and so on.

a) Capture your Chat.
---------------------

Many chatters have got a build-in capture system. {Sounds good huh ;)}
So what makes this one better then the rest...

          * While chatting you can toggle the capture on or off by pressing
            CTRL-C
          * It's readable - Like reading some stupid novel
          * You can see when the capture has been turned on or off in the
            Help-screen {CTRL-Z}
          * Not only you can capture your chat, but the user can as well

            - "The user can too ?"

Yubz, he can : It's a seperate file that has to be located somewhere in your
dowload-path, so the caller can download his capture.
Ofcourse, this can only be done if it is said so in the Config-File.  Read
more about it in the "CONFIGURATION FILE"-Section


b) Multi Chat-Screens.
----------------------

This is one of the best features included in CRUEL Chatter if you ask me.
This was the main reason I started coding this PPE - After using some chatter
for a long time, I started to get really tired and sick of that same old
stupid chat-screen.  So I started installing more then one chatter so I could
switch.  But hey, that sucked, so I started coding this CRUEL Chatter.

          * There is one main chat-screen with fixed height, width and colors.
            This chatscreen has the ability to write your Boardname, or any
            other string in a cool font.
            Take a look at the "CONFIGURATION FILE"-Section for more info.
          * You can switch from one chat-screen to another WHILE CHATTING.
            You can do this by pressing CTRL-N {next chat-screen}, or CTRL-P
            {previous chat-screen}, or by pressing CTRL-J {jump to #}.

          How to add chat-screens...

          * First draw a screen ;-) {This may be ansi- or pcb-screens}
          * Name your file SCREEN{x}.PCB where the {x} stands for a number.
            Make sure that there exists a file named SCREEN{x-1}.PCB, unless
            it is the first external chat-screen {SCREEN1.PCB}.
          * Edit the file called SCREEN{x}.DAT where the {x} has the same value
            as the SCREEN{x}.PCB File !

          FILE : SCREEN{x}.DAT

          Line 1 : X-Position of the sysops FIRST line
          Line 2 : Y-Position of the sysops FIRST line
          Line 3 : X-Position of the sysops LAST line
          Line 4 : Y-Position of the sysops LAST line
          Line 5 : X-Position of the users  FIRST line
          Line 6 : Y-Position of the users  FIRST line
          Line 7 : X-Position of the users  LAST line
          Line 8 : Y-Position of the users  LAST line
          Line 9 : Color in which the sysop has to type
          Line 10: Color in which the user  has to type

          Make sure you put the .PCB and the .DAT file in the subdirectory
          .\DATA !! Otherwise it won't work..

          That's it, you now have created a new chat-screen.......


c) Use of macro's.
-------------------

This one is kinda getting boring too, but it's a cool feature, so I quickly
intalled it...

          * While chatting you can toggle the use of macro's on or off by
            pressing CTRL-R
            "Why not CTRL-M ???" - Because that has got the value 13h and
            as you probably know, that's the enter key ;-)
          * You may add up to 50 macro's in the macro-file {MACRO.LST}
          * You may use the PCBoard's integrated color codes {@X..}
          * While chatting try pressing CTRL-A, It will give you the ability
            to add macro's while you're chatting... No more exit to dos to
            do this !

          One more thing about these macro's.  If you notice that some macro's
          are not written, then don't panic, it's not a bug.

          Here's why:  Because of the multiple chat-screens, I can't really
          know how big the macro's may be.  Therefore I simply check the width
          of the chat-screen, and if the macro is too large, it will NOT be
          printed...


d) Edit user stats.
-------------------

I have build in this User-Editor to make it easy for you to change the users'
stats.  This way you don't have to run PcbSm.Exe to do this.


          * View the users' stats by pressing CTRL-U
          * You can move from one field to another by pressing the Left-,
            Right-, Up- and Down-Key.
          * Press enter to change the highlighted field

          Just one thing, those silly Coders who have made the PPL-Compiler,
          have excluded some variables, so there are some stats which can NOT
          be changed.  These fields have a grey color when selected, the others
          have a nice green color.


e) View system file.
--------------------

          In this chatter you don't have to exit to dos for viewing some file
          outside PCBoard.  Just press CTRL-V and type in the full path and
          filename of the file you want to view.

          After this you have to choose between Non-Stop Display, or Line
          Counting Display.  I have included this because it's sometimes easier
          to view Ansi-Files in Non-Stop Mode, and text-files are always easier
          to look at line by line... Unless ofcourse you read very fast :-)

          Be aware that it does NOT support viewing .ZIP-Files !  Only text
          files, ansi's and PCBoards @-Codes.
          So viewing your autoexec.bat would cause no problems at all ;-)


f) View help.
-------------

          * Press CTRL-Z and take a look, it's all quite obvious...


g) Beeping.
-----------

Nice and easy, just try pressing CTRL-G.


h) Clear screen.
----------------

          - "Whoahahaha"

          Hey don't laugh, I actually had some work doing
          this ;-) - About 2 minutes - Time is money ya see !

          * Just press CTRL-W, You'll see


───────────────────────────────────────────────────────────────────────────────

Disclaimer.  {PFffff}                                                   -4-
---------------------

Fuck I hate this, but it has to be done I guess.  Okay, here I go -


I {Brainbreaker} do not accept any responsibilities if this PPE should in ANY
way mess up your PC {Don't worry, it won't}.  Nor anybody who is a member
of fuel can be held responsible, nope, not even their girlfriends.

If it should mess things up. {IT WON'T}  Then I can only hope you will let me
know, so that I can fix the problem {I hate the word grmbl.. 'bug'} and make
everybody happy once more ;-)
You can always reach me at THA GULF - Tel: +32-16-446317 {If I haven't moved
yet ;-)}


───────────────────────────────────────────────────────────────────────────────


Files....                                                               -5-
---------

a) Files used by the .PPE.
--------------------------

          * FL-CHAT.PPE     The PPE itself :-)
          * FL-CHAT.CFG     The Cruel-Configuration File
          * LASTANSI.DAT    File that contains the number of the last
                            chat-screen
          * MACRO.LST       File that contains Max! 50 macro's


b) Files included in the .ZIP.
------------------------------

          * FL-CHAT.DOX     This Doc-File <G>
          * LUIGI.COM       FueL-aDD
          * PHEWL.EXE       FueL NFO [ExE]
          * PHEWL.NFO       FueL NFO [TXT]
          * FL-RLSES.TXT    All FueL releases ever !
          * FL-APPLY.EXE    FueL Apply Generator   ! [Use it !!]
          * FILE_ID.DIZ     Program Info-File

c) Configuration file
---------------------

Here follows the explanation of the FL-CHAT.CFG File....

          * LiNe oNe   : NaMe oF YouR BoaRD
          * LiNe TWo   : YeS - auToMaTiC uSe oF MaCRo'S
          * LiNe THRee : YeS - auToMaTiC CaPTuRe WHeN STaRTiNG CHaTTeR
          * LiNe FouR  : LoCaTioN aND NaMe oF CaPTuRe FiLe
          * LiNe FiVe  : YeS - uSeR MaY DoWNLoaD THe CaPTuRe FiLe
          * LiNe SiX   : LoCaTioN aND NaMe oF THe uSeRS CaPTuRe FiLe
                         MaKe SuRe You eNTeR a DiReCToRY THaT iS aLSo LiSTeD iN
                         YouR DoWNLoaD.LST FiLe !!
          * LiNe SeVeN : YeS - uSeR CaN PReSS eSCaPe Too
          * LiNe eiGHT : YeS - uSeR CaN BeeP SYSoP
          * LiNe NiNe  : YeS - ReSToRe TiMe LeFT aFTeR CHaT eNDeD

d) File_Id.Diz.
---------------

          ─┼▄▄▄▄▄▄▄ ▄▄▄     ▄▄▄▄▄▄▄ ▄▄▄
        .·° ███ ▀▀▀ ███ ███ ███ ▀▀▀ ███ °·.·.
        °·. ███▀    ███ ███ ███▀▄▄▄ ███ ▄▄▄  °o
        .·° ▀▀▀     ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀┼─
        ┌─── ─── ─ CRUEL CHATTER! ── ───════╗
        │  The long awaited CRUEL CHATTER ppe ║
        │        ·  by BrainBreaker  ·        ║
        │  φ Multiple (definable) Chatscreens │
        │     Jump from one screen to another │
        │  φ Chatscreen with auto BBS-name    │
        │     Your bbs-name in a special font │
        │  φ In-chat file-viewing of text,    │
        │     ansi and pcb files in ANY dir.  │
        │  φ In-chat user editor              │
        │  φ Definable macro's, in-chat adding│
        │     of macro's, turn macro's ON/OFF │
        ║  φ Capture option: user can downl.  │
        ║     capture file after the chat     │
        ╚═══════─────── ─── ─ ────────────────┘


───────────────────────────────────────────────────────────────────────────────

GREETZzz AND STUFF.                                                     -6-
-------------------

Well, erhm, greetz go to:

THE KNiGHT   - Well, here you have it, finished, done, af, finito ;-)
VENiOR       - Thnx for those proposals doewd, hope you like it...
SUPER DROOPY - Jeeze, Exams still not finished huh!  Well, good luck anyway.
BEN HURRY    - You to ?? Exams ???? Oh yeah, same University, right ;-))
DEEP FREEZER - Seems like yar having great fun coordinating, and chatting to
               Necrofiliac ofcourse :-)
BYRON        - Yesyes, Finally you joined FUEL, can't wait for yar first release
STARWARS     - Hey, cool 3D-Glasses !! :-)
MORPHEUS     - Yeah ! THNX for the Intro, Nize coding !
PRESIDENT    - Hey man, where are ya !?
TERRY MOOD   - Another happy Crueler ;)
SLAY         - A pitty you can't use this chatter, maybe recode it ?
IRON EAGLE   - I noticed yar increasing yar phonebill again :-)


Pfff, all those greetz, let's make it a bit shorter:

Greetz to ALL FUEL-MEMBERS !!! KEEP UP THE GOOD WORK DUDES !!!

Group greets fly out to : S!P - SNL - iMG - PAiN - TLY - D.LERIA - BdP -
                          Isch Crew - Pure - NUON - PRIMUS - INOX REALM -
                          ...


───────────────────────────────────────────────────────────────────────────────

Some other shit about this Cruel-Chatter.                               -7-
-----------------------------------------

Okay, I guess congratulations are in order: You succesfully intalled the PPE !
{I think <eg>}

Well, I guess now's the best time for you to fill in your registration form !
{AAAarrghh ! Don't press escape ! IT WAS A JOKE !!}
This PPE is FREEWARE,  We don't like all that other shit that has got to be
registered ! "yuck".  So enjoy this PPE, I know I will.

Just one more thing okay, DO NOT ALTER THE PPE ITSELF, Instead, contact me
and tell me what you would like to see changed...  I will consider it, and
if the changes will be followed through in the next version, I will mention
your name in the DOC file.



                                DOC WRITTEN, COMPILED (erhm.. a DoC??)
                                    By BrainBreaker / FUEL! / 04-06-1995
                                        (c) by FUEL 1995

[ RETURN TO DIRECTORY ]