home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TELPAK_6.ZIP / FMAINT11.ZIP / FMAINT.DOC next >
Encoding:
Text File  |  1991-09-01  |  8.4 KB  |  165 lines
  1.                                  ────────────
  2.                                  FMAINT v1.10
  3.                                  ────────────
  4.  
  5.     Basically I wrote this program for hassle free file maintenance. All
  6.     the file maintenance utilities either required that you be there to
  7.     run through them, or they didn't properly handle the filesize/FPs or
  8.     the offline/online files. I wanted a simple program that could be run
  9.     during a system event at night, and run without the need of user input
  10.     nor need the attention of the sysop.
  11.  
  12.     FMAINT requires that STATUS.DAT be in the current directory. From
  13.     STATUS.DAT it derives the 'FPs per xxK' as well as the correct path
  14.     for file bases and files themselves.
  15.  
  16.     FMAINT will NOT look in the UPLOAD directory of each base, only in the
  17.     DOWNLOAD directory. I'm not really sure why there were ever two dirs
  18.     for each base in the first place, it's one of those odd but true things.
  19.  
  20.     FMAINT will also not run on any directory that has been toggled with the
  21.     flag so that each actual .DIR is placed with the files. Personally, I
  22.     think that makes a big mess of everything, so I've just left the function
  23.     out for now, though with demand, it might make it into later versions.
  24.  
  25.     FMAINT performs various functions, specified by you on the command line.
  26.     Available for processing by the program, are:
  27.  
  28.     [/D] Update File Date .. Will check any existing file and find the
  29.          time/date stamp and place THIS into the date field. This is usefull
  30.          for files that are updated daily so that it always remains online
  31.          without having a date like 01/01/99 in the date field. This is also
  32.          usefull to put the REAL file date into your listings, instead of
  33.          the upload date (This, used in conjunction with, say, a program to
  34.          re-date the file to the latest within the archive, can bring the
  35.          dates on the files to exactly the date of release);
  36.  
  37.     [/F] Update File Points .. Will update the FPs to that of 'Points
  38.          per xxK' setting in Telegard. This is usefull if you decide to
  39.          change the 'FPs / K' option from say 10 to 20. This will pull the
  40.          file size from TG, not from the file itself, so if this option is
  41.          used, it is highly suggested that you also update the file size so
  42.          that it may be as accurate as possible.
  43.  
  44.     [/O] Toggle File Offline/Online .. Will check to see if the file actually
  45.          exists in the directory. Based on it's findings, files are toggled
  46.          offline/online. This makes it easier to delete files, so from DOS
  47.          you could just delete *.ZIP and run FMAINT /O and all these files
  48.          will automatically be toggled offline. Same for putting files back
  49.          online, just copy the file to the correct dir, and run, bingo, you
  50.          have the file back online. This function also checks to see if the
  51.          file actually has a file size greater then 0. If the filesize is
  52.          equal to 0, the file is also toggled offline [Used in rare, but
  53.          existant circumstances]
  54.  
  55.     [/S] Update File Size .. will update the file size in the TG listings to
  56.          that on the actual file. The file size will be rounded off to the
  57.          nearest bytes, then added into TG. This option is usefull if you
  58.          have constantly updating files, like file lists, that you only
  59.          need one entry for, but continue to change size on a day to day
  60.          basis. It is highly suggested that you also update the file points
  61.          when you run this option.
  62.  
  63.     [/V] Virus Scan .. currently disabled function of FMAINT .. Please look
  64.          to future versions of FMAINT for this option.
  65.  
  66.     The commands within the [] can be put on the command line in any order,
  67.     in any case, but must have the / in front, followed by the correct letter.
  68.  
  69.     The screen when the program is being run is as follows:
  70.  
  71.     [--]
  72.     Scanning New Uploads [#2] ...                              { File Base }
  73.  
  74.      Filename.Ext Date     Len Pts  Description                { Header    }
  75.      ──────── ─── ──────── ─── ───  ─────────────────────────
  76.      TESTFILE 001 08/15/91  16   2  Test File #1               { Normal    }
  77.      TESTFILE 002 08/17/91 Offline  Test File #2 with Exten..  { Cut Desc  }
  78.     [--]
  79.  
  80.     All the information displayed, will be the information directly from TGs
  81.     file lists, or the updated infomation if it has been updated.
  82.  
  83.     Also, on the very bottom line will be the status lights. The lights for
  84.     each function will be 'lit' if this function is active during the current
  85.     run, or 'unlit' if they are deactivated this run.
  86.  
  87.                                   ────────────
  88.                                   PLEASE NOTE!
  89.                                   ────────────
  90.  
  91.     I hereby exclude me or my BBS from any blame caused by running this
  92.     program. It works perfectly on my computer and hasn't caused any
  93.     problems, but in the event it happens to cause loss of data or damage to
  94.     your system, I am not liable. RUN THIS PROGRAM AT YOUR OWN RISK. I
  95.     should see no problems since I've beta tested in on my own system for over
  96.     a month, as well as on a few other systems to verify it's execution ..
  97.  
  98.     But NEVER the less, all care should be taken whenever you run new
  99.     programs on your system .. Files opened by FMAINT include STATUS.DAT and
  100.     UPLOADS.DAT, files opened and changed include all you .DIR directory
  101.     listings ..
  102.  
  103.     Make backups of these files, and continue to make backups of all your
  104.     files used with BBSs .. trust me, I've had way to many crashes, and it's
  105.     always good to have a backup.
  106.  
  107.     Anyways, again, run this program at your own risk, as I've said, I've had
  108.     it running on Forbidden Knights and The Dark Caverns without any problems.
  109.  
  110.                                  ─────────────
  111.                                  REGISTRATION?
  112.                                  ─────────────
  113.  
  114.     [ Begin Critic Mode ]
  115.  
  116.     I require absolutely NO registration for this program. I see no reason why
  117.     ANY author should charge registration for something so small. Yes, you run
  118.     it everyday, whooppie who da day. Registration spoils the fun, and also
  119.     makes many people who can't program go broke from paying registrations 
  120.     to simple programs. ANY author who charges for software similar to mine
  121.     should go jump off a cliff. If I can program equivalent programs, I will.
  122.     Payment is for those who are greedy. See, I started off programming this
  123.     for my use only, and it eventually made it's way to be released. So, if
  124.     I've already gotten the return I originally expected, why should I charge?
  125.  
  126.     So, to any author who charges for simple software, including editors etc,
  127.     my suggestion is STOP asking for registration. I do this as a hobby, it's
  128.     fun, but it's better to know that people like my program and use it, rather
  129.     then having people going 'MY GOD $15 DOLLARS FOR A MASTER FILE LIST
  130.     GENERATOR?' .. Lame, honest to goodness, Lame. Greed goes beyond that 
  131.     of just asking for money, I wouldn't mind so much if it was something 
  132.     major, major, major .. But I see people just charging for something 
  133.     really simple, going 'Send me $10 for the userlist generator' .. gimme 
  134.     a break people, do you absolutely feel you deserve recognition for your 
  135.     work? If you do, then the gratitude of others should be enough to 
  136.     overpower your greed.
  137.  
  138.     So, again, this program is FREE of charge. Absolutely no money down, no
  139.     payment .. ever.
  140.  
  141.     If you really want to send me something, umm, a nice little message saying
  142.     'I like your program, and I use it all the time' is all I really need to
  143.     make my day.
  144.  
  145.     [ End Critic Mode ]
  146.  
  147.                                     ───────
  148.                                     ANYWAYS
  149.                                     ───────
  150.  
  151.     Any changes that need to be made will be and released once again. Further
  152.     suggestions, comments and/or bug reports can be directed to me through
  153.     netmail to Tim Strike or Riim at:
  154.  
  155.                                FidoNet 1:259/423
  156.                                  TeleNet 7:9/0
  157.                               GalaxyNet 10:100/220
  158.  
  159.                             Or reported directly to:
  160.  
  161.                                 Tim Strike/Riim
  162.                              Forbidden Knights RPG
  163.                          [416]820-7273 1200-14,400 HST
  164.  
  165.