home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dirutl / cdir130.arc / CDIR.DOC next >
Encoding:
Text File  |  1989-02-11  |  10.4 KB  |  279 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                              CDir (Change Directory)
  29.                                   Version 1.30
  30.                                     11 Feb 89
  31.  
  32.                                Copyright (C) 1989
  33.                                    Chris Brown
  34.  
  35.  
  36.  
  37.                                    DESCRIPTION
  38.  
  39.              Cdir (stands for Change Directory) is a program that  allows
  40.         you to change to a directory prior to invoking a program.  It  is
  41.         primarily  used  in  batch files, which are  usually  created  by
  42.                                    1                     2
  43.         programs such as "Automenu"  and "Hard Disk Menu" .
  44.  
  45.              The advantage of using a program such as this "between"  the
  46.         menu  and the main program is that you don't have to have a  menu
  47.         entry on every directory you ever wish to use.  Some programs let
  48.         you change directories once it is loaded, but so far, this is the
  49.         easiest  way I have seen!  In addition, this program  will  allow
  50.         you to create and delete directories.
  51.  
  52.  
  53.                                  JUST SOME STUFF
  54.                                  ---------------
  55.              Cdir was written in Turbo Pascal 5.  It was tested using DOS
  56.         3.2  and  3.3.  As I no longer have a desire to use  any  earlier
  57.         versions  of  DOS,  I can't tell you if it  will  work  on  those
  58.         earlier versions.
  59.  
  60.              As  far as the colors go, I'm sorry if you don't like  them.
  61.         Since  the  main  purpose of the program is  to  precede  another
  62.         program,  it  isn't  in use for very long.  Because  of  that,  I
  63.         couldn't  see making an elaborate installation program for  some-
  64.         thing  like  color preferences.  If you really  can't  stand  the
  65.         colors,  let me know and I will change them.  If you really  want
  66.         to be bold, you could let me know what colors you think  everyone
  67.         would like.
  68.  
  69.              I  don't  know how this program will look  on  a  monochrome
  70.         system (I don't have access to one).  If it seems that the colors
  71.         need  to  be changed for monochrome, I will put a routine  in  to
  72.         check for that.  Just remember, I won't know unless I am told!
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.         --------------------
  89.  
  90.         1. AUTOMENU is a Trademark of Magee Enterprises.
  91.  
  92.         2. The HARD DISK MENU System and HDM are trademarks of Jim Hass.
  93.  
  94.  
  95.                               CDir, v1.30 - Page: 1
  96.  
  97.  
  98.  
  99.                                     SPECIFICS
  100.                                     ---------
  101.              As  I  mentioned earlier, Cdir is designed to be used  in  a
  102.         batch  file.   The  batch file is what will  decided  whether  to
  103.         continue  on to the main file or abort back to the menu (or  DOS).
  104.         This batch file will look something like this:
  105.  
  106.         @Echo off
  107.         Cdir F:\Wordstar
  108.         If ErrorLevel 1 goto Next
  109.         D:\Ws5\Ws
  110.         :Next
  111.  
  112.              The  ErrorLevel statement is there in case you press  escape
  113.         while  in  Cdir.  This is so it will not load  the  next  program
  114.         (Wordstar in this case) and will continue on to the next function
  115.         such as returning to the menu program (for which this program was
  116.         designed).
  117.  
  118.              If  you  wanted  to keep reloading Cdir  to  choose  another
  119.         directory  and  then  load your main program,  you  have  to  put
  120.         another label and another goto statement in:
  121.  
  122.         @Echo off
  123.         :Again
  124.         Cdir F:\Wordstar
  125.         If ErrorLevel 1 goto Next
  126.         D:\Ws5\Ws
  127.         Goto Again
  128.         :Next
  129.  
  130.         As  mentioned,  this example will keep reloading  Cdir  and  then
  131.         Wordstar until escape is pressed from within Cdir.  It then  will
  132.         return to whatever (your menu or DOS).
  133.  
  134.  
  135.                                     OPERATION
  136.                                     ---------
  137.              The  basic operation of Cdir is to highlight  the  directory
  138.         you want to change to, and press Enter.  Cdir will return control
  139.         back to the batch file, and your program will load with the  dir-
  140.         ectory you chose as being the current logged drive\directory.
  141.  
  142.              All of the operational keys for the program are  highlighted
  143.         on the screen.  They really don't need too much of an explanation
  144.         but here it is anyway:
  145.  
  146.  
  147.                              ^,v,PgUp,PgDn,Home,End
  148.                              ----------------------
  149.         Moves  the  highlight  bar up and down.   Hitting  enter  with  a
  150.         directory highlighted will cause Cdir to change to that directory
  151.         and then exit.
  152.  
  153.  
  154.  
  155.  
  156.                               CDir, v1.30 - Page: 2
  157.  
  158.  
  159.  
  160.                                       ENTER
  161.                                       -----
  162.         Press the ENTER key when you highlight the directory you wish DOS
  163.         to  be logged to.  This will continue the execution of the  batch
  164.         file.
  165.  
  166.  
  167.                                      ESCape
  168.                                      ------
  169.         Pressing ESC will abort the function of Cdir.  It will not change
  170.         the current directory in DOS and if the batch file is setup  like
  171.         the example, it will not load the next program.  Instead, it will
  172.         skip  over that statement, and return control to whatever  called
  173.         the batch file.
  174.  
  175.  
  176.                                M - Make Directory
  177.                                ------------------
  178.         This  will make a directory under the current  logged  directory.
  179.         The current logged directory is always displayed at the top  left
  180.         corner  of  the screen.  Pressing "M" DOES NOT make  a  directory
  181.         under  the  highlighted directory.  Cdir will prompt  you  for  a
  182.         directory  name  near the bottom of the screen.   ESCape  can  be
  183.         pressed  to abort this function.  Active editing keys are:   Left
  184.         Arrow  and Backspace deletes the character to the left, and  Con-
  185.         trol Y (^Y) deletes the entire input line.
  186.  
  187.  
  188.                               R - Remove Directory
  189.                               --------------------
  190.         Pressing "R" will remove the highlighted directory.  It will  not
  191.         remove the directory if:
  192.           o There are files in that directory.
  193.           o There are more directories in that directory.
  194.           o If the highlighted directory is also the current directory in
  195.             DOS.
  196.         Before  removing the directory, Cdir asks for conformation as  to
  197.         whether or not you really want to do this.  Answer Y, N, or ESC.
  198.  
  199.  
  200.                               C - Change Directory
  201.                               --------------------
  202.         This will change to the directory that is highlighted, and reread
  203.         it's contents and display any directories that it finds.  Anytime
  204.         you are not a the root level of a directory, the first  directory
  205.         listed in Cdir is >Previous<.  The purpose of this is so you  can
  206.         go through the entire directory structure simply by  highlighting
  207.         the directory and pressing "C".
  208.  
  209.  
  210.                                   REGISTRATION
  211.                                   ------------
  212.              Cdir  is distributed under the ShareWare concept.   You  are
  213.         granted the right to use it for a few weeks (a few means 2) at no
  214.         charge.   If you find that after that time, you are  still  using
  215.  
  216.  
  217.                               CDir, v1.30 - Page: 3
  218.  
  219.  
  220.  
  221.         it, you will be required to register it.  And registration is  so
  222.         simple:  all you have to do is write me a check for $5.00.   Next
  223.         to the word MEMO on your check, write "CDir, Version 1.30".  Make
  224.         sure you name and address are correct on the check.  If I write a
  225.         major update (the first number to the left of the decimal point),
  226.         or  I  find  a major bug (the first number to the  right  of  the
  227.         decimal point) or the version you have is older than the  current
  228.         one  I am distributing, I will send you an update to the  address
  229.         on  the  check, for free!  I will not send out  any  updates  for
  230.         minor code changes (the second number to the right of the decimal
  231.         point), but if they start to add up, I will upload it to GEnie.
  232.  
  233.              If  you  have comments or suggestions, please feel  free  to
  234.         include them also.  I am more than interested in updating  things
  235.         like this as long as they remain useful.
  236.  
  237.              If you just have comments or suggestions, you can mail  them
  238.         too.   Or  a better alternative to that is to leave  me  mail  on
  239.         Genie.  My mailing address is:
  240.  
  241.                                    Chris Brown
  242.                                   427 14th St.
  243.                              Edwards AFB, CA  93523
  244.  
  245.                              GEnie address:  MAFMPD
  246.  
  247.  
  248.                                   DISTRIBUTION
  249.                                   ------------
  250.              You  may distribute this program as often as you wish.   You
  251.         may  not,  however,  sell it.  You may not distribute  it  as  an
  252.         inclusion to any other package either.  If it is distributed in a
  253.         "ShareWare  House" (or something similar), no more than $5.00  may
  254.         be charged for 'copying' it.
  255.  
  256.              If  you give your registered copy to someone else, I  remind
  257.         you to remind them that this program is not free.
  258.  
  259.  
  260.                                  THE BOTTOM LINE
  261.                                  ---------------
  262.              The  bottom  line  is,  if you use it  please  pay  for  it.
  263.         Remember  -  "Only YOU can make ShareWare work.   Please  support
  264.         it!"
  265.  
  266.                                 ARCHIVE CONTENTS
  267.                                 ----------------
  268.              The following files must be distributed as a whole.  If  you
  269.         received  this  archive, and any of the files  have  a  different
  270.         time,  date,  name,  or size, please do  not  distribute  anymore
  271.         copies of the version you have, and please notify me.
  272.  
  273.                      CDIR     EXE    20464   2-11-89  12:00a
  274.                      CDIR     DOC    10624   2-11-89  12:00a
  275.  
  276.  
  277.  
  278.                               CDir, v1.30 - Page: 4
  279.