home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / utils1 / clipboot.arj / README.DOC < prev    next >
Text File  |  1993-05-04  |  9KB  |  173 lines
  1.  
  2.                                    ClipBoot 
  3.                                  Version 1.00
  4.                              By Kevin S. Gallagher
  5.  
  6.    ClipBoot is a utility that allows you to change your Autoexec.bat and
  7.    Config.sys files and optionally reboot your computer.  It can be
  8.    operated either by command line or through the pop-up menu and editor.
  9.    Its purpose is to allow editing and swapping of the Autoexec.bat and
  10.    Config.sys files for individuals who utilize either multiple operating
  11.    systems or unique equipment that need different and perhaps
  12.    incompatible device drivers loaded at boot-up. Since DOS will allocate 
  13.    a minimum of 2 to 4K cluster (depending on version) for each file, 
  14.    regardless of how small it might be, it is wasteful to have several
  15.    small files in the root directory waiting to be renamed.  It is also
  16.    time consuming to edit then save and finally reboot your system.
  17.    With ClipBoot, all of these tasks have been combined into one seemingly
  18.    program.
  19.  
  20.  
  21.                                  OPERATION
  22.  
  23.    Command Line Parameters:
  24.   
  25.    [Pseudoname] - A pseudoname is the descriptive name you provide for a 
  26.    set of Autoexec.bat and Config.sys files.  ClipBoot will search the 
  27.    Qboot.dat file for this name, write the corresponding files to the root
  28.    directory of you C drive and reboot the computer. ClipBoot uses a pure 
  29.    ascii file called Qboot.dat where it writes all of the descriptions and
  30.    corresponding data lines used by the program.  When started, ClipBoot
  31.    will look for this file first in the default directory, (the one you
  32.    are in), next it looks in the environment for the variable
  33.    "QBOOT = [path]" don't forget to end the path with "\"; and finally it
  34.    looks in the root directory of the C drive.  This way you can have
  35.    more than one Qboot.dat file if you wish, and can plan its operation
  36.    accordingly.  If ClipBoot can NOT find this file, it will ask you if you
  37.    want to create a new QBOOT.Dat file. Answering Yes will take you into
  38.    the Edit Pseudoname screen and then to the editor, No will exit the
  39.    program.  The new Qboot.dat file will be created in the root directory
  40.    of your C drive.
  41.  
  42.    MENU/EDIT MODE
  43.    If Q-Boot is started without any command line parameters, the Menu will
  44.    appear with the Pseudonames appearing in a scrollable menu in the center
  45.    of the screen.  A full line seperate description is displayed on the
  46.    bottom of the screen, and the active function/editing keys displayed on
  47.    line 24.  ClipBoot checks your environment for QBOOTCON, this helps you 
  48.    to remember what configuration you "current" have loaded.  To use this 
  49.    environment variable, place the following line in each of your
  50.    Autoexec.bat files:   QBOOTCON=[name]  where name is the word or words 
  51.    describing this configuration.  If this environment variable is NOT 
  52.    found, ClipBoot displays "Not Entered".  For those not familiar with
  53.    environment variables, I strongly suggest you check your DOS manual as
  54.    more and more programs make use of this area and it can make your life 
  55.    much easier.
  56.  
  57.    The active keys are:
  58.    Enter  - to edit the Autoexec and Config files associated with that
  59.             Pseudoname.  You can also change the name and description.
  60.    Insert - to create a NEW Pseudoname and corresponding files.
  61.    Delete - to delete the highlighted selection.
  62.    F3     - Go to the Environment Editor.
  63.    F10    - Select this PseudoName and Reboot (You will be prompted first)
  64.    Esc    - Abort, return to DOS without booting or making any changes.
  65.  
  66.    If you choose Insert or Enter, you will be taken to the second screen
  67.    where you enter/change the Pseudoname and its full description. The
  68.    only keys active in this screen are the enter and arrow keys.  Pressing
  69.    enter on the Long description field takes you into the editor. The only
  70.    restrictions other than the obvious one of length is you MUST NOT use
  71.    the numbers 1 or 2 as the FIRST character in either the PseudoName or
  72.    its description or any of the lines in your Autoexec.bat or Config.sys
  73.    files. If you do,ClipBoot will NOT be able to accurately read your data
  74.    file.  To read in the EXISTING Autoexec and Config files, press F10.
  75.    This is the simplest way to create a new set of files, especially if
  76.    you are only changing a few Parameters.  If you have Manifest from
  77.    QuarterDeck Office Systems, then this feature will save you a lot of
  78.    typing after using OPTIMIZE to help you set up your files for the
  79.    different configurations.
  80.  
  81.    It is here you can create/edit you Autoexec.bat and Config.sys files.
  82.  
  83.    NOTE: 
  84.    These files are swapped as a pair. If you leave one blank and save it, 
  85.    then when this PseudoName is chosen, whichever file you left blank will 
  86.    be written to disk as an empty file.
  87.  
  88.    The editor is a simple memoedit that when pressing [F2] will save the
  89.    current files, or [ESC] to abort saves. Pressing [F10] toggles the
  90.    two files.
  91.  
  92.    Environment Editor
  93.    From the main menu press [F3]
  94.    Since this program is not meant for novices, I will not try and give
  95.    an explanation of the Enviroment table or its uses. This feature loads 
  96.    your current table into the editor and displays it for you to modify.
  97.    Once you have made any changes needed, press F10 and the program will
  98.    make changes if there are any to make. The [ESC] key aborts edits.
  99.  
  100.    ONE FINAL WORD OF WARNING...
  101.    DO NOT use the Numbers 1 or 2 as the FIRST character of ANY LINE.
  102.    If you do, I can GUARANTEE ClipBoot will NOT work properly.
  103.  
  104.  
  105.    CREDITS:
  106.    ClipBoot was designed from another utility called Q-BOOT, which is why
  107.    the configuration file is called QBoot.dat
  108.    ClipBoot and QBoot both can work with QBoot.dat and the two (2) strings
  109.    QBOOTCON and QBOOT
  110.  
  111.    Q-Boot was created in Quick basic, sometime around 1989 and works fine
  112.    except that after using the Environment editor Brief The Programmers
  113.    editor fails to work properly. Also Q-Boot has problems MS-Windows 3.1
  114.    smartDrv.exe - it does not write/swap files to disk, which I have
  115.    confirmed on (3) other systems. ClipBoot seems to work OKay, and if
  116.    you have any problems with it, I'd suggest changing the INKEY(n) value
  117.    from 1 to a higher number (increment by .25) until files write to disk.
  118.    This allows buffers to be written to disk, which is most likely the
  119.    source of the problem to why files do not get written to disk...
  120.  
  121.  
  122.    HOW TO MAKE CLIPBOOT:
  123.  
  124.    I have gotten into the habit of setting up projects a little different
  125.    than the methods used by many other programmers.  So you will need to
  126.    some pre work to utilize my "makefile".
  127.  
  128.    The following is an example to follow for storing files in a project
  129.    directory:
  130.  
  131.     1. MD C:\CLIPPROJ
  132.     2. MD C:\CLIPPROJ\INCLUDE
  133.     3. MD C:\CLIPPROJ\OBJ
  134.     4. MD C:\CLIPPROJ\SOURCE
  135.     5. MD C:\CLIPPROJ\LIB
  136.     6. Copy the ".prg" and ".c" files into c:\clipproj\source directory
  137.     7. Copy all header files ".h", into c:\clipproj\include directory
  138.     8. Copy the one (1) ".obj" files into c:\clipproj\obj directory
  139.     9. Copy the one (1) ".lib" file into c:\clipproj\lib directory
  140.    10. The makefile and linkfile should reside in c:\clipproj directory
  141.    11. Get out your programmers editor and edit all paths in the makefile
  142.        and linkfile, to point to your directories that you have the above
  143.        files (as per steps 1-5) in.
  144.    12. If you are not using Blinker 2.01, then you will need to tweak the
  145.        link script for your linker. 
  146.    13. If you do not have a copy of Don Caton's Clipwarn.exe, replace the
  147.        utility with "Clipper", and remove from the RMake file -
  148.        the last two parameters in the FLAG macro "/log /beep"
  149.    14. Use RMake to create ClipBoot
  150.    
  151.    NOTE: I have included a sample QBoot.dat file as an example.
  152.  
  153.    *--------------------------------------------------------------------*
  154.    | ClipBoot                                                           |
  155.    | Requirements:                                                      |
  156.    | CA-Clipper version 5.2                                             |
  157.    | nanfor.lib version 2.1                                             |
  158.    |                                                                    |
  159.    | The default linker is Blinker version 2.01                         |
  160.    | There is a command line in the makefile that reads:                |
  161.    | Lzexe ClipBoot                                                     |
  162.    |                                                                    |
  163.    | This is for compressing the final .exe, and works with either      |
  164.    | Warplink or Blinker 2.01, it is not required to do this. Note      |
  165.    | PKlite.exe does the same job.                                      |
  166.    |                                                                    |
  167.    | I use an interface to CA-Clipper called Clipwarn by Don Caton and  |
  168.    | if you do not have it, remove Clipwarn and insert Clipper.exe  in  |
  169.    | place of Clipwarn - also remove the last two (2) parameters in the |
  170.    | flags for compiling.                                               |
  171.    *--------------------------------------------------------------------*
  172.  
  173.