home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / CHNGIT10.ZIP / CHANGEIT.DOC < prev    next >
Text File  |  1993-10-14  |  7KB  |  186 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                       Change It
  8.  
  9.                                      Version 1.0
  10.  
  11.                                    October 12, 1994
  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.  This program should  be used  with
  22.           some measure of caution. Some programs key configuration and data
  23.           files with the date and time on the files.
  24.  
  25.                The program has to be in your path, in the current directory
  26.           or  you must  use  full  path to  program.  You  can alter  files
  27.           anywhere on your system and do not have to  be on the drive or in
  28.           the directory where you want to alter files. It is  much safer to
  29.           be in the directory, but not necessary to make the program work.
  30.  
  31.                The archive should contain the following files:
  32.  
  33.                     CHANGEIT.DOC...........this file 
  34.                     CHANGEIT.EXE...........actual program
  35.                     READ.ME................update file
  36.                     FILE_ID.DIZ............BBS description file
  37.                     READ.ME................update file
  38.                     ARCHIVE.TXT............this list of files
  39.  
  40.  
  41.                Syntax:
  42.  
  43.             ChangeIt [path]filename[.ext] [MM-DD-YYYY,K,S] [HH:MM:SS,K,S]
  44.  
  45.                The file  name can be any  file name or DOS  wildcard, which
  46.           can include a full drive and path if so desired or needed:
  47.  
  48.                      *.*    *.TXT    MINE.*    M??E.*    MINE.TXT
  49.  
  50.                See  your  DOS  manual  for  more  details  on  the  use  of
  51.           wildcards.
  52.  
  53.                Command line options for Date:
  54.  
  55.  
  56.                MM-DD-YYYY=set input date. This is a new date you want on
  57.                                           file(s)) other than the current
  58.                                           system date.
  59.  
  60.                Valid   date   range:  month(MM):   1..12,   day(DD):  1..31
  61.                year(YYYY):  1980..2099.  That's  pretty  straight  forward.
  62.                Month and day can be one character  each, but year should be
  63.  
  64.  
  65.  
  66.  
  67.  
  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.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                Examples:
  121.  
  122.                                   ChangeIt MINE.TXT
  123.                                           or
  124.                                 ChangeIt MINE.TXT S S
  125.  
  126.                Both these commands are the same. The "Ss" tells the program
  127.           to use the current system date and time.
  128.  
  129.  
  130.                                 ChangeIt MINE.TXT S K
  131.  
  132.                This changes the date but does not alter the time. "S" tells
  133.           the program to use the current  system date and the "K" tells the
  134.           program to keep the current file time.
  135.  
  136.  
  137.                              ChangeIt MINE.TXT 12-25-94 K
  138.                                           or
  139.                             ChangeIt MINE.TXT 12-25-1994 K
  140.  
  141.                These  two examples give the file date that of Christmas Day
  142.           1994 in the  20th Century. In the 21st Century  the date would be
  143.           12-25-2094 on  the first  example because the  program would  add
  144.           "20".  The "K" tells the program to  keep the current time on the
  145.           file.
  146.  
  147.  
  148.                            ChangeIt MINE.TXT 12-25-94 00:00
  149.                                           or
  150.                         ChangeIt MINE.TXT 12-25-1994 00:00:00
  151.  
  152.                These two examples are the same as the previous one only the
  153.           time is changed to twelve o'clock A.M. 
  154.  
  155.  
  156.                               ChangeIt C:\UTILITY\*.TXT
  157.  
  158.                This command changes  all files with the  "TXT" extension in
  159.           the C:\UTILITY directory to the current system date and time.
  160.  
  161.  
  162.                              ChangeIt C:\UTILITY\*.* K S
  163.  
  164.                This command  changes ALL files in  the C:\UTILITY directory
  165.           to the  current time and does  not alter the date.  "K" tells the
  166.           program  to keep  the current  file date  and the  "S"  tells the
  167.           program to change the file time to the current system time.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.                                        Support
  174.  
  175.                I am not asking for  any money for this program, but  if you
  176.           feel like sending  me a  contribution to  support my  programming
  177.           efforts  it  shall  be  greatly  appreciated.  You  are under  no
  178.           obligation to do so.
  179.  
  180.                I am also interested in what you think of this of any of  my
  181.           programs. I try to make programs as easy to run and understand as
  182.           possible.  As for myself I  do not like  complicated or confusing
  183.           programs.
  184.  
  185.                               Thank You for your support
  186.