home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / prokit / tips.doc < prev    next >
Text File  |  1989-06-02  |  3KB  |  76 lines
  1.  
  2. ProKit Door Writing Tips                                (C) 1988 S.H.Smith
  3. ------------------------                                ProKit 2.8, 8/4/88
  4.  
  5. +  Do all output with DISP, DISPLN and NEWLINE functions.
  6.  
  7. +  Do NOT use Borland's CRT unit.  The CRT unit will lock up in some
  8.    multi-task systems, and does not communicate.
  9.  
  10. +  Use one of the provided input functions to read from the user
  11.       GET_CMDLINE   - for command lines
  12.       INPUT         - for lines with length limits
  13.       GET_KEY       - for single characters (no echo)
  14.  
  15. +  Use the supplied functions to select one of the seven basic colors
  16.       RED, GREEN, BLUE, CYAN, MAGENTA, WHITE, GRAY.
  17.    These can be used at any time (even in non-graphic mode).
  18.  
  19. +  Use these functions ONLY when in GRAPHICS mode:
  20.       POSITION(x,y);
  21.       CLEAR_SCREEN;
  22.       CLEAR_EOL;
  23.  
  24. +  Check the GRAPHICS flag before sending any ANSI codes to the user;
  25.    some users won't accept ansi codes.
  26.  
  27. +  Check the DUMP_USER flag in all major program loops.  This flag is set
  28.    if the user hangs up, his time runs out, or if the sysop wants to dump
  29.    the caller out of the door.
  30.  
  31. +  Always call UNINIT before calling HALT to terminate a door program.  
  32.    Otherwise the dangling interrupt handlers will crash the system.
  33.  
  34. +  The first line of a ProKit config files must be the com driver type.
  35.    This can be one of:
  36.       INTERRUPT         ;the best, fastest
  37.       BIOS              ;if interrupts fail to work
  38.       PCBTRAP           ;BIOS with special screen management for PCBTRAP.
  39.    Your door program is free to re-open the config file and read additional
  40.    information from it.
  41.  
  42. +  ProKit based doors can be tested with a special "local sysop" mode of
  43.    operation.  In this mode, you need not load PCBoard to run the door.
  44.    This option is selected by adding 'LOCAL' to the end of the door
  45.    command line.  For example:
  46.       prokit prokit.cnf \pcb2 LOCAL
  47.    will run the ProKit demo door in sysop-local mode directly from DOS.
  48.  
  49. +  The standard DOOR script for ProKit doors has this format:
  50.       echo off
  51.       cd \pro
  52.       prokit prokit.cnf c:\pcb2
  53.       cd \pcb2
  54.       if exist event.bat event               <<<--- take note
  55.       board
  56.    Notice line 5.  This line will start your timed event if needed.  Any
  57.    door that can logoff a user (during carrier loss or with goodbye) has
  58.    the possibility of starting the event.
  59.  
  60. +  The F5 (shell to DOS) function will only work if you leave enough 
  61.    free ram for a new copy of COMMAND.COM to be loaded.  To do this, you
  62.    need to include this directive in your main program:
  63.       {$M 12000,40000,40000}  {Stack, minheap, maxheap}
  64.    Adjust the values to your needs, but limit the MAXHEAP setting to the
  65.    smallest value that is needed.  This leaves the rest of memory available
  66.    for the shell.
  67.  
  68. +  Take a look at the sample door - PROKIT.PAS - it has examples of how
  69.    to use many of ProKit's features.
  70.  
  71. +  Call the function load_cnames_file during your door initialization if
  72.    you are going to access the conf_info data structure.  This is no
  73.    longer automatically loaded, speeding up doors that have no interest
  74.    in this data.
  75.  
  76.