home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / TELEGARD / TFM24.ZIP / FILEMAN.DOC next >
Encoding:
Text File  |  1990-04-02  |  34.0 KB  |  740 lines

  1.  
  2.                        Telegard File Manager 2.4 -- Page 1
  3.  
  4.  
  5.  
  6.                        Telegard File Manager 2.4 (Turbo C)
  7.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8.                          Copyright 1990, by Todd Bolitho
  9.                               All rights reserved.
  10.  
  11.              With grateful acknowledgement to the contributions of:
  12.                           Martin Pollard, and Eric Oman
  13.  
  14.         WARNING!
  15.         ~~~~~~~~
  16.         In versions 2.0 - 2.2, there was an error in the Telegard  record
  17.         structure header that File Manager was using.  Because of this, a
  18.         bug  appeared in many Telegard systems that was not the fault  of
  19.         Telegard.   In  fact, it was really no one's fault...  the  error
  20.         came about as the result of attempting to convey record structure
  21.         changes  over  the voice telephone.   A  simple  miscommunication
  22.         caused  File Manager to read and write data from the wrong  spot.
  23.         The  good news is that File Manager 2.3 will FIX this for you  on
  24.         the  very first execution.  You then should go into  your  System
  25.         Configuration <P, D, A> and reset "Max Private Posts Per Call".
  26.  
  27.         BUGS FIXED
  28.         ~~~~~~~~~~
  29.         v2.4
  30.         Thanks to PC-MD Computers and Steve Lennemann for allowing me  to
  31.         debug  File Manager on his systems.  Thanks to him,  the  various
  32.         reported  mouse  bugs  have all been fixed, and there  is  now  a
  33.         commandline  variable to enable File Manager to work  on  systems
  34.         utilizing  EGA  cards with CGA monitors -  "CGA/EGACARD"  is  the
  35.         parameter.
  36.  
  37.         Credit Due
  38.         ~~~~~~~~~~
  39.         While  I am the true author of this program (having coded  nearly
  40.         all it), I would be remiss not to acknowledge the help I received
  41.         from others.
  42.  
  43.         Martin  Pollard  has been my teacher in the C  language,  and  my
  44.         friend.   Several times in the course of coding this  project,  I
  45.         would  find  myself blocked by some lack of understanding  on  my
  46.         part.   Martin was always willing to step in and explain  what  I
  47.         didn't  know,  and he often provided models of his  own  code  to
  48.         assist  me  in  understanding whatever new concept  I  needed  to
  49.         grasp.   It's  rare to find a programmer of his  caliber  who  is
  50.         willing to make the effort to assist a hobbyist like myself,  and
  51.         I am grateful for his time.  I have found that in these  circles,
  52.         he is the exception, not the norm.  Most skilled programmers seem
  53.         to  feel personally threatened by newcomers, and while  they  are
  54.         more than willing to point out any shortcomings, they are unwill-
  55.         ing  to  provide  real help.  In addition, when  I  found  myself
  56.         struggling with a HUGE workload from my job, Martin saw my dilem-
  57.         ma  and contributed a couple of functions to ease my  load,  thus
  58.         helping me get this thing out sooner.  I am very grateful to  him
  59.         for all he has done.
  60.  
  61.                        Telegard File Manager 2.4 -- Page 2
  62.  
  63.  
  64.         Eric  Oman, the ultimate "whiz kid", was also a big help in  this
  65.         project.   Some  of the routines in this  program  are  extremely
  66.         sophisticated, especially those dealing with dynamically allocat-
  67.         ing and freeing memory.  On more than one occasion, Eric was kind
  68.         enough  to provide guidance in the matters of  segmented  memory,
  69.         and he also contributed a function or two to the project.
  70.  
  71.         Thanks  guys!   This project would have taken  months  longer  to
  72.         complete without your help.
  73.  
  74.         Promises
  75.         ~~~~~~~~
  76.         I  promise that this program will take up space on your  disk  or
  77.         hard drive.  No, come to think of it, I don't even promise  that!
  78.         Seriously,  I am (as stated previously) a HOBBYIST.  I am  NOT  a
  79.         professional  programmer, nor do I ever intend to become one.   I
  80.         do  this because I love it, not because I am a well trained  pro-
  81.         fessional.   I use File Manager, and it works fine on my  system.
  82.         On your system, it may format your hard drive for all I know.  It
  83.         may utterly and totally destroy your computer, cause a short, and
  84.         burn  your  house down.  I didn't create it for  the  purpose  of
  85.         doing  harm to anyone or anything, but I don't promise  you  any-
  86.         thing.  I don't warrantee anything.  I owe you nothing.  I  shall
  87.         not  be  responsible for any damages,  direct  or  consequential,
  88.         resulting from File Manager, or its use.
  89.  
  90.         Raison D'Etre
  91.         ~~~~~~~~~~~~~
  92.         File  Manager  was originally conceived as a  simple  program  to
  93.         allow  SysOps  to take files on and offline in  Telegard  without
  94.         having  to log on and manually change the file listing  for  each
  95.         file.   Soon  afterwards,  Phil Katz came out with  his  new  and
  96.         improved compression method, so a routine to adjust file size  in
  97.         the  listing  was also added.  These early versions  were  simple
  98.         commandline  programs that ran through all the file bases on  the
  99.         system correcting all the listings as it went, much like the AUTO
  100.         mode  in  this new version does now.  These older  versions  were
  101.         slow, but they did the job.  It became apparent that a DOS  level
  102.         management system for TG *.DIR files was also needed.  I  decided
  103.         to  write the utility using some of the concepts and ideas in  my
  104.         early  File  Manager  versions.  While I kept some  of  the  same
  105.         concepts, I did not try to maintain compatibility, so if you  are
  106.         still  using  the old File Managers, you will need to  redo  your
  107.         batch calls to the new, and simpler, "FILEMAN AUTO" command.
  108.  
  109.         Another  reason for the project was to show all of  our  trusting
  110.         SysOps the direction we are taking Telegard in the new C version.
  111.         If you enjoy the look and feel of this new File Manager, you will
  112.         find  yourself very comfortable with the new C version  of  Tele-
  113.         gard.  The speed and ease of use will be in the new BBS software,
  114.         as will the more sophisticated windows and editing  capabilities.
  115.         It's  an  ENORMOUS  task, but it is the one we  have  chosen  for
  116.         ourselves.  We hope to have it out sometime this summer.
  117.  
  118.                        Telegard File Manager 2.4 -- Page 3
  119.  
  120.  
  121.         Lastly, I wanted to set some sort of standard for Telegard utili-
  122.         ties.  It's all well and good when we sit in our Ivory Tower  and
  123.         tell people what a shareware utility ought to be like... I wanted
  124.         other  supporting  authors to see what we mean when we  say  that
  125.         shareware  ought  to be something special.  Simple  command  line
  126.         utilities  are very nice, and they are APPRECIATED!  Some  SysOps
  127.         lately have gotten the idea though that since Telegard will  soon
  128.         be  shareware, they too should charge for these little  programs.
  129.         The  Telegard  authors SUPPORT the notion of shareware,  but  let
  130.         these  shareware programs be worthy of the cash we are  asked  to
  131.         shell out.  Don't you agree?
  132.  
  133.         Money
  134.         ~~~~~
  135.         I want some.  This program is "shareware".  While I encourage you
  136.         to  send the complete ZIP file to any and all of your friends  to
  137.         try, you are given a 15 day trial period to evaluate File  Manag-
  138.         er.  If you have not "registered" your File Manager by then, your
  139.         free trial period is over.  Registration is $25.
  140.  
  141.         Originally,  File  Manager was to simply stop  working  after  15
  142.         days.   Some folks seem to feel that's a bit rough.   Fine.  File
  143.         Manager is now being released under the "Annoying Ware"  concept.
  144.         It is my hope you will be "annoyed" enough by the pop-up windows,
  145.         and missing features, that you will send me your registration!
  146.  
  147.         I have tried to make your registration as painless as possible by
  148.         providing a separate program to handle your registration for you.
  149.  
  150.             FILE MANAGER WILL NOT RUN UNTIL YOU FIRST RUN "REG.EXE"!
  151.  
  152.         If  you do not run "REG.EXE", File Manager will run it  for  you,
  153.         when  you  first attempt to run File Manager.   If  File  Manager
  154.         cannot  find  "REG.EXE" on it's first execution, it  will  simply
  155.         shut  down  and refuse to run until you first run  the  "REG.EXE"
  156.         program provided.
  157.  
  158.         REG.EXE
  159.         ~~~~~~~
  160.         REG.EXE is a registration program designed to make your registra-
  161.         tion  as  simple and painless as possible.  Simply turn  on  your
  162.         printer,  and run the program.  Alter the fields to  reflect  the
  163.         correct  information, and press <CTRL-ENTER> or just hit  <ENTER>
  164.         all  the  way through the last field.  REG.EXE  will  print  your
  165.         registration  form,  ALREADY FILLED OUT for you!  If you  do  not
  166.         have  a printer, run the program anyway, and write down  all  the
  167.         information presented on a piece of paper.  Just mail that  paper
  168.         along with a check, money order, or cashier's check  for $25 to:
  169.  
  170.                                              Todd Bolitho
  171.                                              1504 N. Vermont
  172.                                              Royal Oak, MI   48067
  173.  
  174.                        Telegard File Manager 2.4 -- Page 4
  175.  
  176.  
  177.         New Features
  178.         ~~~~~~~~~~~~~
  179.         v2.2
  180.         Online Help - Press <F1> anywhere in File Manager, and up pops  a
  181.         help screen to tell you what you did wrong!  <heh>
  182.  
  183.         <Alt-F>  Registered  Versions Only - Filespec Upload.   Use  this
  184.         feature to bring whole groups of files into your DIR.   Automati-
  185.         cally sets the date, fills in the File Name, and places your name
  186.         into the uploader's name field.
  187.  
  188.         v2.4
  189.         Commandline  parameter - "CGA/EGACARD" allows for use on  systems
  190.         utilizing a CGA monitor with an EGA card.
  191.  
  192.  
  193.  
  194.                           *** Function Information ***
  195.  
  196.  
  197.         TG Structure
  198.         ~~~~~~~~~~~~
  199.         A little background information might be helpful in  understand-
  200.         ing all the power and uses of File Manager.  Telegard looks  for
  201.         the files you have in your bases, on your hard drive or  floppy,
  202.         according   to  the  DL Path.  Perhaps  you  have  wondered  how
  203.         Telegard  keeps track of all those files.  Telegard  stores  all
  204.         the   information on these bases in separate files with a  *.DIR
  205.         extension, one  "DIR"  file  for each base.  In other words,  to
  206.         find  out information  about the SysOp Directory on your system,
  207.         Telegard  must  look  in the file most  likely  named  (by  you)
  208.         "SYSOP"  with a "DIR" extension - "SYSOP.DIR".  It is these  DIR
  209.         files  that   File Manager is most concerned with  altering  and
  210.         modifying, according to your wishes.
  211.  
  212.         File  Manager  must also work with several other files  used  by
  213.         Telegard, but most of these are not important for you to  under-
  214.         stand.  The only exception might be "UPLOADS.DAT"  which  stores
  215.         the  DL  Paths and UL Paths for the various  file  bases.   File
  216.         Manager  has  a very powerful feature that allows  you  to  move
  217.         entire  bases to other drives or directories.  The  significance
  218.         of   UPLOADS.DAT  and the file paths is explained  elsewhere  in
  219.         the help system under "Move Files" and other functions.
  220.  
  221.  
  222.  
  223.         File Manager - How To Set It Up
  224.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  225.         Place REG.EXE, FILEMAN.EXE, and FILEMAN.HLP anywhere you like in
  226.         your  system's PATH.  As  long  as your main BBS directory,  and
  227.         FILEMAN.HLP are somewhere in  the  path, File Manager will  find
  228.         them, and can run from anywhere.  If your main BBS directory  is
  229.         not in your path, place File  Manager, and it's associated files
  230.         in  the main BBS directory.  This is the directory with  BBS.EXE
  231.         and STATUS.DAT.
  232.  
  233.                        Telegard File Manager 2.4 -- Page 5
  234.  
  235.  
  236.         I  strongly  urge you to also install, in your  path,    IFL.COM,
  237.         which  I have included in the TFM##.ZIP file.  This  well   known
  238.         and  widely  respected program (written by Martin  Pollard),   is
  239.         called   by  File  Manager to view the  interiors  of  all  known
  240.         compression   formats.    IFL.COM  is   included   in   TFM##.ZIP
  241.         with  Martin's  permission and blessings.   Execute REG.EXE,  and
  242.         when you are done with it - delete it.  Then run File Manager.
  243.  
  244.         See also:   ^Function Keys^    ^Alt Keys^    ^Command Line Help^
  245.  
  246.  
  247.         Function Keys
  248.         ~~~~~~~~~~~~~
  249.         <F1>  Online Help
  250.         <F2>  Smartload - Loads UPLOADS.DAT and DIR
  251.         <F3>  Direct Load - Loads DIR only
  252.         <F4>  Execute a single DIR
  253.         <F5>  Execute all DIRs in system
  254.         <F6>  Interior File List (IFL)
  255.         <F7>  Dos Shell
  256.         <F8>  Sort Method
  257.         <F9>  Write DIR file to disk
  258.         <F10> Accept Listing Editor's current fields
  259.  
  260.         See also:       ^TG Structure^         ^Alt Keys^
  261.  
  262.  
  263.         Alt Keys
  264.         ~~~~~~~~
  265.         <Alt-D>  Delete Listing
  266.         <Alt-I>  Insert New Listing (Registered Versions Only)
  267.         <Alt-F>  Filespec Upload    (Registered Versions Only)
  268.         <Alt-M>  Move File Listing  (Registered Versions Only)
  269.         <Alt-R>  Registration Info  (Registered Versions Only)
  270.         <Alt-U>  User Choose
  271.         <Alt-X>  Fast Exit
  272.  
  273.         See also:      ^TG Structure^        ^Function Keys^
  274.  
  275.  
  276.  
  277.         Smartload
  278.         ~~~~~~~~~
  279.         The  Smartload  function can be called by selecting  the  "File"
  280.         menu, moving the cursor to "Smartload" and pressing <ENTER>,  or
  281.         by  simply   pressing  F2.  Smartload  places  UPLOADS.DAT  into
  282.         memory,  and   then offers the user a choice of  file  bases  to
  283.         operate   on.   Smartload  is the method you should use  to  put
  284.         your   files  into memory  99% of the time, which is why  it  is
  285.         first  in  the  menu choices.  Smartload allows File Manager  to
  286.         know  where files  are actually kept, because UPLOADS.DAT is  in
  287.         memory  and  supplies the DL  Paths  needed to find  the  actual
  288.         files listed  in  each  DIR file.
  289.  
  290.                        Telegard File Manager 2.4 -- Page 6
  291.  
  292.  
  293.         When  DIR files are Smartloaded, all of File Manager's  features
  294.         are fully functional.  The ONLY disadvantage is that UPLOADS.DAT
  295.         takes up space in memory, so if your system has limited  memory,
  296.         and  if you are working on extremely large DIR files (over  1000
  297.         listings), you may wish to opt to Direct Load instead.
  298.  
  299.         See also:    ^Direct Load^     ^Move Files^     ^TG Structure^
  300.  
  301.  
  302.         Direct Load
  303.         ~~~~~~~~~~~
  304.         Also  called by pressing F3, Direct Loading offers the  raw  DIR
  305.         filenames  as choices for loading.  Direct Loading is only  used
  306.         when  working  under severely constrained  memory  requirements.
  307.         In  cases  where  File Manager functions require a  DL  Path  to
  308.         operate,  these   functions have been disabled  or  modified  to
  309.         discard  the DIR file in memory, and Smartload the base instead.
  310.  
  311.         See also:    ^Smartload^      ^Move Files^      ^TG Structure^
  312.  
  313.  
  314.         Move Files
  315.         ~~~~~~~~~~
  316.         The Move Files command Smartloads a DIR file and allows the user
  317.         to  alter the DL Path.  File Manager knows where the current  DL
  318.         Path  is by looking  where this information is stored  by  Tele-
  319.         gard:  UPLOADS.DAT.   This is the reason for File  Manager  MUST
  320.         Smartload  a DIR if you have not already done so, whenever  this
  321.         function   is called.  Once the Smartload is done, File  Manager
  322.         will  ask  you for a NEW DL PATH.  When the new  path  has  been
  323.         entered, this function will move all listings in the DIR file to
  324.         the  new location you have specified.
  325.  
  326.         If  the  physical path does not exist, it will first  parse  the
  327.         path   given,  creating  all necessary  directories,  and   then
  328.         complete  it's task.  It will REWRITE your UPLOADS.DAT with  the
  329.         new  DL  Path so that Telegard will know where to find  all  the
  330.         files you just moved!
  331.  
  332.         WARNING:   The  UL PATH will also be reset to  the same  as  the
  333.         newly entered DL Path.  If you wish to have files uploaded to  a
  334.         separate directory, you MUST reset the path in Telegard.  Again,
  335.         the  UL Path is automatically written to be exactly the same  as
  336.         the DL Path whenever this function is called.
  337.  
  338.                        Telegard File Manager 2.4 -- Page 7
  339.  
  340.  
  341.         Additional  Information:   If the drive of the new path  is  the
  342.         same  as  the  drive in the old path, File Manager  is  able  to
  343.         simply  rebuild the directory structure to each file,  and  thus
  344.         does not have to physically copy each file to it's new location,
  345.         then  delete the old files.  If the drive specifier in  the  new
  346.         path is different than the old one, File Manager will  dutifully
  347.         copy  and  delete as described above.  It is therefore  wise  to
  348.         always include the COMPLETE pathname, including the drive speci-
  349.         fier.   It won't hurt anything not to do this, but it will  slow
  350.         File  Manager down as it copies and deletes every  single  file,
  351.         instead  of just rebuilding the directory structures  underneath
  352.         the listings.
  353.  
  354.         See also:     ^Smartload^     ^Direct Load^     ^TG Structure^
  355.  
  356.  
  357.  
  358.  
  359.         Write *.DIR
  360.         ~~~~~~~~~~~
  361.         Selecting  this  function from the menu, or calling it  with  F9
  362.         will  cause the DIR file in memory to be written to your  drive.
  363.         It  is  necessary to call this function each time you  are  done
  364.         working on a DIR, and wish to save the work to disk.
  365.  
  366.         See also:        ^Function Keys^
  367.  
  368.         Erase*.DIR
  369.         ~~~~~~~~~~~
  370.         This function should be called with EXTREME CAUTION!  It is used
  371.         to DELETE a DIR file.  If you use this, and then attempt to view
  372.         the  listings in the base serviced by the now deleted DIR  file,
  373.         the  base will contain NO LISTINGS.  This function  has  limited
  374.         value, but is valuable when one wishes to erase old DIR files no
  375.         longer used.
  376.  
  377.  
  378.         DOS Shell
  379.         ~~~~~~~~~
  380.         "Drops  To DOS",  keeping  File Manager in memory.  Also  called
  381.         with F7, it is used when one wishes to operate on the DOS level,
  382.         without  losing place in File Manager.  Memory available to  DOS
  383.         will be sharply reduced, as File Manager is still in place,  and
  384.         taking up space in your machine's memory.
  385.  
  386.         See also:  ^Function Keys^
  387.  
  388.                        Telegard File Manager 2.4 -- Page 8
  389.  
  390.  
  391.         Modify
  392.         ~~~~~~
  393.         Simply select "Modify" to enter File Manager's DIR file  editing
  394.         system.  If no DIR file is present in memory, File Manager  will
  395.         Smartload  the  DIR of your choice before entering  the  editor.
  396.         Use the regular PgUp/PgDn, Home, End, and arrow keys to move the
  397.         Edit Bar to various listings in your DIR.
  398.  
  399.         See also:                ^Edit DIR^              ^Edit Listing^
  400.  
  401.  
  402.         <ENTER> - The Listing Editor
  403.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  404.         Place the Edit Bar on a listing, and press <ENTER>.  Voila!  You
  405.         are  in the Listing Editor.  Remember, this is an editor  within
  406.         an  editor, so try to keep the commands straight in  your  mind.
  407.         Here  you  may  alter all aspects of  the  listing  EXCEPT  it's
  408.         "Status".  Since "Status" is done automatically for you when you
  409.         "Execute"  File Manager's "Services", you have no need to do  it
  410.         manually.
  411.  
  412.  
  413.  
  414.         <ALT-A> (Registered Versions Only)
  415.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  416.         Add To End - Selecting this function will create a new entry  at
  417.         the  end of your DIR that looks like this:  "*NEWFILE.NEW".   If
  418.         you do not edit this name with the Listing Editor, File  Manager
  419.         will remove the entry before saving your DIR back to disk.
  420.  
  421.         <ALT-D>
  422.         ~~~~~~~
  423.         Use  this  to  <D>elete a listing from your DIR.   If  you  have
  424.         Smartloaded  your  DIR  file, and if the  listed  file  actually
  425.         exists in the DL Path, File Manager will ask you whether or  not
  426.         you would like to delete the actual file as well.
  427.  
  428.         <ALT-F> (Registered Versions Only)
  429.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  430.         Use Filespec Upload to bring whole groups of files into your DIR
  431.         according  to the wildcard specs you supply!  If you  wish,  you
  432.         may  also use this to upload single files by  simply  specifying
  433.         the exact filename to upload.
  434.  
  435.         <ALT-I> (Registered Versions Only)
  436.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  437.         Insert Newfile - Selecting this function will insert a new entry
  438.         in your DIR that looks like this: "*NEWFILE.NEW".  If you do not
  439.         edit this name with the Listing Editor, File Manager will remove
  440.         the entry before saving your DIR back to disk.
  441.  
  442.                        Telegard File Manager 2.4 -- Page 9
  443.  
  444.  
  445.         <ALT-M> (Registered Versions Only)
  446.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  447.         Once in the DIR file editor, use <Alt-M> to <M>ove a listing  to
  448.         any  other base.  File Manager will prompt you for the  base  to
  449.         move the listing to, and if the physical file exists, will  also
  450.         ask  you  whether to move the file to the DL Path of  the  other
  451.         file base.  Since it is necessary to have UPLOADS.DAT in  memory
  452.         for File Manager to even know what the DL Paths are, this aspect
  453.         of  the single file move function will only operate if you  have
  454.         Smartloaded your DIR.
  455.  
  456.         <F6>
  457.         ~~~~
  458.         This function key, when in either the DIR Editor, or the Listing
  459.         Editor,  will call IFL.COM to show you what files are  contained
  460.         in  the  listing  selected.  IT should be obvious  that  if  the
  461.         listing is not a compressed format such as ZIP, ARC, ZOO,  etc.,
  462.         IFL will not be able to show that any files are contained within
  463.         the  listing.   For instance, if your Edit Bar is  on  FILE.TXT,
  464.         there  are  no files compressed in text files, so IFL  will  not
  465.         show  any  (duhhhhhh).  Also, if you have not  Smartloaded  your
  466.         DIR,  the DL Path is not available to File Manager, so it  would
  467.         not be able to call this function.
  468.  
  469.         See also:               ^Modify^                 ^Edit Listing^
  470.  
  471.         <PgDn/PgUp>
  472.         ~~~~~~~~~~~
  473.         By  pressing either of these keys, the Listing Editor  will  ad-
  474.         vance  to the next listing in the base.  All modifications  done
  475.         thus far become part of the DIR in memory and will be saved when
  476.         you press <F9> to save your work.
  477.  
  478.  
  479.         <F6>
  480.         ~~~~
  481.         This function key, when in either the DIR Editor, or the Listing
  482.         Editor,  will call IFL.COM to show you what files are  contained
  483.         in  the  listing  selected.  IT should be obvious  that  if  the
  484.         listing is not a compressed format such as ZIP, ARC, ZOO,  etc.,
  485.         IFL will not be able to show that any files are contained within
  486.         the  listing.   For instance, if your Edit Bar is  on  FILE.TXT,
  487.         there  are  no files compressed in text files, so IFL  will  not
  488.         show  any  (duhhhhhh).  Also, if you have not  Smartloaded  your
  489.         DIR,  the DL Path is not available to File Manager, so it  would
  490.         not be able to call this function.
  491.  
  492.                        Telegard File Manager 2.4 -- Page 10
  493.  
  494.  
  495.         <ALT-U>
  496.         ~~~~~~~
  497.         This  command works ONLY when the cursor has been placed on  the
  498.         User NUMBER entry in the form.  Pressing <ALT-U> will provide  a
  499.         list  of  all the users on your system, choosing  one  of  these
  500.         users will place the user's name in the Uploader's Name & User #
  501.         entries  of  the form.  You may of course  edit  them  manually.
  502.         This is provided as a quick and helpful aid to the SysOp.
  503.  
  504.  
  505.         Verbose Descriptions
  506.         ~~~~~~~~~~~~~~~~~~~~
  507.         Due to a limitation in Telegard itself, when creating a  Verbose
  508.         Description, File Manager must immediately save the DIR file  or
  509.         the Verbose entry could be lost forever.
  510.  
  511.  
  512.         <CTRL-ENTER> or <F10>
  513.         ~~~~~~~~~~~~~~~~~~~~~
  514.         These functions place the alterations made to the current  list-
  515.         ing  into  the  DIR memory and return to the  DIR  Editor.   The
  516.         alterations  will  be  saved to disk with the DIR  file  if  you
  517.         choose the <F9> function.
  518.  
  519.         See also:            ^Modify^           ^Edit DIR^
  520.  
  521.  
  522.  
  523.         Execute
  524.         ~~~~~~~
  525.         These functions will execute all the "Services" provided by File
  526.         Manager  in  it's automatic modes.  You are  allowed  to  choose
  527.         between  executing  a single DIR, or ALL DIRs  in  your  system.
  528.         When  Executing, File Manager displays each listing, file  sizes
  529.         (in  blocks),  whether  or  not  the  listing  is  correct,  the
  530.         ONLINE/OFFLINE "Status" of each listed file, and again,  whether
  531.         or  not that is correct.  The far right column shows whether  or
  532.         not  File Manager has altered the listing on your behalf.   File
  533.         Manager will only alter these listings if you have  specifically
  534.         asked it to, by selecting the appropriate "Services".
  535.  
  536.         See also:            ^Single Execute^          ^All Execute^
  537.  
  538.  
  539.         Single DIR Execution
  540.         ~~~~~~~~~~~~~~~~~~~~
  541.         This  function  executes File Manager's services on the  DIR  in
  542.         memory.   It  will NOT save the changes to disk,  and  will  not
  543.         affect  any DIR other than the one you are working on.   If  you
  544.         wish to save the DIR after execution, press <F9>.
  545.  
  546.         See also:           ^Execute^                 ^All Execute^
  547.  
  548.                        Telegard File Manager 2.4 -- Page 11
  549.  
  550.  
  551.         All Execute
  552.         ~~~~~~~~~~~
  553.         File  Manager's  Auto Mode.  This will  execute  File  Manager's
  554.         Services  on all the DIRs in your system.  Once started,  it  is
  555.         not  possible to stop without rebooting.  All changes are  saved
  556.         to  disk, memory is then cleared, and you may work  on  whatever
  557.         DIRs you wish.
  558.  
  559.         See also:            ^Execute^               ^Single Execute^
  560.  
  561.  
  562.  
  563.         Services
  564.         ~~~~~~~~
  565.         "Services"  are  "Executed" to make changes in a  DIR.   If  you
  566.         choose  not  to execute these services, File  Manager  will  not
  567.         provide  these  services  to you!  Check-mark  each  service  by
  568.         moving the cursor bar onto it, and pressing <ENTER>.
  569.  
  570.  
  571.         Correct File Sizes
  572.         ~~~~~~~~~~~~~~~~~~
  573.         If this flag is check-marked, File Manager will find the  actual
  574.         sizes  of each file listed in a DIR, compute it's  correct  size
  575.         (in blocks), and then alters each listing to reflect that.
  576.  
  577.  
  578.         Fix "Request Only"
  579.         ~~~~~~~~~~~~~~~~~~
  580.         If this flag is check-marked, File Manager will determine wheth-
  581.         er or not a physical file corresponding to each listing actually
  582.         exists.    File   Manager  compares  this  to   each   listings'
  583.         ONLINE/OFFLINE  status,  and  if the listing  is  incorrect,  it
  584.         alters  the listing to reflect the true condition.   This  is  a
  585.         VERY  handy feature.  Using this feature, you may remove  entire
  586.         GROUPS of files, run File Manager, and ALL the listings will  be
  587.         corrected  to show what files have been made  "Offline"!   Like-
  588.         wise, when you again place those files back onto your drive, you
  589.         may run File Manager to restore all the listings to "Online".
  590.  
  591.  
  592.         Verbose Packing
  593.         ~~~~~~~~~~~~~~~
  594.         Through a complex series of procedures, File Manager is able  to
  595.         reduce the amount of disk space used by VERBOSE.DAT.  Check-mark
  596.         this   flag  to  select  this  service.   This  maintains   your
  597.         VERBOSE.DAT in top condition each time you run it.
  598.  
  599.  
  600.         Sort Type
  601.         ~~~~~~~~~
  602.         Selected  through the menu, or by pressing F8, this is  used  to
  603.         pick the type of sorting you would like performed each time  you
  604.         Execute the Services in File Manager.  If you select "None", the
  605.         check-mark will disappear from this item.
  606.  
  607.                        Telegard File Manager 2.4 -- Page 12
  608.  
  609.  
  610.         Backwards Sorting
  611.         ~~~~~~~~~~~~~~~~~
  612.         Duhhhhhh, what could this be?
  613.  
  614.  
  615.         Delete OLD *.DIRs
  616.         ~~~~~~~~~~~~~~~~~
  617.         When File Manager saves your DIR files back to disk, it does not
  618.         overwrite the old DIR file.  Rather, it RENAMES the old DIR file
  619.         to *.OLD, and then writes the new DIR file.  This is a  built-in
  620.         protection  provided in case you decide you have made  an  error
  621.         while  working  on your directories.  IF such an error  were  to
  622.         occur,  you  could drop to dos, go into your  GFILES  directory,
  623.         delete the *.DIR file you just wrote, and RENAME the *.OLD  file
  624.         to a DIR extension.
  625.  
  626.         Since  many  people are willing to risk the errors in  favor  of
  627.         having  more available disk space, a function has been  provided
  628.         to  AUTOMATICALLY  DELETE  *.OLD files each  time  File  Manager
  629.         writes  a DIR.  Theoretically, one could still drop to dos,  and
  630.         use  Norton or another disk utility to unerase the  *.OLD  file,
  631.         and  still save the day, but not when File Manager has  executed
  632.         ALL  the DIRs.  It's a judgment call.  File Manager defaults  to
  633.         preserving the *.OLD files.  Use it with caution.
  634.  
  635.         Kill "Offline"
  636.         ~~~~~~~~~~~~~~
  637.         If  you are not in the habit of keeping files "Offline" on  your
  638.         system, you may wish to select this service.  Check-marking this
  639.         flag  will cause File Manager to AUTOMATICALLY  DELETE  listings
  640.         that do not have physical files on the drive to correspond  with
  641.         each  listing.   This is handy for "Spring Cleaning"  your  hard
  642.         drive.  If the listing is marked as "Offline", File Manager will
  643.         not  delete it the listing until it first checks to see  if  the
  644.         physical file is on the drive.  If the file exists, File Manager
  645.         will NOT delete the file.
  646.  
  647.  
  648.         Report To File
  649.         ~~~~~~~~~~~~~~
  650.         When  File  Manager is run in AUTO mode, you may opt to  get  an
  651.         ASCII  text  file report.  The report will appear  in  the  same
  652.         directory as FILEMAN.EXE and will be named FILEMAN.RPT.
  653.  
  654.         See also     ^Report To Printer^
  655.  
  656.  
  657.         Report To Printer
  658.         ~~~~~~~~~~~~~~~~~
  659.         When  File  Manager is run in AUTO mode, you may opt  to  get  a
  660.         printed  report.   MAKE SURE your printer is ON  before  running
  661.         File Manager!
  662.  
  663.         See also:    ^Report To File^
  664.  
  665.                        Telegard File Manager 2.4 -- Page 13
  666.  
  667.  
  668.         Write Data File
  669.         ~~~~~~~~~~~~~~~
  670.         After  you figure out which "Services" you would like  performed
  671.         for  you, select this option to write a data file to  your  disk
  672.         containing all this information.  The file is named FILEMAN.DAT,
  673.         and  will  be  referred to each time  File  Manager  runs,  thus
  674.         allowing  you to customize the services performed for you  on  a
  675.         daily basis.
  676.  
  677.         See also:    ^Command Line Help^
  678.  
  679.  
  680.         No Help Needed!
  681.         ~~~~~~~~~~~~~~~
  682.         Aw, c'mon... you can figure this out if you really try!
  683.  
  684.  
  685.         Commandline Arguments
  686.         ~~~~~~~~~~~~~~~~~~~~~
  687.         File Manager accepts the following commandline arguments:
  688.  
  689.  
  690.         FILEMAN AUTO
  691.         ~~~~~~~~~~~~
  692.         File Manager loads each DIR and Executes according to the  Serv-
  693.         ices  you have specified in FILEMAN.DAT.  IF FILEMAN.DAT is  not
  694.         present  on the drive, File Manager executes according  to  it's
  695.         built-in defaults.
  696.  
  697.         Commandline Screen
  698.         ~~~~~~~~~~~~~~~~~~
  699.         The  following  commandline  arguments  are  used  to  set  File
  700.         Manager's  Screen characteristics.  You must "Write  Data  File"
  701.         FILEMAN.DAT to preserve these settings for future use.
  702.  
  703.  
  704.         FILEMAN 25
  705.         ~~~~~~~~~~
  706.         Sets normal 25 Line mode (default).
  707.  
  708.  
  709.         FILEMAN 43
  710.         ~~~~~~~~~~
  711.         Sets EGA 43 Line mode.
  712.  
  713.  
  714.         FILEMAN 50
  715.         ~~~~~~~~~~
  716.         Sets VGA 50 Line mode.
  717.  
  718.  
  719.         FILEMAN BIOS
  720.         ~~~~~~~~~~~~
  721.         Sets BIOS Screen Writing mode.
  722.  
  723.                        Telegard File Manager 2.4 -- Page 14
  724.  
  725.  
  726.         FILEMAN MONO
  727.         ~~~~~~~~~~~~
  728.         Sets File Manager to MonoChrome (black-and-white) mode.
  729.  
  730.  
  731.         FILEMAN COLOR
  732.         ~~~~~~~~~~~~~
  733.         Sets File Manager to Color mode (default).
  734.  
  735.  
  736.         FILEMAN SNOW
  737.         ~~~~~~~~~~~~
  738.         Sets CGA Direct Screen Write mode with snow checking.
  739.  
  740.  
  741.         FILEMAN CGA/EGACARD
  742.         ~~~~~~~~~~~~~~~~~~~
  743.         If  you  are  using  a CGA Monitor with an  EGA  card,  you  will
  744.         probably  need  to trip this switch.  Don't forget to  SAVE  your
  745.         settings!
  746.  
  747.  
  748.         FILEMAN NORM
  749.         ~~~~~~~~~~~~
  750.         Used  to  reset  File Manager's screen  characteristics  to  the
  751.         original  25 line, color direct screen write mode.  If you  have
  752.         not saved a FILEMAN.DAT file, you will never need this  command.
  753.         You may achieve the same goal by simply deleting FILEMAN.DAT.
  754.  
  755.  
  756.