1



         PowerPPL 2.1





         (C)1995 by Francis GASTELLU
         All Rights Reserved




















































                                                                        2




         Index

         GENERAL
         I.            Installation............................ 3
         II.           What is PowerPPL........................ 4
         III.          First Time Configuration................ 5

         CREATING AN APPLICATION
         IV.           Managing Projects....................... 9
         V.            Compiling the Source File...............10
         VI.           Running the Source File.................11
         VII.          Working with $INCLUDE Files.............12

         USING POWERPPL
         VIII.         Command Line Parameters.................13
         IX.           Opening a File..........................14
         X.            Saving a File...........................15
         XI.           Changing Directory......................16
         XII.          Shelling to DOS.........................17
         XIII.         Exiting PowerPPL........................18
         XIV.          The IDE (Keys)..........................19
         XV.           The Clipboard...........................20
         XVI.          Searching/Replacing Text................21
         XVII.         Setting Compilation Arguments...........22
         XVIII.        Resizing/Moving Windows.................23
         XIX.          The Message Window......................24
         XX.           Customizing Colors......................25
         XXI.          Setting Environment Options.............26
         XXII.         Setting Tabulation Length...............27
         XXIII.        Saving/Retrieving the environment.......28
         XXIV.         Using Help..............................29
         XXV.          Performing a Zippy Text Search in Help..30
         XXVI.         The Ascii Table / The @Xnn Pick Chart...31
         XXVII.        The Calculator..........................32
         XXVIII.       The Calendar............................33
         XXIX.         Changing video mode to 50 lines.........34
         XXX.          The About box...........................35
         XXXI.         Troubleshooting.........................36

         REGISTRATION
         XXXII.        Getting Your FREE KeyFile...............37

         POWERPPL DEVELOPMENT
         XXXIII.       Becoming a Beta-Tester..................38
         XXXIV.        Suggestions/Remarks.....................39
         XXXV.         Getting New Versions....................40

         NOTES
         XXXVI.        Copyrights..............................41
         XXXVII.       Disclaimer..............................42









                                                                        3




             I. INSTALLATION
             ~~~~~~~~~~~~~~~


             File Identification


         The ojriginal PowerPPL archive filename MUST be POWPPnnn.xxx
         (nnn is the version number  and xxx is the archiver extention)

         For example, ZIP version of PowerPPL is POWPP200.ZIP

         If the archive filename does not match this chart, it is surely
         a faked/repackaged/infected version... Please, delete it.


             Installation

         Extract the  archive contents  in a  temporary  directory  (for
         example C:\TEMP). Move to this directory and type INSTALL.

         Before doing anything, the installation program will ask you if
         you agree to send a postcard to the author if you find PowerPPL
         usefull... Type YES if you agree, anything else if you don't...

         At this  point, you  will just  have to specify the destination
         Drive & path (default directory is \POWERPPL) and PowerPPL will
         be installed on your hard disk.

         It is  strongly recommanded  to add you PowerPPL path into your
         PATH environment  variable, so you will just have to type PP to
         run it.

         Warning :  The installation  program  may  have  problems  when
         trying to install PowerPPL on a network or SUBST drive...
























                                                                        4




             II. What is PowerPPL
             ~~~~~~~~~~~~~~~~~~~~


         PowerPPL is  an IDE (Integrated Development Environment) to use
         in conjunction with PPLC from Clark Development.


             What can PowerPPL do for you ?

         PowerPPL can help you to design sophisticated PPE's without the
         need of leaving the editor to compile and even RUN the PPE...

         PowerPPL can  remind you  how to use any PPL function/procedure
         just by  typing CTRL-F1  on it, or let you search for a keyword
         within the help file...

         PowerPPL  can   help  you  to  organize  your  source  code  by
         colorizing it.

         PowerPPL can  help you  to manage  your projects  and  multiple
         include files  by keeping  track of  each file  into  a  single
         project file.


             What PowerPPL can NOT do for you ?

         PowerPPL can not seek bugs for you withing your source code.
         PowerPPL can not imagine ideas for new PPE's.
         PowerPPL can not make coffee :-)





























                                                                        5




             III. First Time Configuration
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         Now you  have installed  PowerPPL, you  should configure  it to
         match your needs...

         First select the Menu by pressing F10.

         Move to the "Options" menu.

         Move to the "Directories" option.

         Here, you  can see  a dialog  box asking  you to  specify  your
         paths.

         "Output directory"  is the  directory where  compiled PPE files
         should be created. Leave blank for current directory.

         "PPLC.EXE  Pathname"   is  the  executable  file  to  run  when
         compiling the PPS source file...

         "PCBOARD.EXE Pathname  + is  the executable file to launch when
         running the PPE

         "PCBOARD.DAT Path"  is the  Path (Only  path! Not Pathname!) to
         your PCBOARD.DAT. This is needed when running the PPE.


         Once this is configured, press enter to confirm.

         Press F10 to select the Menu bar

         Move to the "Run" menu.

         Move to the "User info" option.

         This will brings you another window with 3 fields.

         Enter here  your first name, your last name, and your password,
         exactly as they are on your PCB account !

         Those informations  are needed  when running the PPE... PCBoard
         has to  load some user informations in order to be able to fill
         the user variables... However, if you specify nothing here, PCB
         will launch  the PPE but some functions (such as U_NAME()) will
         not run correctly...

         Once configured, press enter to confirm.

         That's it, everything that was necessary for PowerPPL to work
         is configured. Following instructions are optionnal...

         Press F10 to select menu bar.

         Select "Options" menu.




                                                                        6


         Select "Customize Colors" option.

         Here you can change the entire color set. You may customize the
         code colorization...

         Once customized, press enter to confirm.

         Press F10 to select menu bar

         Select "Environment" option.

         Check if everything match your needs...

         - Compile

             - Create PPE

         When selected, PowerPPL will generate a PPE... if not selected,
         no PPE  will be  created (if  a PPE  file exist, it will remain
         intact)

         - Editor

             - AutoIndent

         When  selected,   the  editor  will  automatically  indent  the
         following line  when pressing  enter on  a line  beginning with
         spaces or tabs.

             - Info Header In Editor

         When selected,  PowerPPL will  generated  and  update  an  info
         header in  each PPS  file loaded...  The info  Header is  a the
         beginning of the file and look like this :

         ;-----------------------------------------------PowerPPL v2.1--
         ; File           : MYPROG.PPS
         ; Original by    : JACK THEBEST on 12/12/1994 at 20:53:52
         ; Last update by : JOE SYSOP on 02/14/1995 at 14:13:01
         ;--------------------------------------------------------------

         The "Original  by" field  is created  when the header itself is
         created.

         The «  Last update  by + field is updated each time the file is
         saved.

         The sysop names are taken from the registration information, so
         this option is only for registered users...


             - Save All Before Compile

         When  selected,   PowerPPL  save  every  editor  window  before
         compiling...

             - Create BAK files




                                                                        7


         When selected,  PowerPPL will  create a  .BAK file  each time a
         file is  saved. This  BAK file  will contain the previous file,
         before any changes were made.


         - Desktop

             - Auto-Save Desktop

         When selected,  the desktop  will be  automatically saved  when
         exiting PowerPPL

             - Auto-Load Desktop

         When selected,  the desktop  will be  automatically loaded when
         entering PowerPPL


         - Memory

             - Swap Before Compile

         When  selected,   PowerPPL   will   swap   itself   in   memory
         (EMS/XMS/Disk) before compile...

             - Swap Before Running

         When  selected,   PowerPPL   will   swat   itself   in   memory
         (EMS/XMS/Disk) before running the PPE.

             - Swap Before shelling To DOS

         When  selected,   PowerPPL   will   swap   itself   in   memory
         (EMS/XMS/Disk) before shelling to DOS.


         - Color

             - Syntax Highlight

         When selected, PowerPPL will colorize your code (you may change
         the color set, see chapter XX. Customizing Colors)

             - @Xnn Translation

         When selected,  PowerPPL will  translate @Xnn  code inside  the
         strings by changing the color. Note that you must have selected
         Syntax Highlight in order to use the @Xnn Translation.


         Once configured, press enter to confirm.

         Press F10 to select menu bar.

         Select "Options" menu.

         Select "Tab Length" option.




                                                                        8


         Set the  tabulation length  to whatever  you want... 8 or 4 are
         commonly used values.



























































                                                                        9




             IV. Managing Projects
             ~~~~~~~~~~~~~~~~~~~~~


         Usually, when  working on  a PPE,  we like  to have  many files
         opened in  the desktop,  this is  why the "Save Desktop" option
         has been created.

         But we  always work  on many  PPE's in  the same time ! And one
         desktop file was limited to handle one project...

         So the  project management  was created...  It allows  as  many
         projects as you want, that is, in fact, as many desktops as you
         want...


             How to create a project ?


         To create a project, simply press F10, "P" and then "O"... This
         will brings you a directory listing with all the *.PRJ files...
         To create  a  project,  simply  type  it's  name  (for  example
         "MYPROG") and the project "MYPROG.PRJ" will be created.

         In addition,  the  file  "MYPROG.PRC"  will  also  be  created,
         containing      your       project-specific       configuration
         (colors/directories/environment/...)


             How to load a project ?


         If you  have selected  the "AutoLoad  Project"  option  in  the
         Environment setup  (see chapter III. First Time Configuration),
         PowerPPL will  search all PRJ files... If only one is found, it
         will be  opened automatically.  If more  than one is found, the
         default desktop  (when there  is no  project loaded, so we will
         call it  the "Default  project") will  be loaded. You will then
         have to  open a  project manually. For this, press F10, the "P"
         and "O". Then select your Project file.


             How to close a project ?

         Press F10,  "P", then  "C" to  close the  project. the  default
         project will be loaded.













                                                                        10




             V. Compiling the source file
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~


         There are  two very similar ways to compile your code, they are
         only different depending you are working with a project or not.

         If you  are not  working with  a project, simply bring the file
         you want  to compile on the top of each other windows and press
         F9...

         If you  are working  with a project, your main file HAS to have
         the same  base name that your project, with the extention .PPS.
         For example,  if your  project is  "MYPROG.PRJ", your main file
         has to be named "MYPROG.PPS" in order to be compiled.

         Once you  have a  corresponding .PPS  file, you  may  press  F9
         wherever you are in PowerPPL, even if you are currently working
         on a  .CFG file  for example,  the  right  .PPS  file  will  be
         automatically recognized and compiled.


         Once the  compilation is done, the message window will be shown
         (if there are errors) or will remain hidden (if the compilation
         was succesful).  See section XIX. "The Message Window" for more
         informations.

































                                                                        11




             VI. Running the source file.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~


         To run  a source  file, simply  press  CTRL-F9  instead  of  F9
         (Compile). PowerPPL  will automatically detect if your file has
         been modified  since the last compile, and will recompile it if
         needed before running the PPE.

         To run a PPE you need to put your personnal informations in the
         "User  Info"   dialog  box.   See  section   III.  "First  Time
         Configuration" for more details.















































                                                                        12




             VII. Working with ;$INCLUDE files.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


         A very  powerfull function  in PPL is the ;$INCLUDE compilation
         directive. It allows you to include some parts of code that are
         located in other files that your main file.

         This function allows to have some sorts of "librairies".

         The problem  when working with ;$INCLUDE files is that you have
         to be  certain that  all your  files are up to date on the disk
         before compiling  your code.  If not,  some old ;$INCLUDE files
         will be included instead of the current ones.

         To avoid  this problem, we will make a project for ANY PPS that
         has some  ;$INCLUDE statements  and then  check the Environment
         option "Save all before compile".

         With this  project, it  will be  easy to open many files in the
         same time  (main source and all ;$INCLUDE files). When you will
         press F9  or CTRL-F9,  all modified  files will be saved so all
         ;$INCLUDE files will be up to date on disk.




































                                                                        13




             VIII. Command Line Parameters.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


         PowerPPL can  take some  arguments when  launched... Here  is a
         typical command line :

         PP [/NOFLIP] [PROJECT.PRJ] [SOURCE.PPS]


             - /NOFLIP

         When PowerPPL is run, if the selected video mode is 25 columns,
         it begins  with a  video mode  flipping (switch  to 50 culumns,
         then switch  back to  25 columns).  This speed up the scrolling
         process, and  is needed when using a not_very_fast machine (CPU
         is <  486 DX2-66).  With this  trick, the  scrolling is  smooth
         enough even on slower machines...

         The  problem   is  that  with  some  multitasking  environments
         (DESQview),  the   video  mode   flipping  trash  the  display.
         Tipically, a  DESQview window  will go  to 50  columns mode and
         won't go  back to  25 lines  until DESQview  has been  left and
         rerun...)

         For this  reason, PowerPPL  now detects  DESQview and  does not
         flip modes if it has been detected... This result with a slower
         scrolling but this allow you to use PowerPPL with it...

         If for  some reason,  you would like PowerPPL not to flip modes
         at startup, simply use the /NOFLIP parameter, and PowerPPL will
         not trash your display...


             PROJECT.PRJ

         You may  load a  specified project  a startup,  just  add  your
         project name  on  the  command  line  and  it  will  be  opened
         automatically...

         Note that if you have only one project in your directory and if
         you checked  the option "Autoload Project", you don't need this
         option...

             SOURCE.PPS

         You may  also load  a source  file ny  typing its  name on  the
         command line.











                                                                        14




             IX. Opening A File.
             ~~~~~~~~~~~~~~~~~~~


         To open a file, press Alt-F to access File Menu, then press O.
         This will brings you a file listing with a directory browser...

         You may press F3 instead of using menu...



















































                                                                        15




             X. Saving A File.
             ~~~~~~~~~~~~~~~~~


         To save  a file,  press Alt-F  to go  to File Menu, than S. The
         file will be saved with its current name.

         You may press F2 instead of using menu...

         If you want to save you file with a new name, press Alt-F to go
         to File  Menu, then  A. Specify  the new  name  and  optionnaly
         answer Yes to the question "Overwrite?".















































                                                                        16




             XI. Changing Directory.
             ~~~~~~~~~~~~~~~~~~~~~~~


         Sometimes, you  may want  to change  the working directory (for
         example if  your PPE create files that you want to be placed on
         another location for a while...).

         To change the working directory, Press Alt-F to access the File
         Menu, then  C... Choose the directory you want, then choose the
         OK button.
















































                                                                        17




             XII. Shelling To Dos.
             ~~~~~~~~~~~~~~~~~~~~~


         If you  want to  process some  DOS commands,  you don't have to
         exit PowerPPL then reload it... just shell to DOS...

         To do this, press Alt-F to access the File Menu, then press D.

         Depending on  your  settings,  PowerPPL  will  swap  itself  in
         memory, leaving  only 220  bytes residents...  see chapter III.
         "First Time Configuration" to see how to turn this option ON.

         When you  come back  fron DOS  (by typing  EXIT on  the command
         line), PowerPPL  will eventually move back to the directory and
         drive where  you were  before shelling...  This  avoid  further
         problems when saving & compiling again...










































                                                                        18




             XIII. Exiting PowerPPL.
             ~~~~~~~~~~~~~~~~~~~~~~~


         To exit  PowerPPL type  Alt-X anywhere you are... If some files
         are modified but not saved, you will be prompt to save them...





















































                                                                        19




             XIV. The IDE (Keys).
             ~~~~~~~~~~~~~~~~~~~~


         The PowerPPL  editor is  a  very  common  editor,  it  features
         clipboard, autoindentation,  and many  other options. It may be
         compared to  the classic  Borland TurboVision  editor, the  one
         used in all Borland's IDE (Borland C++, Borland Pascal,...)


         Here is  a overview  of the  keys that  may  be  pressed  while
         editing a file...

         F1...................................Help
         CTRL-F1..............................Help on keyword
         ALT-F1...............................Call back last Help screen
         F2...................................Save current file
         F3...................................Load new file
         ALT-F3...............................Close Window
         F5...................................Zoom
         ALT-F5...............................User Screen
         F6...................................Next Window
         F9...................................Make PPE file (Compile)
         CTRL-F9..............................Run PPE file (PCB 15.2+)
         F10..................................Menus
         Alt-X................................Quit
         Alt-n................................Jump to Window #n
         Alt-?................................Menu Shortcuts
         Alt-W + M............................Message Window
         Alt-Space............................System Menu
         CTRL-P...............................Activate "Any key" mode
         Alt-Y................................Toggle @Xnn Translation
         Alt-M................................Open ASCII Chart
         Alt-A................................Open @Xnn Pick Chart


         Overview of  keys that  may be  pressed when  a text  block  is
         selected :

         Ctrl-Ins.............................Put in clipboard
         Shift-Del............................Put in clipboard & delete
         Shift-Ins............................Paste from clipboard
         Del/Ctrl-Del.........................Remove text
         CTRL-I...............................Indent block
         CTRL-U...............................Unindent block
         (Indentation & Unindentation works only with SPACES... a CTRL-U
         will NOT unindent Tabs...)












                                                                        20




             XV. The Clipboard.
             ~~~~~~~~~~~~~~~~~~

         The clipboard  may be  accessed via  the Edit  Menu by pressing
         Alt-E then  S. The  clipboard window  will show everything that
         has been  used inside  the clipboard...  This allow you to take
         back your  old  clipboard  buffers...  To  change  the  current
         clipboard contents,  simply select the part you want to be used
         and return to you source window...


















































                                                                        21




             XVI. Searching / Replacing Text.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         To search  for a specified string within your source, bring the
         Search menu by pressing Alt-S, then F.

         To replace  a string  by  another  string,  use  the  "Replace"
         submenu by pressing Alt-S then R.

         To execute  again the  laste search  or replace, use the Search
         Again submenu, by pressing Alt-S then S (CTRL-L is a shortcut).
















































                                                                        22




             XVII. Setting Compilation Arguments.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         PowerPPL allows  you  to  have  total  control  over  the  PPLC
         switches (/NOUVAR  &  /DISARR)  through  a  dialog  box  called
         "Compiler Options".  You may  access this box by pressing Alt-C
         (Compile Menu) then P (Parameters).

         There are two options :

             Array Dimention Checking

         This option  allow the compiler to check for mistakes using the
         statement REDIM. for example :

             DIM TABLE(5,5,5)
             ...
             REDIM TABLE,10,10

         This will generate an error unless Array Dimension Checking has
         been disabled.


             User Variable Generation

         This allow  the PPE  to generate  the user  variables (U_...())
         when starting...  disable this option if you don't want to have
         the work done.


         Usually, there  is no  need to  change anything... both options
         may be checked unless you have reasons to change that.



























                                                                        23




             XVIII. Resizing / moving Windows.
             ~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~

         You may want to resize you windows, espacially if you work with
         many files  on a  big project...  If you  have a  mouse, simply
         click on the low right corner of you window and drag the window
         size to  what you need. To move you window, click on the editor
         title bar and drag the window to your new location.

         If you  have no  mouse, press CTRL-F5 to resize you window. the
         border style  will change to a single line, indicating that you
         are now  changing the  window size  & place. Press left & right
         arrows to  move the  window, press  Shift-Left  or  Shift-Right
         arrows to resize the window.

         When your  project is  saved, all  windows will  be saved  with
         their respective sizes & positions.










































                                                                        24




             XIX. The Message Window.
             ~~~~~~~~~~~~~~~~~~~~~~~~

         The message  window may  be access  by pressing  Alt-W  (Window
         menu) then M (Message Window).

         The message  window holds  all the  system messages. this means
         that you  will find  here all errors reported by PPLC, and also
         aother messages  such as  "Can't find  PCBOARD.EXE at specified
         location" (shown when a wrong pathname is specified).

         When the  message window  contains the errors, moving on a line
         automatically brings  the corresponding  source  line  provided
         that the corresponding source file is loaded (because PPLC does
         not report  path when  errors occurs  in ;$INCLUDE files, it is
         not possible  to open  a new  editor when  an error occurs on a
         closed source file)










































                                                                        25




             XX. Customizing Colors.
             ~~~~~~~~~~~~~~~~~~~~~~~

         You may  customize any  PowerPPL system color. This include all
         windows, menus, syntax highlight and desktop.

         To access  the color  editor, press Alt-O (Options menu) then C
         (customize colors).

         This brings  you a  color edition  dialog box.  Move thrue  the
         items and  selected the  desired colors.  Press OK when you are
         done, the  color sheme will be updated as soon as you leave the
         dialog box.

         You may  restore  the  default  colors  by  using  the  submenu
         "Default Colors" (Alt-O then D).











































                                                                        26




             XXI. Setting Environment Options.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         See chapter III. "First Time Configuration".























































                                                                        27




             XXII. Setting Tabulation Length.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         Press Alt-O  (Options menu)  the T  (Tab  Length)  to  set  the
         Tabulation length. Commonly used values are 4 and 8.






















































                                                                        28




             XXIII. Saving / Retreiving the environment.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         NOTE :  Those options are only needed if you didn't checked the
         "AutoLoad project"  & "AutoSave  Project"  in  the  Environment
         options submenu. See capter III. "First Time Configuration" for
         more details.

         To save the current window positions and sizes, and the current
         Environment options, colors, directories, compiler options, and
         all other  configuration components,  use  the  "Save  Desktop"
         option by pressing Alt-O (Options menu) then S (save Desktop).

         To  retreive  a  previously  saved  desktop,  choose  "Retrieve
         Desktop". If you are working with a project, this will load the
         project depending  desktop file.  If you are not working with a
         project, this  will load the default project desktop. To load a
         project, please refer to chapter IV. "Managing Projects".









































                                                                        29




             XXIV. Using Help.
             ~~~~~~~~~~~~~~~~~

         Help may be accessed by different ways. Using the Help Menu you
         will have  the opportunity to choose the topic you want to see.
         You may  access directly the contents (PowerPPL help), the Help
         Index (PPL help), or you may also choose to see again your last
         topic.

         You may  press F1  wherever you  are in  an editor  to get  the
         PowerPPL help.

         You may  press also  CTRL-F1 to  get help  on the keyword found
         under your  cursor. A full help on all PPLC 3.10 statements and
         functions is available.

         To move  between topics  inside the help viewer, press TAB. For
         now, you  cannot move  a cursor  to choose  your topic, nor you
         cannot type  the first  letters of  a topic,  as in Borland IDE
         Help systems.

         Press Alt-F1 anytime to get your last Help topic.

         Shift-F1 brings you the Help index (PPL help).



































                                                                        30




             XXV. Performing a Zippy Text Search in Help.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         A very powerfull function is the Zippy text search. By pressing
         CTRL-F4, you  get a  dialog box asking you for a string to find
         within the  help file...  press enter  and PowerPPL will search
         this string  inside all  help topics.  This may  take some time
         depending on  your CPU power (about 13s with a 486 dx-25, about
         4s with a 486 dx/4-100)

         Once the  Zippy text  search has  been performed,  a  list  box
         appears and shows you a list of concerned items. press enter on
         whatever item  you want  to view...  when leaving the help, you
         will get back the list. Press Esc to leave.













































                                                                        31




             XXVI. The Ascii Table / The @Xnn Pick Chart.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


             The ASCII Table.

         The ascii table may be accessed via the System Menu (Alt-Space)
         or by pressing Alt-M.

         Move to the char you need, then press ENTER or INSERT to insert
         the character into the editor at the cursor location.

         You may  also use  the ascii  window to see the Decimal and Hex
         values of a char.


             The @Xnn Pick Chart.

         The @Xnn  pick chart may be accessed from the system menu (Alt-
         Space) or by pressing ALT-A.

         Move to  the color  you need,  then press  ENTER or  INSERT  to
         insert the color code into the editor at the cursor location...

         You may  also use the @Xnn pick chart to see the Hex value of a
         color code.

































                                                                        32




             XXVII. The Calculator.
             ~~~~~~~~~~~~~~~~~~~~~

         The calculator  is a  simple four-function calculator with add,
         substract, multiply, and divide. To operate the calculator, you
         can either  use  the  keybord  or  press  the  buttons  on  the
         calculator with the mouse. The C key clears the calculator, the
         backspace will  erase the  last character  typed, and the "+/-"
         key toggle  the value  from positive  to negative (the keyboard
         equivalent of "+/-" is "_").

















































                                                                        33




             XXVIII. The Calendar.
             ~~~~~~~~~~~~~~~~~~~~~

         The Calendar  displays the  current month,  highlighting todays
         date. The  next and previous months can be viewed using the "+"
         or "-"  keys respectively. The mouse can also be used to change
         the month by pressing the up and down icons.




















































                                                                        34




             XXIX. Changing Video Mode to 50 Lines.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         Access the  System menu  by pressing Alt-Space, then select the
         Video Mode submenu.

         This will toggle video mode from 25 lines to 50.

         NOTE :  You may  experience troubles  if you  use the  50 lines
         option with DESQview.

















































                                                                        35




             XXX. The About Box.
             ~~~~~~~~~~~~~~~~~~~

         The About  box displays  the PowerPPL  version. If  PowerPPL is
         registered (by  sending  a  postcard),  it  displays  also  the
         registration's owner.





















































                                                                        36




             XXXI. Troubleshooting.
             ~~~~~~~~~~~~~~~~~~~~~~

         Q1> When  i try  to run  a PPE,  PowerPPL says "PCBOARD.EXE not
         found at specified location"
         A> Check your directories settings (Options/Directories)

         Q2> When  i try  to compile  a PPS,  PowerPPL says  "Not enough
         memory to allocate script memory buffer"
         A> Check the option "Swap when compile". (Options/Environment)

         Q3> I  tried to move the file header in another location within
         the file, but PowerPPL creates another one at the beginning.
         A> PowerPPL  scan only  the 10  first lines  of each file for a
         header. if  none has  been found, it creates a new one, placing
         it at the beginning of your file.

         Q4> Why PowerPPL does not create header for my .INC file.
         A> PowerPPL only creates headers for *.PP? files. Try to rename
         your include file as *.PPI for example.

         Q5> When  i try  to run a PPE, a message saying "Unable to open
         PCBOARD.DAT, Exiting to DOS!" appears.
         A> Check  your directories  settings (Options/Directories).  Be
         carefull to  put only PATH when a path is asked and to put PATH
         & FILE when a pathname is asked.

































                                                                        37




             XXXII. Getting Your FREE Keyfile.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         This is  not ShareWare...  This  is  not  FreeWare...  This  is
         CARDWARE !
         ^^^^^^^^

         To get  your personnal  keyfile, just  send me a postcard, with
         your first and lastname.

         On you  postcard, you  can add up to 2 lines (158 chars) of BBS
         advertising. Those  lines  will  be  added  to  a  file  called
         THANKYOU.ALL and  will be  included  in  the  next  release  of
         PowerPPL !


         Send your postcard to :

         ELECTRON - POWERPPL
         B.P. 101
         91801 BRUNOY CEDEX
         FRANCE


         If you  have an  internet or  fido address, say it so i will be
         able to  send you  a  message  as  soon  as  new  versions  are
         available.


         Once you  sent your postcard, wait 15 days and call the support
         BBS, ELECTRON BBS :

           Node 1: +33-1-69.39.46.30 (28.800 HST D/S)
           Node 2: +33-1-69.39.31.52 (16.800 HST D/S)

         Use the EXACT firstname and lastname you mailed me.
                 ~~~~~

         If I  received your  postcard, your  personnal keyfile  will be
         available to  transfer (only  1  to  3  Kb)  even  if  you  are
         registered or not and without filling any questionnaire.

         No Keyfile will be sent without receiving a postcard first !!
         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                       YOU DON'T HAVE TO PAY ANYTHING !

         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
         Once you  have copied  your keyfile  in PowerPPL directory, any
         nasty reminder box, including the one that you get after typing
         Alt-X, will be removed !

         Please, do  it, so  I will know how usefull this software is...
         If I  receive many  postcards, I  will keep working on PowerPPL




                                                                        38




             XXXIII. Becoming a Beta-Tester.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         If you want to be part of the beta testing team, simply contact
         me after  sending your  postcard and  you will  be added in the
         beta testing team...

         Once a new version is available, you will automatically receive
         a note.

         You must have an internet access or a fido adress to be part of
         the beta-testing team.

         Only registered users can be part of the beta testing team.


             The Beta-Testing Team
             ~~~~~~~~~~~~~~~~~~~~~

               Olivier Langlois (Coordinator)
               Vincent Negrier
               Christophe Yvon
               Stephane Boullet
               Nicolas Jahier



































                                                                        39




             XXXIV. Suggestions, Remarks.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

         Bug reports,  suggestions and  remarks are  welcome and  may be
         sent via e-mail to powerppl@electron.fr






















































                                                                        40




             XXXV. Getting New Versions.
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~

         You can  get all  new versions  of  PowerPPL,  by  calling  the
         support BBS   (PowerPPL  is  downloadable  before  filling  any
         questionnaire).

         ELECTRON (France)

           Node 1    : +33-1-69.39.46.30 (USR HST D/S)
           Node 2    : +33-1-69.39.31.52 (USR HST D/S)
           Freq Fido :  2:320/214 & 2:320/219 'POWERPPL'

         You may also get PowerPPL from the FTP wuarchive.wustl.edu
         [128.252.135.4] in the directory /pub/MSDOS_UPLOADS/ppe


             Mailing list.
             ~~~~~~~~~~~~~
         Simply contact me to be added into the mailing list. Once a new
         version (non  beta) is released, you will automatically receive
         a message. You must have an internet access or a fido adress to
         be part of the mailing list.




































                                                                        41




             XXXVI. Copyrights.
             ~~~~~~~~~~~~~~~~~~

           PowerPPL is Copyright (C)1995 Francis Gastellu

         DESQview is Copyright(C) Quarterdeck Office Systems
         PCBoard & PPLC are Copyright(C) Clark Development Company, Inc
         TurboVision is Copyright(C) Borland International
         MSDOS is Copyright(C) Microsoft Corporation
         The PowerPPL  installation program  uses the original FrontDoor
         Look&Feel by  Joaquim Homrighausen.  It  has  been  used  after
         asking permission.
         FrontDoor is Copyright(C) Joaquim Homrighausen

         All Softwares  and Trademarks  listed are exclusive property of
         their owners.











































                                                                        42




             XXXVII. Disclaimer.
             ~~~~~~~~~~~~~~~~~~~

         This program has been tested on many computer and has always
         worked perfectly, but I cannot garantee that it will be the
         same on yours...

         It is totally excluded that this software destructs anything on
         your system, but, because we never take enough care :

         IN NO  EVENT WILL  I (THE  AUTHOR) BE  LIABLE TO  YOU  FOR  ANY
         DAMAGES, INCLUDING  ANY LOST  PROFITS, LOST  SAVINGS  OR  OTHER
         INCIDENTAL OR  CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR
         INABILITY TO  USE THE  PROGRAM, OR  FOR ANY  CLAIM BY ANY OTHER
         PARTY.