home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / SEL605.ZIP / SEL.MAN < prev    next >
Text File  |  1989-11-27  |  8KB  |  212 lines
  1.                      ▄▄▄▄  ▄   ▄   ▄  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄
  2.                      █  ▀  █   █   █  █                █  ▀
  3.                      █     █   █▄▄▄█  █▄▄▄  █▀▄▀█  █   █   
  4.                      █     █▄▄▄  █       █  █ █ █  █   █   
  5.                      █▄▄█  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄█  █ █ █  █   █▄▄█
  6.  
  7.                                         
  8.  
  9.               ┌─────────────────────────────────────────────────┐
  10.               │                                                 │
  11.               │       A N S I   C O L O R  /  P R O M P T       │
  12.               │                                                 │
  13.               │                 S E L E C T O R                 │
  14.               │                                                 │
  15.               │         f o r   D O S   a n d   O S / 2         │
  16.               │                                                 │
  17.               │             V e r s i o n   6 . 0 5             │
  18.               │                                                 │
  19.               └─────────────────────────────────────────────────┘
  20.  
  21.        Programs and Documentation are Copyright 1989 by clySmic soƒtware.
  22.                               All rights reserved.
  23.  
  24.      
  25.      SEL is an ANSI color selector for those who use any ANSI screen driver
  26.      (ANSI.SYS, NANSI.SYS, &c. under DOS; ANSI ON for OS/2).  SEL allows
  27.      easy color selection using mnemonics instead of numbers; has a random
  28.      color selection mode; and sets the prompt to a contrasting color.
  29.  
  30.      0. WHAT'S NEW IN VERSION 6.05
  31.  
  32.      This new version uses a slightly slower, but more "well-behaved"
  33.      technique for setting environment variables.  Otherwise, it works the
  34.      same as SEL 6.04.
  35.  
  36.      The program is now run from a .BAT or .CMD file (hereafter referred to
  37.      as a batch file).  Because of this change, if you invoke SEL inside
  38.      another batch file use CALL SEL, not just SEL, which won't return to
  39.      the first batch file.  Also, please remember to remove SEL.EXE (the
  40.      old, 6.04 version) from your path if you upgrade to this version.
  41.  
  42.      I. FILES
  43.  
  44.      SEL.BAT.............The batch file that runs SELPRG.EXE under DOS.
  45.  
  46.      SELPRG.EXE..........The SEL program for MS-DOS.
  47.  
  48.      SEL.CMD.............The command file that runs SELPRG2.EXE under OS/2.
  49.  
  50.      SELPRG2.EXE.........The SEL program for OS/2.
  51.  
  52.      To install, copy either SEL.BAT and SELPRG.EXE (for DOS users), or
  53.      SEL.CMD and SELPRG2.EXE (for OS/2 users) to a directory on your PATH.
  54.      To invoke, type SEL [parms], where [parms] are optional parameters.
  55.  
  56.      
  57.      II. PARAMETERS
  58.  
  59.      None................A randomly selected color scheme, including the
  60.                          prompt.
  61.  
  62.      /ƒ/ß/π..............Foreground color ƒ on background color ß with
  63.                          prompt color π.  Note that ANY of these parms can
  64.                          be dropped out, in which case the current color
  65.                          for that value is used.  For example, ///lm
  66.                          changes the prompt color to LightMagenta without
  67.                          disturbing the other colors.  A parameter of ///
  68.                          keeps the same colors as before (useful when
  69.                          changing the SELPROMPT, see below).
  70.  
  71.      /? or an error......A help screen summarizing your options and showing
  72.                          your current colors.
  73.  
  74.      
  75.      III. COLOR NAMES
  76.  
  77.      The colors have the following names:
  78.  
  79.      Parameter      Color
  80.      ------------------------------
  81.      k..............Black
  82.      b..............Blue
  83.      g..............Green
  84.      c..............Cyan
  85.      r..............Red
  86.      m..............Magenta
  87.      br.............Brown
  88.      w..............White
  89.      dg.............Dark Gray
  90.      lb.............Light Blue
  91.      lg.............Light Green
  92.      lc.............Light Cyan
  93.      lr.............Light Red
  94.      lm.............Light Magenta
  95.      y..............Yellow
  96.      lw.............Light White
  97.  
  98.      
  99.      IV. COLOR RULES
  100.  
  101.      Identical foreground/background or prompt/background colors are not
  102.      allowed.
  103.  
  104.      Dark Gray thru Light White cannot be used as background colors.
  105.  
  106.  
  107.      V. EXAMPLES
  108.  
  109.      sel /lm/b/w         LightMagenta on Blue with a White prompt.
  110.  
  111.      sel /y              Yellow foreground with the current background and
  112.                          prompt colors.
  113.  
  114.      sel ///br           Brown prompt and leaves other colors alone.
  115.  
  116.      sel //g             Green background and leaves other colors alone.
  117.  
  118.      
  119.      VI. SCREEN CLEARING
  120.  
  121.      Under MS-DOS, if you use a background color other than black, and have
  122.      certain kinds of TSRs loaded, a CLS won't fill the screen with the
  123.      background color.  This is actually an MS-DOS bug that has to do with
  124.      CLS' ANSI detection and interrupt hooking by TSRs.  I recommend using
  125.      CS.COM, a CLS replacement from PC Magazine instead of CLS.
  126.  
  127.  
  128.      VII. THE PROMPT
  129.  
  130.      SEL sets the prompt's color and its format.  The MS-DOS default is
  131.      $p$g which gives the current path and the > sign.  For example, if you
  132.      were in the \FUBAR directory on drive C: the prompt would be:
  133.  
  134.      C:\FUBAR>
  135.  
  136.      Even though this isn't MS-DOS' default, its very popular.
  137.  
  138.      Under OS/2 the default [$p] prompt is used.
  139.  
  140.      You can have SEL use ANY prompt you wish by setting the SELPROMPT
  141.      environment variable.  For instance, to have SEL use the boring old
  142.      regular MS-DOS prompt, enter the following DOS command:
  143.  
  144.      SET SELPROMPT=$n$g
  145.  
  146.      Another example:
  147.  
  148.      SET SELPROMPT=Yes, Master:
  149.  
  150.      To try out prompts without changing any colors, keep setting SELPROMPT
  151.      and then use SEL ///.
  152.  
  153.      To cause SEL to use its default prompt format again, remove the
  154.      variable like so:
  155.  
  156.      SET SELPROMPT=
  157.  
  158.      and run SEL ///.
  159.  
  160.      Consult your MS-DOS or OS/2 manual for more information on special
  161.      characters you can use in the prompt.
  162.  
  163.      
  164.      VIII. TECH STUFF
  165.  
  166.      SEL uses an environment variable called SELCOLOR to "remember" the
  167.      current colors as the ANSI driver doesn't do this.
  168.  
  169.      SEL.BAT runs SELPRG.EXE, the main program, which creates and executes
  170.      SELSET.BAT (or .CMD) in the same directory as SELPRG.EXE each time SEL
  171.      is run.  SELSET.BAT/.CMD is the batch file used to change the PROMPT
  172.      and SELCOLOR environment variables.  This method is more compatible
  173.      than version 6.04's method of altering the environment.  This is also
  174.      the only method that would work under OS/2.
  175.  
  176.      Since the SELSET.BAT/.CMD file remains in the directory when you
  177.      power-off, if you put SEL /// in your AUTOEXEC.BAT (or in your Full
  178.      Screen startup file under OS/2) you will always get the last colors
  179.      you set before powering off.
  180.  
  181.      Under MS-DOS its possible to run out of room in the environment.  If
  182.      this happens, consult your MS-DOS manual for the command to give
  183.      yourself more environment space (it varies from version to version).
  184.  
  185.      SEL was tested under MS-DOS versions 3.31 and 4.01, and OS/2 1.2.
  186.  
  187.                                         
  188.  
  189.      SEL is copyrighted by clySmic soƒtware, and is released as Freeware.
  190.      However, a small (say $5) donation would be appreciated if you find
  191.      SEL useful.
  192.  
  193.      You may copy the program and distribute it without charge.  You may
  194.      not sell or otherwise charge for SEL.  However, users' groups may
  195.      charge a small fee (not to exceed $7) for media and postage.
  196.  
  197.      This program is provided AS IS without any warranty, expressed or
  198.      implied, including but not limited to fitness for a particular
  199.      purpose.  So there.
  200.  
  201.      clySmic soƒtware is not responsible for anything that may happen when
  202.      you use SEL, including hardware damage, information loss, or time
  203.      warps.
  204.  
  205.                                 Ralph B Smith Jr
  206.                                 clySmic soƒtware
  207.                                  P. O. Box 2271
  208.                                Empire State Plaza
  209.                                 Albany, NY 12220
  210.  
  211.                               CompuServe 76156,164
  212.