home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / dosutils / fflip216.arj / FASTFLIP.DOT < prev    next >
Text File  |  1992-04-07  |  53KB  |  1,078 lines

  1. {comment}
  2. ┌────────────────────────────────────────────────────────────────────────────┐
  3. │                                                                            │
  4. │             File: FASTFLIP.DOT                                             │
  5. │                   FastFlip v2.16 Documentation                             │
  6. │     Requirements: DOCPRT v1.3                                              │
  7. │           Author: Chris Curran                                             │
  8. │                   Aquila Data Systems, Inc.                                │
  9. │          Created: 12-01-91                                                 │
  10. │         Modified: 02-04-92                                                 │
  11. │                                                                            │
  12. └────────────────────────────────────────────────────────────────────────────┘
  13. {comment}
  14. {pagesize} 59
  15. {row}  20
  16.                                    {b}FastFlip{n}
  17.  
  18.                          The {i}Fast{n} Application Swapper
  19. {box} 0   0  3000 2399 1 100 0
  20. {box} 850 655 350 1050 1 100 10
  21. {newpage}
  22. {row}  28
  23.          FastFlip, Copyright 1992 Aquila Data Systems and Chris Curran.
  24.                               All rights reserved.
  25. {row}  49
  26.                            Aquila Data Systems, Inc.
  27.                                304 Bayfield Drive
  28.                                Brandon, FL  33511
  29.  
  30.                FAX   : (813)653/2408  Group II, III
  31.                BBS #1: (813)653-2937  1200-38400 v.32bis/v.42bis
  32.                BBS #2: (813)685-4218  1200-38400 v.32bis/v.42bis
  33. {newpage}
  34. {header}
  35. {shade} 50 400 2825 2 100   ;tall vertical line on left
  36.  
  37. {header}
  38. {footer}
  39.   {shade} 2880 56 105 2286 10  ;row,col,rows,cols,%grey
  40.   ────────────────────────────────────────────────────────────────────────────
  41.     FastFlip v2.16                                          Table of Contents
  42. {footer}
  43.     Contents
  44.                 Topic                           Section   Page
  45.                ─────────────────────────────────────────────────
  46.                 General
  47.                   Tools Used                       1       1
  48.                   Program Description              1       2
  49.                   System Requirements              1       2
  50.                   Memory Requirements              1       2
  51.                   Installing FastFlip              1       4
  52.                   Starting FastFlip                1       4
  53.                   Command line options             1       5
  54.  
  55.                   Program Status Screen            1       6
  56.                   Editing Pages Online             1       7
  57.                   Custom DOS Prompt                1       8
  58.                   Cut & Paste                      1       9
  59.  
  60.  
  61.                 Configuration
  62.                   FFSETUP.EXE                      2       1
  63.                   Startup Parameters               2       2
  64.                   Application Pages                2       4
  65.  
  66.  
  67.                 Command Line Operation
  68.                   Help                             3       1
  69.  
  70.  
  71.                 Trouble Shooting
  72.                   Help                             4       1
  73.  
  74.  
  75.                 Programmer Interface
  76.                   Definition                       5       1
  77.                   Functions                        5       1
  78.  
  79.  
  80.                 Legal Information
  81.                   License                          6       1
  82.                   Shareware Policies               6       1
  83.                   BBS Operators                    6       1
  84.                   Disclaimer                       6       2
  85.                   Trademarks                       6       2
  86.  
  87.  
  88.                 Ordering Information
  89.                   How                              7       1
  90.                   Form                             7       3
  91.  
  92. {newpage}
  93. {footer}
  94.   {shade} 2880 56 105 2286 10  ;row,col,rows,cols,%grey
  95.   ────────────────────────────────────────────────────────────────────────────
  96.     FastFlip v2.16                                        Section {sl}, Page {pr}
  97. {footer}
  98. {setpage} 1
  99.  Development    C compiler     : BorlandC++ v2.0   (Borland)
  100.   Tools Used    Assembler      : TASM v3.0         (Borland)
  101.                 Linker         : TLink v5.0        (Borland)
  102.                 Debugger       : TDebug v3.0       (Borland)
  103.                 Editor         : Qedit 2.15        (SemWare)
  104.                 Version Control: PVCS for DOS      (Sage Software)
  105.                 C Libs         : CodeRunneR        (Omega Point, Inc.)
  106.                                : PDK1-3, ADK1      (Omega Point, Inc.)
  107.  
  108.  
  109.                 Omega Point is the developer of a group of TSR libraries for
  110.                 'C' programmers. Their libraries were used extensively in
  111.                 the development of FastFlip, most notably ADK1. It should
  112.                 also be noted that a sample program provided with ADK1 was
  113.                 used as the "starting point" for FastFlip. While FastFlip no
  114.                 longer resembles the original sample, FastFlip does have its
  115.                 roots in someone else's work. In other words, credit is due
  116.                 to Omega Point for providing superior programming libraries
  117.                 with superior sample programs to its customers.
  118.  
  119.                 It should also be noted that Omega Point provides some of
  120.                 the best technical support there is. There are no three day
  121.                 waits for a call back from tech support! Without the quality
  122.                 tech support provided by Omega Point, FastFlip would have
  123.                 been next to impossible to write.
  124.  
  125.                 While the Omega Point documentation is not what one would
  126.                 call "perfect", it is much better than other products
  127.                 competing in the same market, and sufficient for most
  128.                 applications. Omega Point has also been receptive to
  129.                 comments and suggestions concerning their doc, and has
  130.                 continually improved the quality of its documentation with
  131.                 each release.
  132.  
  133.                 And no, I don't work for Omega Point, and I don't get any
  134.                 kick-back from them (no free updates). The above is this
  135.                 programmers opinion; you may or may not agree.
  136.  
  137.                 How to contact Omega Point:
  138.  
  139.                         Omega Point, Inc.
  140.                         25 Birch Road
  141.                         Framingham, MA  01701
  142.  
  143.                         Voice: (508)877-1819
  144.                           BBS: (508)875-8009
  145. {newpage}
  146.      Program    FastFlip v2.16
  147.         Name    Application Swapper
  148.  
  149.  
  150.  What is it?    FastFlip(tm) is a versatile program management tool that
  151.                 allows you to load up to 10 programs at once and instantly
  152.                 switch between them. You can switch between your word
  153.                 processor, spreadsheets, databases, and utilities at will
  154.                 without having to wait. This eliminates the need to exit one
  155.                 program to open and use another, which lets you concentrate
  156.                 on the reasons why you are using your software in the first
  157.                 place.
  158.  
  159.                 NOTE: This is NOT a multi-tasker; the PC apps are simply
  160.                       swapped in and out as desired. The *only* task that is
  161.                       actually running is the task that is being viewed.
  162.  
  163.  
  164.         Why?    Why on EARTH would someone write "yet another task
  165.                 switcher"? Good question.
  166.  
  167.                 FastFlip is not like other task switchers. For one, FastFlip
  168.                 is "lean & mean"; there aren't ten zillion features to
  169.                 learn, configure and remember. Because of this, you'll have
  170.                 FastFlip "up & running" in only minutes! And it's EASY!
  171.  
  172.                 But just because FastFlip is easy use doesn't mean it's a
  173.                 "bare-bones" program. You can CUT & PASTE data from one
  174.                 application to another, specify memory size and type for
  175.                 each application page, and control it from DOS BAT files.
  176.                 And if you're a programmer, you can even control FastFlip
  177.                 from within your own programs!
  178.  
  179.                 Everything about FastFlip is FAST. FAST setup. FAST load.
  180.                 FAST task switching.
  181.  
  182.  
  183.       System    FastFlip will run on the IBM PS/2, PC/AT, PC/XT, PC, and
  184. Requirements    IBM compatible computers including the Compaq, NCR, Tandy,
  185.                 and WYSE PC's.  MINIMUM requirements are:
  186.  
  187.                   - 512k of memory.
  188.                   - PC/MS-DOS 3.0 or higher
  189.                   - Color or monochrome monitor with 80-column display.
  190.  
  191.  
  192.       Memory    Now for the next question in everyone's mind - how much
  193. Requirements    memory is this going to cost me? 16k! That's right - you can
  194.                 have up to 10 PC applications running at the same time for
  195.                 16k of DOS memory. And if you load FastFlip into upper
  196.                 memory (with DOS 5.0), it will leave a 0k DOS footprint!
  197.  
  198. {newpage}
  199.                 The memory/disc space requirements of FastFlip are as
  200.                 follows (assuming you use the default memory settings):
  201.  
  202.                     1.  ~775k of XMS memory per application, or
  203.                     2.  ~775k of LIM memory per application, or
  204.                     3.  ~775k of disc space per application, or
  205.                     4.  Any combination of the above.
  206.  
  207.                 FastFlip is able to "scatter" its data requirements among
  208.                 the different stowage mediums available at load time. In
  209.                 other words, it can use some XMS, some LIM and send the rest
  210.                 to disc.
  211.  
  212.                 XMS memory is preferred, then LIM, then lastly the disc
  213.                 drive. Note that FastFlip can directly access XMS (extended
  214.                 memory) if it is available. This type of memory is the
  215.                 cheapest to add to a PC (no extra boards are needed to
  216.                 install or control this type of memory), and also the
  217.                 fastest performing memory you can add to your PC. Street
  218.                 prices for memory are now about $50 to $75 per meg
  219.                 (depending on type and speed).
  220.  
  221.                 Also note that if you use extended memory, you'll need to
  222.                 include HIMEM.SYS in your CONFIG.SYS file (make it the first
  223.                 entry).
  224.  
  225.                 If a disc drive is used (and most will need to), then disc
  226.                 caching software is recommended. I personally use HyperDisk
  227.                 version 4.21 and find it to be one of the best. I have my
  228.                 machines on UPS's, so I also enable the disc write caching
  229.                 of HyperDisk, which tremendously decreases application swap
  230.                 time.
  231. {newpage}
  232.   Installing    You may install FastFlip two different ways: 1) copy all
  233.     FastFlip    FastFlip files to the directory of your choice (a separate
  234.                 directory is recommended), or, 2) run the FastFlip install
  235.                 program, "FFINST".
  236.  
  237.  
  238.     Starting    To start FastFlip, type FASTFLIP at your DOS prompt,
  239.     FastFlip    followed by any optional command line parameters (see
  240.                 next page). Do NOT start FastFlip if you have "shelled to
  241.                 DOS" from another application - this will leave "holes" in
  242.                 your memory.
  243.  
  244.                 After FastFlip has been loaded, you may "hotkey" into any
  245.                 available application. With the exception of Windows 3.0,
  246.                 FastFlip can swap almost any application - even hi-res
  247.                 graphics applications.
  248.  
  249.                 NOTE: FastFlip defaults to three application pages; to
  250.                       change this (and other) settings you need to run the
  251.                       setup program (see Section 2).
  252.  
  253. {newpage}
  254. Command Line    Command line options allow you to override settings that you
  255.      Options    have defined in the setup program. The available command
  256.                 line options are as follows:
  257.  
  258.                   /?  Display HELP screen. The help screen may be displayed
  259.                       before, or after FastFlip is loaded.
  260.  
  261.                   /C  Sets the hotkey used for CUT.
  262.  
  263.                       Example:    FastFlip /clcs-1
  264.  
  265.                                   Sets the CUT hotkey to Left-Ctrl-Shft-1.
  266.  
  267.                   /E  Forces FastFlip to NOT use any available EXPANDED
  268.                       memory (LIM 3.x-4.x) for swapping.
  269.  
  270.                   /I  Displays detailed information about the currently
  271.                       defined pages.
  272.  
  273.                   /M  Sets the hotkey used for MENU.
  274.  
  275.                   /N  Specifies the number of pages FastFlip will setup. The
  276.                       default is 3, and the maximum is 10.
  277.  
  278.                       Example:    FastFlip /n6
  279.  
  280.                                   Loads FastFlip with 6 pages.
  281.  
  282.                   /P  Sets the hotkey used for PASTE.
  283.  
  284.                   /S  FastFlip will use the current drive for swapping (if
  285.                       disc swapping is needed). If you do not have
  286.                       sufficient space on the current drive, or, have a RAM
  287.                       drive with sufficient space, use this option to
  288.                       specify a different swap drive.
  289.  
  290.                       Example:    FastFlip /sg
  291.  
  292.                                   Loads FastFlip, and swaps to drive G: if
  293.                                   needed.
  294.  
  295.                   /U  Unload FastFlip from memory. This option requires that
  296.                       FastFlip is the LAST TSR that has been loaded. If
  297.                       other TSR's are loaded AFTER FastFlip, they will need
  298.                       to be removed before FastFlip can perform an unload.
  299.  
  300.                   /X  Forces FastFlip to NOT use any available XMS memory for
  301.                       swapping.
  302. {newpage}
  303.      Program    After FastFlip has been loaded, LCTRL-? will pop-up the
  304.       Status    application status menu.
  305.  
  306. {shade}  275  499  750  1554  10   ;row,col,rows,cols,%grey
  307.                 ┌───────────────────────────────────────────────────┐
  308.                 │Pg Stat  Mem    Program                    HotKey  │
  309.                 │───────────────────────────────────────────────────│
  310.                 │ 1  ══>  554k   Dos Prompt                 LC-1    │
  311.                 │ 2  Act  256k   Dos Prompt                 LC-2    │
  312.                 │ 3  Idl  256k   Dos Prompt                 LC-3    │
  313.                 │ 4  Idl  256k   Dos Prompt                 LC-4    │
  314.                 │ 5  Act  256k   Dos Prompt                 LC-5    │
  315.                 │ 6  Idl  256k   Dos Prompt                 LC-6    │
  316.                 │ 7  Idl  256k   Dos Prompt                 LC-7    │
  317.                 │ 8  Idl  256k   Dos Prompt                 LC-8    │
  318.                 │ 9  Idl  256k   Dos Prompt                 LC-9    │
  319.                 │ 0  Idl  256k   Dos Prompt                 LC-0    │
  320.                 │───────────────────────────────────────────────────│
  321.                 │           Enter Page #, or 'E' to edit            │
  322.                 └───────────────────────────────────────────────────┘
  323.  
  324.                            Sample Application Status Menu
  325.  
  326.  
  327.                 The Application Status Menu is rather self-explanatory. The
  328.                 current page is indicated with a "══>". Pages that are idle
  329.                 show "Idl" and pages that are active (but not currently
  330.                 selected) show "Act". The status display also shows the
  331.                 amount of memory, program name and hotkey for each page.
  332. {newpage}
  333.      Editing    A limited number of fields may be modified at run time for
  334.      Program    each application page. To edit the settings of a page, enter
  335.  Information    'E' and select the appropriate page number from the list.
  336.                 The following screen will then be displayed:
  337.  
  338. {shade}  375  499  400  1610  10   ;row,col,rows,cols,%grey
  339.                 ┌─────────────────────────────────────────────────────┐
  340.                 │    Page: x                                          │
  341.                 │    Name: _________________________                  │
  342.                 │ Program: ________________________________________   │
  343.                 │ Chg Dir: ________________________________________   │
  344.                 │                                                     │
  345.                 │ Pause for command line options? (Y/N): _            │
  346.                 │                                                     │
  347.                 └─────────────────────────────────────────────────────┘
  348.  
  349.                                Sample Page Edit Display
  350.  
  351.  
  352.                      Page   The page number being edited. This is a display
  353.                             only field.
  354.  
  355.                      Name   The description of the program. This may be any
  356.                             text up to 25 characters.
  357.  
  358.                   Program   The DOS name of the program. If the program is a
  359.                             COM or EXE file, an extension is not needed. If
  360.                             the program is a BATCH file, then the ".BAT"
  361.                             extension *MUST* be included.
  362.  
  363.                             If the program is in your DOS PATH, then a path
  364.                             does not need to precede the DOS file name. If
  365.                             the program is NOT in your DOS PATH, then you
  366.                             must specify the path with the file name, or use
  367.                             the "Chg Dir" field below.
  368.  
  369.                             If you only want a DOS prompt, leave this field
  370.                             blank. A BATCH file will also return to the DOS
  371.                             prompt (unless an EXIT command is included).
  372.  
  373.                   Chg Dir   The path that FastFlip should change to when the
  374.                             program is started.
  375.  
  376.                     Pause   If this field is "Y", FastFlip will pause for
  377.                             entry of any parameters to be passed to the
  378.                             program.
  379. {newpage}
  380.   Custom DOS    If a custom prompt is desired for each page at the DOS
  381.       Prompt    prompt, specify a BATCH file in the Program field to change
  382.                 the prompt.
  383.  
  384.                 Example SETNEWP.BAT file for DOS:
  385.  
  386.                     @echo off
  387.                     prompt $e[37;40m%1│$p$g$e[36;40m
  388.  
  389.  
  390.                 Example SETNEWP.BAT file for 4DOS users:
  391.  
  392.                     @echo off
  393.                     setdos /V0
  394.                     prompt $e[37;40m%1│$p$g$e[36;40m
  395.  
  396.  
  397.                 This BATCH file will set a new prompt for this page (the
  398.                 4DOS version also sets a 4DOS state variable). The PROMPT
  399.                 statement above requires ANSI.SYS (or equivalent) to be
  400.                 loaded since it also changes the color of the prompt (my
  401.                 personal preference). Note the placement of the DOS
  402.                 parameter "%1" - this parm is specified in the FastFlip
  403.                 Program Edit screen for this page (see example below).
  404.  
  405.                 Following is a sample BATCH file setup:
  406.  
  407. {shade} 1475  618  400  1612  10   ;row,col,rows,cols,%grey
  408.                     ┌─────────────────────────────────────────────────────┐
  409.                     │    Page: 3                                          │
  410.                     │    Name: Dos Prompt                                 │
  411.                     │ Program: setnewp.bat 3                              │
  412.                     │ Chg Dir:                                            │
  413.                     │                                                     │
  414.                     │ Pause for command line options? (Y/N): N            │
  415.                     │                                                     │
  416.                     └─────────────────────────────────────────────────────┘
  417. {newpage}
  418.      Cut and    FastFlip also allows you to "cut and paste" data between
  419.        Paste    applications.
  420.  
  421.                 Cutting   The contents of one application screen may be
  422.                    Data   copied to another application, or to itself. Data
  423.                           that is to be copied must first be marked, then
  424.                           "cut". Note that the term "cut" does not denote
  425.                           that any damage or modification with come to the
  426.                           original data.
  427.  
  428.                           Data is marked for cutting by pressing
  429.                           "Left-Ctrl-Left-Shft-C". The current application
  430.                           screen will then be set to white on black, and the
  431.                           marked area will be displayed as white on blue.
  432.                           The current cursor location is used as the upper
  433.                           left corner of the marked block. Use the arrow
  434.                           keys to expand or shrink the marked area.
  435.  
  436.                           You may not move the cursor above or to the left
  437.                           of the current upper left corner of the marked
  438.                           block. If the upper left corner of the block needs
  439.                           to be moved, press "A", reposition the cursor and
  440.                           press "A" to anchor the upper left corner of the
  441.                           marked block.
  442.  
  443.                           After the block has been marked, press "Enter".
  444.                           The data will then be copied to a disc file for
  445.                           later use by the Paste command. The disc file is
  446.                           NOT erased after a Paste command, or when FastFlip
  447.                           is unloaded. This allows you to paste the same
  448.                           data any number of times, to any number of
  449.                           applications.
  450.  
  451.                 Pasting   The contents of the disc cut file is pasted to the
  452.                           current application by pressing
  453.                           "Left-Ctrl-Left-Shft-P". The contents of the disc
  454.                           cut file is then fed into the current applications
  455.                           keyboard buffer, with an "Enter" simulated at the
  456.                           end of each line. If the disc cut file is empty or
  457.                           an error occurs during reading, a beep will be
  458.                           emitted and no action taken.
  459.  
  460.                           Note: You must release all keys of the Paste
  461.                                 command before pasting will begin.
  462. {newpage}
  463. {row}  20
  464.                               Configuring FastFlip
  465. {newpage} nofooter
  466. {section}
  467.  Configuring    The program FFSETUP.EXE is used to configure FastFlip. If
  468.     FastFlip    you run FFSETUP from a page in FastFlip (while it is
  469.                 loaded), the changes will not take effect until FastFlip has
  470.                 been unloaded and reloaded.
  471.  
  472.                     NOTE: Command line toggles will override any configured
  473.                           settings.
  474.  
  475.  
  476.                 After FFSETUP has been loaded, you will be presented with
  477.                 the following menu:
  478.  
  479. {shade}  725  975  700  660  10   ;row,col,rows,cols,%grey
  480.                                 ┌─────────────────────┐
  481.                                 │                     │
  482.                                 │ Startup Parameters  │
  483.                                 │ Application Page 1  │
  484.                                 │ Application Page 2  │
  485.                                 │ Application Page 3  │
  486.                                 │ Application Page 4  │
  487.                                 │ Application Page 5  │
  488.                                 │ Application Page 6  │
  489.                                 │ Application Page 7  │
  490.                                 │ Application Page 8  │
  491.                                 │ Application Page 9  │
  492.                                 │ Application Page 10 │
  493.                                 │                     │
  494.                                 └─────────────────────┘
  495.  
  496.  
  497.                 Select "Startup Parameters" to configure settings that
  498.                 affect all application pages (number of apps, swap drive,
  499.                 etc). Select "Application Page 1" through "Application Page
  500.                 10" to configure the appropriate application page.
  501. {newpage}
  502. {shade}  125  499  700  1648  10   ;row,col,rows,cols,%grey
  503.      Startup    ┌──────────────────────────────────────────────────────┐
  504.   Parameters    │                                                      │
  505.                 │             Menu Hotkey: LC-/                        │
  506.                 │              Cut Hotkey: LCS-C                       │
  507.                 │            Paste Hotkey: LCS-P                       │
  508.                 │         Prev App Hotkey: LCS-,                       │
  509.                 │         Next App Hotkey: LCS-.                       │
  510.                 │                                                      │
  511.                 │  Number of Applications:  3                          │
  512.                 │  Swap Drive (if needed): C   Alternate Drive: C      │
  513.                 │   Use EMS for swapping?: Y                           │
  514.                 │   Use XMS for swapping?: Y                           │
  515.                 │                                                      │
  516.                 │                                                      │
  517.                 └──────────────────────────────────────────────────────┘
  518.  
  519.                              Startup Parameters Edit Screen
  520.  
  521.  
  522.                      Menu   Sets the hotkey used to display the application
  523.                             menu. See "Hot Key" in "Application Page Edit
  524.                             Screen" for valid hot key specifiers.
  525.  
  526.                       Cut   Sets the hotkey used to activate the cut
  527.                             operation. See "Hot Key" in "Application Page
  528.                             Edit Screen" for valid hot key specifiers.
  529.  
  530.                     Paste   Sets the hotkey used to activate the paste
  531.                             operation. See "Hot Key" in "Application Page
  532.                             Edit Screen" for valid hot key specifiers.
  533.  
  534.                      Prev   Sets the hotkey used to swap to the previous
  535.                             application page. See "Hot Key" in "Application
  536.                             Page Edit Screen" for valid hot key specifiers.
  537.  
  538.                      Next   Sets the hotkey used to swap to the next
  539.                             application page. See "Hot Key" in "Application
  540.                             Page Edit Screen" for valid hot key specifiers.
  541.                             
  542.                    Number   Specifies the number of pages FastFlip will
  543.                             setup. The default is 3, and the maximum is 10.
  544.  
  545.                Swap Drive   The primary drive that FastFlip should use for
  546.                             swapping (if disc swapping is needed). If there
  547.                             is not enough free space on this drive, the
  548.                             Alternate swap drive will be attempted.
  549.  
  550.                 Alternate   If FastFlip needs to swap to the disc and the
  551.                             primary swap drive does not have enough free
  552.                             space to hold the swap file, the alternate drive
  553.                             will be used instead.
  554. {newpage}
  555.                   Use EMS   If this field is "Y", FastFlip will allow
  556.                             application pages to use EMS memory for
  557.                             swapping.
  558.  
  559.                             If this field is "N", FastFlip will not allow
  560.                             application pages to use EMS memory for
  561.                             swapping.
  562.  
  563.                   Use XMS   If this field is "Y", FastFlip will allow
  564.                             application pages to use XMS memory for
  565.                             swapping.
  566.  
  567.                             If this field is "N", FastFlip will not allow
  568.                             application pages to use XMS memory for
  569.                             swapping.
  570.  
  571.  
  572. {newpage}
  573. {shade}  110  499  700  1648  10   ;row,col,rows,cols,%grey
  574.  Application    ┌──────────────────────────────────────────────────────┐
  575.    Page 1-10    │                                                      │
  576.                 │     Page: 1                                          │
  577.                 │     Name: Dos Prompt                                 │
  578.                 │  Program:                                            │
  579.                 │  Chg Dir:                                            │
  580.                 │   Memory: 512                                        │
  581.                 │  Hot Key: LC-1                                       │
  582.                 │  Use EMS: Y                                          │
  583.                 │  Use XMS: Y                                          │
  584.                 │                                                      │
  585.                 │  Pause for command line options? (Y/N): N            │
  586.                 │                                                      │
  587.                 │                                                      │
  588.                 └──────────────────────────────────────────────────────┘
  589.  
  590.                              Application Page Edit Screen
  591.  
  592.  
  593.                      Page   The page number being edited. This is a display
  594.                             only field.
  595.  
  596.                      Name   The description of the program. This may be any
  597.                             text up to 25 characters.
  598.  
  599.                   Program   The DOS name of the program. If the program is a
  600.                             COM or EXE file, an extension is not needed. If
  601.                             the program is a BATCH file, then the ".BAT"
  602.                             extension *MUST* be included.
  603.  
  604.                             If the program is in your DOS PATH, then a path
  605.                             does not need to precede the DOS file name. If
  606.                             the program is NOT in your DOS PATH, then you
  607.                             must specify the path with the file name, or use
  608.                             the "Chg Dir" field below.
  609.  
  610.                             If you only want a DOS prompt, leave this field
  611.                             blank. A BATCH file will also return to the DOS
  612.                             prompt (unless an EXIT command is included).
  613.  
  614.                   Chg Dir   The path that FastFlip should change to when the
  615.                             program is started.
  616.  
  617.                    Memory   The amount of memory needed (in k) for this
  618.                             program.
  619.  
  620.                             NOTE: Memory size changes do not take effect
  621.                                   until FastFlip has been unloaded and
  622.                                   reloaded.
  623. {newpage}
  624.                   Hot Key   The HotKey that will be used to change to this
  625.                             page. A HotKey is selected by entering HotKey
  626.                             specifiers, followed by a dash ('-') and then
  627.                             the identifier key. Available HotKey specifiers
  628.                             are:
  629.  
  630.                                 L   Left
  631.                                 R   Right
  632.                                 A   Alt
  633.                                 C   Ctrl
  634.                                 S   Shift
  635.  
  636.                             HotKey specifiers may be combined in any manner,
  637.                             except 'L' and 'R' - these two specifiers are
  638.                             mutually exclusive.
  639.  
  640.                             A HotKey identifier is any single key. Function
  641.                             keys may be used as identifiers by using the key
  642.                             name (i.e. "F5").
  643.  
  644.                             Examples:
  645.                               LCS-1         Left-Ctrl-Shift-1
  646.                               RCS-1         Right-Ctrl-Shift-1
  647.                               LCA-1         Left-Ctrl-Alt-1
  648.                               LCAS-1        Left-Ctrl-Alt-Shift-1
  649.                               LC-F9         Left-Ctrl-F9
  650.                               RC-F11        Right-Ctrl-F11
  651.                               LCAS-F9       Left-Ctrl-Alt-Shift-F9
  652.                               RCS-Q         Right-Ctrl-Shift-Q
  653.  
  654.  
  655.                             NOTE: HotKey changes do not take effect until
  656.                                   FastFlip has been unloaded and reloaded.
  657.  
  658.                   Use EMS   If this field is "Y", FastFlip will attempt to
  659.                             use EMS memory for swapping this page. If EMS
  660.                             usage is turned off (via Startup Parameters),
  661.                             this field has no effect.
  662.  
  663.                             If this field is "N", FastFlip will not use EMS
  664.                             memory for swapping this page.
  665.  
  666.                   Use XMS   If this field is "Y", FastFlip will attempt to
  667.                             use XMS memory for swapping this page. If XMS
  668.                             usage is turned off (via Startup Parameters),
  669.                             this field has no effect.
  670.  
  671.                             If this field is "N", FastFlip will not use XMS
  672.                             memory for swapping this page.
  673.  
  674.                     Pause   If this field is "Y", FastFlip will pause for
  675.                             entry of any parameters to be passed to the
  676.                             program.
  677. {newpage}
  678. {row}  20
  679.                              Command Line Operation
  680. {newpage} nofooter
  681. {section}
  682.  
  683.      Command    The program FFCTL is provided to allow you to change
  684.                 FastFlip pages from a DOS batch file.
  685.  
  686.                 NOTE: This program provides other features, but are
  687.                       primarily designed as examples for programmer's
  688.                       using the FastFlip Programmer Interface.
  689.                       Therefor, these features are not discussed in
  690.                       this section.
  691.  
  692.                 To change a FastFlip page from DOS, type:
  693.  
  694.                         FFCTL -pX
  695.  
  696.                 where 'X' is the 1 based page number to switch to. For
  697.                 example, "FFCTL -p2" will cause FastFlip to change to
  698.                 page 2.
  699.  
  700. {newpage}
  701. {row}  20
  702.                            FastFlip Trouble Shooting
  703. {newpage} nofooter
  704. {section}
  705.         Huh?    Having trouble with FastFlip? Check the following list
  706.                 of questions and answers to see if that helps. If not,
  707.                 try re-reading the documentation - sometimes we have
  708.                 to read something a few times before the "light bulb"
  709.                 comes on. If this still doesn't help, please call our
  710.                 BBS for support. WE'll try to help you through your
  711.                 problem whether you're registered or not.
  712.  
  713.            Q    How do I shutdown a DOS page so that I may unload FastFlip.
  714.  
  715.            A    Change to the DOS page and enter "EXIT" followed by ENTER.
  716.  
  717.  
  718.  
  719.            Q    I can't get more than 3 pages to work.
  720.  
  721.            A    Run the setup program FFSETUP. Select "Startup Parameters"
  722.                 and change the "Number of Applications" field to the number
  723.                 of pages you wish to run.
  724.  
  725.  
  726.  
  727.            Q    I can't get more than 512k in a page.
  728.  
  729.            A    Run the setup program FFSETUP. Select the application page
  730.                 you wish to modify. In the "Memory" field enter the amount
  731.                 of memory for this page.
  732.  
  733.                 NOTE: If FastFlip is loaded when you change memory sizes,
  734.                       you must unload, then reload FastFlip for the changes
  735.                       to take effect.
  736.  
  737.  
  738.  
  739.            Q    I can't get DOS BAT files to run.
  740.  
  741.            A    You *MUST* include the ".BAT" extension when specifying the
  742.                 "Program" name for this page (see Section 2).
  743.  
  744.  
  745.  
  746.            Q    I get a "Program not found" message when I select page X.
  747.  
  748.           A1    The program name may be spelled incorrectly.
  749.           A2    The program may not be in your PATH (and no path specified
  750.                 with the program name).
  751.           A3    The PATH specified with the program name may be invalid.
  752.           A4    The PATH specified in "Chg Dir" may be invalid.
  753.  
  754. {newpage}
  755. {row}  20
  756.                          FastFlip Programmer Interface
  757. {newpage} nofooter
  758. {section}
  759.   Programmer    Your programs may communicate with FastFlip via the
  760.    Interface    Multiplex Interrupt (interrupt 0x2F). This interrupt is well
  761.                 defined and its usage is somewhat "standardized" amongst
  762.                 TSRs. For a detailed discussion of the Multiplex Interrupt
  763.                 see any one of the following: Microsoft Encyclopedia
  764.                 (M$Press), DOS Programmer's Reference (QUE) or MS-DOS
  765.                 Developer's Guide (Waite Group). I recommend all three.
  766.  
  767.                 A set of 'C' routines that can be used with your programs
  768.                 are contained in the file "FFLNK.C". The source is also
  769.                 provided for the utility program FFCTL - you may use this as
  770.                 an example program.
  771.                 
  772.                 ────────────────────────────────────────────────────────────
  773.                 Function: int ffLoaded(void);
  774.  
  775.                  Purpose: Check to see if FastFlip is loaded.
  776.  
  777.                    Input: none
  778.  
  779.                   Return: 0 = Not loaded.
  780.                           1 = Loaded.
  781.  
  782.                 ────────────────────────────────────────────────────────────
  783.                 Function: int ffGetMaxPage(void);
  784.  
  785.                  Purpose: Get the max number of pages available.
  786.  
  787.                    Input: none
  788.  
  789.                   Return: The number of DEFINED pages (not ACTIVE pages).
  790.  
  791.                 ────────────────────────────────────────────────────────────
  792.                 Function: int ffSetPage(int page)
  793.  
  794.                  Purpose: Set new active page.
  795.  
  796.                    Input: page: The 0 based page number to change to.
  797.  
  798.                   Return: 0 = Error
  799.                           1 = No Error
  800.  
  801.                 ────────────────────────────────────────────────────────────
  802.                 Function: void ffSetTimer(int clicks)
  803.  
  804.                  Purpose: Set FastFlip internal timer.
  805.  
  806.                    Input: clicks: The number of timer ticks to elapse before
  807.                                   FastFlip checks internal tables for
  808.                                   instructions.
  809.  
  810.                   Return: none
  811. {newpage}
  812.                 ────────────────────────────────────────────────────────────
  813.                 Function: void ffSetMem(int offset, void far *buf, int len)
  814.  
  815.                  Purpose: Copy data to the FastFlip common application
  816.                           memory area. NOTE: This area is 64 bytes in length
  817.                           (TOTAL, not per app) and YOU must verify that it
  818.                           is not overwritten.
  819.                           This function can be used to pass data between
  820.                           applications running under FastFlip.
  821.  
  822.                    Input: offset  The offset into the common memory to
  823.                                   begin write to.
  824.                           buf     Far pointer to data to write to the common
  825.                                   memory.
  826.                           len     The number of bytes to write to the common
  827.                                   memory.
  828.  
  829.                   Return: none
  830.  
  831.                 ────────────────────────────────────────────────────────────
  832.                 Function: void ffGetMem(int offset, void far *buf, int len)
  833.  
  834.                  Purpose: Copy data from the FastFlip common application
  835.                           memory area. NOTE: This area is 64 bytes in length
  836.                           (TOTAL, not per app).
  837.                           This function can be used to pass data between
  838.                           applications running under FastFlip.
  839.  
  840.                    Input: offset  The offset into the common memory to
  841.                                   begin read from.
  842.                           buf     Far pointer to receive buffer.
  843.                           len     The number of bytes to read from common
  844.                                   memory.
  845.  
  846.                   Return: none
  847. {newpage}
  848.                 ────────────────────────────────────────────────────────────
  849.                 Function: void ffSetLock(int state)
  850.  
  851.                  Purpose: This function allows you to "lock" or "unlock"
  852.                           FastFlip. When FastFlip is in a locked state, the
  853.                           user will NOT be able to perform ANY FastFlip
  854.                           actions. Note that even when FastFlip is in a
  855.                           locked state, your program can still perform all
  856.                           normal functions.
  857.  
  858.                           NOTE: It is VERY important to ALWAYS unlock
  859.                                 FastFlip after it has been locked. If your
  860.                                 program exits with FastFlip locked and other
  861.                                 pages are active, the user will not be able
  862.                                 to switch to other pages. If other pages
  863.                                 cannot be shutdown, the user cannot unload
  864.                                 FastFlip - they must reboot to clear memory.
  865.                                 Since this is not a desired action, it would
  866.                                 be a good idea to call an unlock function
  867.                                 with "atexit()". This will ensure that
  868.                                 FastFlip is unlocked when your program exits
  869.                                 (if FastFlip is not locked, the unlock
  870.                                 command is ignored).
  871.  
  872.                    Input: state   0 = Unlock FastFlip
  873.                                   1 = Lock FastFlip
  874.  
  875.                   Return: none
  876. {newpage}
  877. {row}  20
  878.                                 The Legal Stuff
  879. {newpage} nofooter
  880. {section}
  881.      License    This version of FastFlip is NOT public domain or free
  882.                 software, but is being distributed as "shareware".
  883.  
  884.                 Non-registered users of this software are granted a limited
  885.                 license to make an evaluation copy for trial use on a
  886.                 private, non-commercial basis, for the express purpose of
  887.                 determining whether FastFlip is suitable for their needs. At
  888.                 the end of this trial period, you should either register
  889.                 your copy or discontinue using FastFlip.
  890.  
  891.                 A FastFlip registration entitles you to use the program on
  892.                 any and all computers available to you, with the following
  893.                 restriction: If other people have access to this program or
  894.                 may use it, then you should purchase a site license.  See
  895.                 the following section for information about site licensing
  896.                 or quantity discounts.
  897.  
  898.                 All users are granted a limited license to copy FastFlip
  899.                 only for the trial use of others and subject to the above
  900.                 limitations. This license does NOT include distribution or
  901.                 copying of this software package:
  902.  
  903.                     1. In connection with any other product or service.
  904.                     2. For general use within a company or institution.
  905.                     3. For any consideration or 'disk fee'.
  906.                     4. For distribution in modified form; i.e., the file
  907.                        containing this license information MUST be included,
  908.                        along with the full FastFlip documentation.
  909.  
  910.  
  911.    Shareware    This shareware version of FastFlip has a 3 second delay when
  912.     Policies    started from DOS. Registered versions of FastFlip do not
  913.                 contain this screen. The registered and shareware versions
  914.                 are otherwise {i}IDENTICAL{n}.
  915.  
  916.  
  917.          BBS    Operators of electronic bulletin board systems (Sysops) are
  918.    Operators    encouraged to post FastFlip for downloading by their users,
  919.                 as long as the above conditions are met.
  920. {newpage}
  921.   Disclaimer    The software and accompanying written materials (including
  922.                 instructions for use) are provided "AS IS" without warranty
  923.                 of any kind. Further, Aquila Data Systems does not warrant,
  924.                 guarantee, or make any representations regarding the use, or
  925.                 the results of the use, of the software or written materials
  926.                 in terms of correctness, accuracy, reliability, currentness,
  927.                 or otherwise. The entire risk as to the result and
  928.                 performance of the software is assumed by you. If the
  929.                 software or written materials are defective you, and not
  930.                 Aquila Data Systems or its dealers, distributors, agents or
  931.                 employees, assume the entire cost of all necessary
  932.                 servicing, repair, or correction.
  933.  
  934.                 No warranties of any kind, either express or implied,
  935.                 including but not limited to the implied warranties of
  936.                 merchantability and fitness for a particular purpose, that
  937.                 are made by Aquila Data Systems on this Aquila Data Systems
  938.                 product. No oral or written information or advice given by
  939.                 Aquila Data Systems, its dealers, distributors, agents or
  940.                 employees shall create a warranty or in any way increase the
  941.                 scope of this warranty, and you may not rely on any such
  942.                 information or advice. This warranty gives you specific
  943.                 legal rights. You may have other legal rights, which vary
  944.                 from state to state.
  945.  
  946.                 Neither Aquila Data Systems nor anyone else who has been
  947.                 involved with the creation, production, or delivery of this
  948.                 product shall be liable for any direct, indirect,
  949.                 consequential, or incidental damages (including but not
  950.                 limited to damages for loss of business profits, business
  951.                 interruption, loss of business information, and the like)
  952.                 arising out of the use or inability to use such product even
  953.                 if Aquila Data Systems has been advised of the possibility
  954.                 of such damages. Because some states do not allow the
  955.                 exclusion or limitation of liability for consequential or
  956.                 incidental damages, the above limitation may not apply to
  957.                 you.
  958.  
  959.  
  960.   Trademarks    All trademarks and copyrights belong to their respective
  961.                 holders. Who else {i}would{n} they belong to anyway?
  962. {newpage}
  963. {row}  20
  964.                               Ordering Information
  965. {newpage} nofooter
  966. {section}
  967.     Ordering    A FastFlip registration licenses you to use the product on a
  968.  Information    regular basis. Registration includes notification of updates
  969.                 and technical support (via our support BBS).
  970.  
  971.                 Registering FastFlip costs $35. When received, we will send
  972.                 you an "unlock" code that will turn your current (and
  973.                 future) versions of FastFlip into a "registered" version. If
  974.                 you prefer, you may also receive this code via our support
  975.                 BBS.
  976.  
  977.                 A diskette with the latest version of FastFlip and printed
  978.                 documentation is also available for an additional $15.
  979.                 Florida residents should include 6% sales tax. Please use
  980.                 the form at the end of this document.
  981.  
  982.  
  983.     Upgrades    Updating to a newer version of FastFlip is currently free.
  984.                 We do not expect this policy to change in the future, but we
  985.                 reserve the right to do so. When you register, you will
  986.                 receive an unlock code that will brand the current and
  987.                 future versions of FastFlip with your name.
  988.  
  989.  
  990.       Orders    Please send a check drawn on a US bank in US dollars.  We
  991.      outside    can accept non-US currency; however, you must include an
  992.       the US    additional $15 to cover conversion and collection costs.
  993.                 Please include an additional $10 to cover postage on orders
  994.                 delivered outside of the US (if applicable).
  995.  
  996.    Corporate    All corporate, business, government or other commercial
  997.         Site    users of FastFlip must be registered.  We offer quantity
  998. Licenses and    discounts as well as site licensing.
  999.     Quantity
  1000.    Purchases    Corporate site licensing agreements allow duplication and
  1001.                 distribution of specific numbers of copies within the licensed
  1002.                 institution. Duplication of multiple copies is not allowed
  1003.                 except through execution of a licensing agreement. Site
  1004.                 license fees are based upon estimated number of users.
  1005.  
  1006.                 Please call or write for more information.
  1007.  
  1008.                 ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT
  1009.                 NOTICE. Discounts are not cumulative; they apply to single
  1010.                 orders of like products only. Unit prices are the same as
  1011.                 for individual users.
  1012.  
  1013.      WARNING    YOU MAY NOT USE FastFlip WITHIN YOUR ORGANIZATION WITHOUT A
  1014.                 PRIOR PURCHASE OR LICENSE ARRANGEMENT.
  1015. {newpage}
  1016.       How To    To register your copy of FastFlip, please fill out the
  1017.     Register    following form and send it along with a check or money
  1018.                 order.
  1019.  
  1020.                 Remit/Send To:  Aquila Data Systems, Inc.
  1021.                                 304 Bayfield Drive
  1022.                                 Brandon, FL  33511
  1023. {newpage} noheader
  1024.   ────────────────────────────────────────────────────────────────────────────
  1025.    FastFlip Order Form
  1026.   ────────────────────────────────────────────────────────────────────────────
  1027.  
  1028.        Name (to register to): ________________________________________________
  1029.  
  1030.           Address to ship to: ________________________________________________
  1031.  
  1032.                               ________________________________________________
  1033.  
  1034.                               ________________________________________________
  1035.  
  1036.                    Telephone: ________________________________________________
  1037.  
  1038.                         Date: __________________
  1039.  
  1040.  
  1041.   ────────────────────────────────────────────────────────────────────────────
  1042.    QUANTITY         DESCRIPTION                      UNIT PRICE          TOTAL
  1043.   ────────────────────────────────────────────────────────────────────────────
  1044.  
  1045.    ________         FastFlip                         US $ 35.00       ________
  1046.  
  1047.                                        Florida Residents add 6%       ________
  1048.  
  1049.                                                        Shipping          $1.50
  1050.  
  1051.                                             Additional Shipping       ________
  1052.  
  1053.                                                           Total       ________
  1054.  
  1055.                                Check/Money Order enclosed for US $ ___________
  1056.  
  1057.   ────────────────────────────────────────────────────────────────────────────
  1058.  
  1059.          Version Number of FastFlip: _________________________________________
  1060.  
  1061.                 Place obtained from: _________________________________________
  1062.  
  1063.                    Type of Computer: _________________________________________
  1064.  
  1065.            Type of Operating System: _________________________________________
  1066.  
  1067.          Type of video card/monitor: _________________________________________
  1068.  
  1069.  
  1070.                 Additional Comments: _________________________________________
  1071.  
  1072.       ________________________________________________________________________
  1073.  
  1074.       ________________________________________________________________________
  1075.  
  1076.       ________________________________________________________________________
  1077. {newpage} nofooter
  1078.