home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / CHNGIT11.ZIP / CHANGEIT.DOC < prev    next >
Text File  |  1993-12-08  |  7KB  |  189 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                       Change It
  8.  
  9.                                      Version 1.1
  10.  
  11.                                    December 8, 1993
  12.  
  13.                                     James Huckabey
  14.                                  3621-A Fraser Street
  15.                              Bellingham, WA 98226 U.S.A.
  16.  
  17.           ═════════════════════════════════════════════════════════════════
  18.  
  19.                Ever needed to change the date or time on a  file, any file?
  20.           That is what I wrote ChangeIt for. It can change any file without
  21.           the read only  attribute set,  any system or  hidden files.  This
  22.           program  should  be used  with  some  measure  of  caution.  Some
  23.           programs  key configuration and data files with the date and time
  24.           on the files.
  25.  
  26.                The program has to be in your path, in the current directory
  27.           or  you  must use  full  path  to program.  You  can  alter files
  28.           anywhere on your system and do not have to be on the drive  or in
  29.           the directory where you want to  alter files. It is much safer to
  30.           be in  the directory, but not necessary to make the program work.
  31.           Now works in root directory as well (corrected v1.1).
  32.  
  33.                The archive should contain the following files:
  34.  
  35.                     CHANGEIT.DOC...........this file 
  36.                     CHANGEIT.EXE...........actual program
  37.                     READ.ME................update file
  38.                     FILE_ID.DIZ............BBS description file
  39.                     HUCKABEY.TXT...........List of my current programs
  40.                     ARCHIVE.TXT............This list of files
  41.  
  42.                Syntax:
  43.  
  44.             ChangeIt [path]filename[.ext] [MM-DD-YYYY,K,S] [HH:MM:SS,K,S]
  45.  
  46.                The  file name can be  any file name  or DOS wildcard, which
  47.           can include a full drive and path if so desired or needed:
  48.  
  49.                      *.*    *.TXT    MINE.*    M??E.*    MINE.TXT
  50.  
  51.                See  your  DOS  manual  for  more  details  on  the  use  of
  52.           wildcards.
  53.  
  54.                Command line options for Date:
  55.  
  56.  
  57.                MM-DD-YYYY=set input date. This is a new date you want on
  58.                                           file(s)) other than the current
  59.                                           system date.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                Valid   date   range:  month(MM):   1..12,   day(DD):  1..31
  66.                year(YYYY):  1980..2099.  That's  pretty  straight  forward.
  67.                Month and day can  be one character each, but year should be
  68.                a full four characters. If you  use just the last two (year)
  69.                the  program checks the current century and adds that to the
  70.                year portion of the input date. Numbers must be separated by
  71.                a dash (-).
  72.  
  73.  
  74.                K=Keep current date. The date on file(s) remains unchanged.
  75.  
  76.  
  77.                S=System date. Change current date on file(s) to current DOS
  78.                               system date.
  79.  
  80.  
  81.                Command line options for Time:
  82.  
  83.  
  84.                HH:MM:SS=set input time. The new time you want on file(s)
  85.                                         other than the current system time.
  86.  
  87.                Valid  time  range:   hour(HH):  0..23,  minute(MM):  0..59,
  88.                second(SS): 0..59. That's pretty straight forward again. You
  89.                can omit the seconds  and the program adds double  zero (00)
  90.                for  seconds, which  do  not show  up  on the  DOS  display.
  91.                Numbers must be separated by a colon (:).
  92.  
  93.  
  94.                K=Keep current time. The time on file(s) remains unchanged.
  95.  
  96.  
  97.                S=System time. Change current time on file(s) to current DOS
  98.                               system time.
  99.  
  100.  
  101.                A note here  about the  time. In the  program a  twenty-four
  102.           hour clock is used. DOS converts  this to a twelve hour time with
  103.           an "a"  for A.M.  or a "p"  for P.M.  (at least  with DOS  5.0+).
  104.           00:00:00=12:00 A.M. (midnight), 12:00=12:00 P.M.  (noon), 1:00 or
  105.           01:00=1:00  A.M. and 13:00=1:00 P.M., etc. This used to be called
  106.           military time, but in all reality  it is just a twenty-four clock
  107.           (real time).
  108.  
  109.  
  110.                                    The Help Screen
  111.  
  112.                Starting the  program with no command  line options produces
  113.           the Help Screen. The Help  Screen is also produced on any  errors
  114.           generated  by command  line or search  errors. If  a file  is not
  115.           found this is also displayed on the bottom of the Help Screen.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                Examples:
  122.  
  123.                                   ChangeIt MINE.TXT
  124.                                           or
  125.                                 ChangeIt MINE.TXT S S
  126.  
  127.                Both these commands are the same. The "Ss" tells the program
  128.           to use the current system date and time.
  129.  
  130.  
  131.                                 ChangeIt MINE.TXT S K
  132.  
  133.                This changes the date but does not alter the time. "S" tells
  134.           the program to use the current  system date and the "K" tells the
  135.           program to keep the current file time.
  136.  
  137.  
  138.                              ChangeIt MINE.TXT 12-25-94 K
  139.                                           or
  140.                             ChangeIt MINE.TXT 12-25-1994 K
  141.  
  142.                These  two examples give the file date that of Christmas Day
  143.           1994 in the  20th Century. In the 21st Century  the date would be
  144.           12-25-2094 on  the first  example because the  program would  add
  145.           "20".  The "K" tells the program to  keep the current time on the
  146.           file.
  147.  
  148.  
  149.                            ChangeIt MINE.TXT 12-25-94 00:00
  150.                                           or
  151.                         ChangeIt MINE.TXT 12-25-1994 00:00:00
  152.  
  153.                These two examples are the same as the previous one only the
  154.           time is changed to twelve o'clock A.M. 
  155.  
  156.  
  157.                               ChangeIt C:\UTILITY\*.TXT
  158.  
  159.                This command changes  all files with the  "TXT" extension in
  160.           the C:\UTILITY directory to the current system date and time.
  161.  
  162.  
  163.                              ChangeIt C:\UTILITY\*.* K S
  164.  
  165.                This command  changes ALL files in  the C:\UTILITY directory
  166.           to the  current time and does  not alter the date.  "K" tells the
  167.           program  to keep  the current  file date  and the  "S"  tells the
  168.           program to change the file time to the current system time.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                                        Support
  175.  
  176.                I am not asking for  any money for this program, but  if you
  177.           feel like sending  me a  contribution to  support my  programming
  178.           efforts  it  shall  be  greatly  appreciated.  You  are under  no
  179.           obligation to do so.
  180.  
  181.                I am also interested in what you think of this of any of  my
  182.           programs. I try to make programs as easy to run and understand as
  183.           possible.  As for myself I  do not like  complicated or confusing
  184.           programs.
  185.  
  186.                See HUCKABEY.TXT for  details on  getting a copy  of all  my
  187.           current software.
  188.  
  189.                               Thank You for your support