home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / mayflower.lha / MayFlower / PutCLI / PutCLI.doc < prev    next >
Encoding:
Text File  |  1994-06-10  |  5.1 KB  |  121 lines
  1.                                                      --- ---
  2.                         PutCLI 4.0 (19940310)        (o) (o)
  3.                                                         ^
  4.                        by Stephen D. Childers        \_____/
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7. Program Description:
  8.  
  9.    1) PutCLI will let you move or size an active CLI window on the
  10.       screen without using your mouse.
  11.  
  12.       PutCLI recognizes window/screen limits and will make every effort
  13.       to keep your CLI window inside screen boundaries regardless of
  14.       the argument values passed to it.
  15.  
  16.    2) Can only be used from CLI. Can be made resident.
  17.  
  18.    3) Program (when run from CLI) will interact with the 'c:Why' command
  19.       after program failures; this command may provide a more detailed
  20.       explanation of why the program failed.
  21.  
  22.       The 'Why' command should be used immediately after a program
  23.       failure to extract the last program's result code, because
  24.       that result code is changed upon the execution of the next CLI
  25.       command.
  26.  
  27.    4) Certain error reports will contain the name of the argument, file,
  28.       device, (etc) that is associated with failure when it occurs.
  29.  
  30. Program Note:
  31.  
  32.    1) This version of PutCLI will move or size the ACTIVE window.
  33.  
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35. CLI Usages:
  36.  
  37.    There are two modes of usage.
  38.  
  39.    Usage 1> PutCLI S|BS|FS <LeftEdge/TopEdge/Width/Height>
  40.  
  41.       S = Option for (S)izing the CLI window to new position/dimension.
  42.           Sizing parameters must be given after option.
  43.  
  44.       The sizing parameters for the new position/dimension must be given
  45.       in the following decimal format order:
  46.  
  47.           LeftEdge/TopEdge/Width/Height
  48.  
  49.       PutCLI will attempt to position and size the window to the decimal
  50.       values you provide with the above format. The window can not be
  51.       placed outside the borders of the screen; PutCLI will do the best
  52.       it can with the values you provide.
  53.  
  54.       B = Option for placing window behind others.
  55.       F = Option for placing window in front of others.
  56.  
  57.       Try the following examples:
  58.  
  59.          > PutCLI S 0/12/640/100    ; a normal CLI
  60.          > PutCLI S ///             ; set window to MINIMUM defaults
  61.          > PutCLI S 1000/2000/3000/4000   ; abnormal values
  62.          > PutCLI BS 0/12/640/100   ; resize window & place behind others
  63.  
  64.    Usage 2> PutCLI [B|F] [U|D[delta]] [L|R[delta]]
  65.  
  66.       This mode of usage is for moving, but with this mode you have the
  67.       option of specifying how far to move the window by providing
  68.       decimal values for the <delta>.
  69.  
  70.       If no <delta> is given then the window will jump all the way in
  71.       the direction you specify. The directions flags are:
  72.  
  73.             U for UP, D for DOWN, L for LEFT, R for RIGHT
  74.  
  75.       Try the following examples on a small CLI window in the center of
  76.       your screen:
  77.  
  78.          > PutCLI S 150/80/350/60 ; puts window in center of screen
  79.          > PutCLI U40 L70    ; up 40 left 70
  80.          > PutCLI F R        ; put window up front & all the way right
  81.          > PutCLI D          ; all the way down
  82.          > PutCLI B L U      ; put window in back & all the way left
  83.  
  84. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  85. Version History:
  86.  
  87.    The following information briefly describes changes or improvements
  88.    made to each version, and they will be described in descending order;
  89.    meaning latest version information begins first:
  90.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  91.    Version 4.0 (19940310) -
  92.    1) Changed version numbering format. Program can now be used with the
  93.       "Version" command. Date within parenthesis is shown in a somewhat
  94.       international format as (yyyymmdd).
  95.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  96.    Version 19930802 -
  97.    1) Optimized and refined source code thereby making program smaller.
  98.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  99.    Version 19920108 -
  100.    1) Removed a CLI parsing problem.
  101.    2) Added new options -b & -f.
  102.    3) Modified CLI argument format.
  103.    4) Can be made resident.
  104.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  105.    Version 19910920 - The first version.
  106.  
  107. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  108.        __   __   __   __   __   __   __   __   __   __   __   __
  109.      /X__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__X\
  110.     //                                                           \\
  111.    //     7   For we brought nothing into this world, and it is   \\
  112.   (/   certain we can carry nothing out.                           \)
  113.   ()                                                               ()
  114.   (\                    Our Redeemer's Bible - 1st Timothy 6:7     /)
  115.    \\                          (King James by the way)            //
  116.     \\ __   __   __   __   __   __   __   __   __   __   __   __ //
  117.      \X__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__>-<__X/
  118.  
  119. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  120.                               End Of Document
  121.