home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ENVEDIT1.ZIP / ENVEDIT.DOC < prev   
Text File  |  1990-10-14  |  8KB  |  178 lines
  1.  
  2.                                                                    10/15/90
  3.                                                                 Page 1 of 3
  4.                            OS/2 ENVIRONMENT EDITOR
  5.  
  6.         OVERVIEW
  7.  
  8.         ENVEDIT allows you to view and  modify  the  Environment  variables 
  9.         (entries)  in OS/2.  The program is for use when you need to change 
  10.         one or more of your environment entries and don't want  to  re-type 
  11.         them  from  the  command line.  ENVEDIT is fast and easy to use and 
  12.         runs as an OS/2 Full Screen application. 
  13.  
  14.         ENVEDIT reads all modifiable  OS/2  environment  entries  from  the 
  15.         session  the  program was run in,  then produces a Selector ListBox 
  16.         with all of the Entry names and an Edit/View Box to modify or  view 
  17.         an  entry.  Cursor  keys  are  used  to  move the selector,  as the 
  18.         selector is moved entries are  highlighted  and  the  corresponding 
  19.         definition  is  displayed.  Entries  are  selected  for  editing by 
  20.         pressing the Enter key while the entry is highlighted. 
  21.  
  22.         Once in the editor, the entry may be modified.  ENVEDIT has a built 
  23.         in editor that supports the cursor keys,  Insert Mode,  Delete, and 
  24.         Destructive Backspace.  To accept the changes,  press enter and the 
  25.         control returns to the ListBox. 
  26.  
  27.         ENVEDIT  makes  the  actual  changes to the environment after it is 
  28.         terminated. This is so the changes stick, that is to say, while the 
  29.         program is running any changes to the environment would apply  only 
  30.         to  the  shell that the program was running in and when the program 
  31.         ends so does the shell and the modified environment. 
  32.  
  33.         ENVEDIT produces a temporary command file that it calls  after  the 
  34.         environment editor has been run. The command file contains the OS/2 
  35.         SET  commands  necessary  to  make the requested changes.  Once the 
  36.         temporary file is run,  it's deleted and the process  completed  by 
  37.         running SET so you can verify the changes. 
  38.  
  39.         INSTALLATION
  40.  
  41.         1. Copy ENVEDIT.CMD & ENV.EXE to a sub-dir in your path.
  42.  
  43.            ie. C:\COPY A:\ENV.EXE C:\OS2
  44.                C:\COPY A:\ENVEDIT.CMD C:\OS2
  45.  
  46.         2. That's it unless you want to hook it into a Group Menu.  In this 
  47.            case  the  files  may  reside anywhere,  just make sure that the 
  48.            Working Directory in  'Properties'  is  set  to  the  drive  and 
  49.            sub-dir that has ENV.EXE. 
  50.  
  51.  
  52.         Note : The program creates a temporary file called  !TMP!--!.CMD in 
  53.                the 'C:' root directory.  The file is automatically  created 
  54.                and deleted by ENVEDIT.CMD. Obviously, if you have a file by 
  55.                that   name   you'll   want  to  rename  it  before  running 
  56.                ENVEDIT.CMD or ENV.EXE. 
  57.  
  58.                              ALL RIGHTS RESERVED (C) 1990 - CWJ
  59.  
  60.                                                                    10/15/90
  61.                                                                 Page 2 of 3
  62.                            OS/2 ENVIRONMENT EDITOR
  63.  
  64.         OPERATION
  65.  
  66.         To run ENVEDIT enter ENVEDIT on the command line or select from
  67.         Group menu.
  68.  
  69.         ie. D:\ENVEDIT <enter>
  70.  
  71.         Selector Menu Operation
  72.  
  73.         The program starts by showing you all of the Entries available  for 
  74.         editing.  The  first  entry will be highlighted and it's definition 
  75.         displayed in the Edit/View Box. 
  76.  
  77.           1. Use the Cursor arrows,  home & end  to highlight the entry you 
  78.              want  to change.  As you move the selector,  the definition in 
  79.              the Edit/View Box will change to allow you  to  see  what  the 
  80.              highlighted entry definition is. 
  81.  
  82.           2. Once the entry you want to modify is highlighted, press ENTER. 
  83.              At  this  point the cursor will be positioned in the Edit/View 
  84.              box on the first character of the definition. 
  85.  
  86.           3. Use editor features to modify the definition.
  87.              (See list below.)
  88.  
  89.           4. To accept the changes, press  ENTER and control will return to 
  90.              the Selection Menu. 
  91.  
  92.              To reject the changes, press Escape, control returns to the
  93.              Selection Menu.
  94.  
  95.           5. To Quit, press Escape.
  96.                 If you accepted the changes in Step 4. ENVEDIT will ask if
  97.                 you want to make the changes to the environment.
  98.  
  99.                 Press - 'Y' to make the changes, 'N' to ignore changes.
  100.  
  101.           6. If changes were made, a message is displayed and SET is run.
  102.              If no changes were made a message is displayed.
  103.  
  104.           USAGE NOTES
  105.  
  106.           Although  ENVEDIT  was not intended for adding new entries, using 
  107.           SET from the command line is typically easier,  it can be done in 
  108.           the  edit box by overwritting the 'ENTRY=' portion and adding the 
  109.           definition you need. 
  110.  
  111.           ENV.EXE may be called directly from the command  line  to  create 
  112.           the  temporary  command file,  without running it or deleting it. 
  113.           This can be useful if you want  to  keep  the  command  file  for 
  114.           future  use.  Remember  to  rename  it  to  something  other than 
  115.           !TMP!--!.CMD or it will be erased the next time ENVEDIT is run. 
  116.  
  117.                              ALL RIGHTS RESERVED (C) 1990 - CWJ
  118.  
  119.                                                                    10/15/90
  120.                                                                 Page 3 of 3
  121.                            OS/2 ENVIRONMENT EDITOR
  122.  
  123.         EDITOR COMMANDS
  124.  
  125.  
  126.         Enter -         Accept any changes made and return to the Selection
  127.                         Menu.  The program does not determine  if  anything 
  128.                         was actually changed, pressing enter signifies that 
  129.                         changes  may  have been made and you'll be prompted 
  130.                         on exiting to see if you want the changes applied. 
  131.  
  132.         Escape      -   Ignores any changes made to the  current definition
  133.                         and returns control  to  the  Selection  Menu.  The 
  134.                         definition  display is also restored.
  135.  
  136.         Cursor Keys -   UP/DOWN/LEFT/RIGHT move cursor 1 position in the
  137.                         direction indicated.
  138.  
  139.                         HOME/END goes to the first or last character.
  140.                         CONTROL-END goes to the end of the current line.
  141.  
  142.         Delete Key  -   Deletes the character under cursor and drags the
  143.                         remainder of the line one position to the left.
  144.  
  145.         Insert Key  -   Toggles Insert mode on and off. If Insert is On
  146.                         the cursor will grow to half a character, if it's
  147.                         Off the cursor will sit just under the character.
  148.  
  149.                         With Insert On, characters typed are inserted to
  150.                         the right of the cursor position and the remainder
  151.                         of the line is moved to the right one position.
  152.                         The cursor does not move during insert.
  153.  
  154.                         Insert Off is Overstrike, characters typed replace
  155.                         the characters at the cursor position. Cursor 
  156.                         advances one position per character typed.
  157.  
  158.          LICENSE   -    ENVEDIT.CMD & ENV.EXE may be used and distributed
  159.                         at no cost for non-commerical purposes.
  160.  
  161.                         Commericial Use :  $10.00/Copy.
  162.                                           $100.00 Unlimited Internal Use.
  163.  
  164.                         Send Check to : Bill James
  165.                                         13540 Hubbard #33
  166.                                         Sylmar, CA 91342
  167.  
  168.                         EXPRESS WRITTEN PERMISSION REQUIRED FOR COMMERCIAL
  169.                         DISTRIBUTION IN ANY FORM. THIS INCLUDES BUT IS NOT
  170.                         LIMITED TO THE FOLLOWING : Distribution in package,
  171.                         Distribution for ANY FEE including shipping, and
  172.                         media cost.
  173.  
  174.  
  175.  
  176.                              ALL RIGHTS RESERVED (C) 1990 - CWJ
  177.  
  178.