home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / TAM121.ZIP / TAM.DOC < prev    next >
Text File  |  1992-08-10  |  54KB  |  1,013 lines
  1. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2.  
  3.                     ██████████   ████████   ██      ██
  4.                       ░░██░░░░░░ ██░░░░██░░ ████  ████░░
  5.                         ██░░     ████████░░ ██░████░██░░
  6.                         ██░░     ██░░░░██░░ ██░░██░░██░░
  7.                         ██░░     ██░░  ██░░ ██░░  ░░██░░
  8.                           ░░       ░░    ░░   ░░      ░░
  9.  
  10.                        WWIV Transfer Area Manager, v1.21
  11.                      Copyright (C) 1992 by Jon R. Rickher
  12.                              All Rights Reserved
  13.  
  14. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  15.  
  16. System Requirements:
  17. ════════════════════
  18.  
  19. TAM requires about 307K of free RAM to operate, more if you are doing any
  20. sorting. TAM works best on machines with some expanded memory, since it will
  21. swap itself out of memory to EMS if any is available rather than to the hard
  22. drive.
  23.  
  24. TAM requires an IBM or compatible and though a color monitor is not required,
  25. it is suggested. The extended 43- and 50-line modes of EGA and VGA adapters
  26. are supported. TAM is configurable as to what video mode it uses; when you run
  27. TAMCFG you can specify whether TAM will use the current video mode, 25-line
  28. mode or 43-/50-line mode.
  29.  
  30. Sorting is the most memory-hungry function. To be able to sort an area, you
  31. need to have about 1K free memory per 7 files, while TAM is running. So if
  32. you have 512K free RAM when you run TAM, that would leave about 205k of
  33. free RAM for TAM to use when sorting, thus allowing you to sort an area
  34. containing up to about 1400 file records. With DOS 5.0 and 600K free,
  35. you'd have roughly 293K free to sort after TAM loads, thus allowing you to
  36. sort an area containg up to about 2000 file records (about 4 times as many
  37. as the normal WWIV limit).
  38.  
  39. Also note that if you run TAM in the extended video modes on an EGA or VGA
  40. adapter then TAM takes up more runtime memory, thus decreasing the maximum
  41. number of file records that TAM could sort in a directory. Also note that
  42. this maximum is *per dir*, not total. The total number of files doesn't
  43. really matter, since the sorting is done one directory at a time. With TAM's
  44. support of up to 256 different file areas, a practical maximum of the total
  45. number of *files* you could have on your board at a (conservative) estimate
  46. of 4000 files per area is about one million files. Two million files would
  47. be pushing it to the limit. If you have more than a million files on your
  48. board, TAM will probably not be adequate as a file manager (but then again,
  49. I don't think anything would). If you wanted to give up sorting, then you
  50. could conceivably use TAM with up to about 2.5 million files. Anyone who
  51. has more than a million files - send me your BBS number. I want an account.
  52.  
  53. If you run TAM using WWIV's shrink or as a standalone, then this shouldn't
  54. ever be a problem. This information is provided just for the halibut, in case
  55. anyone was curious.
  56.  
  57. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  58.  
  59. Description:
  60. ════════════
  61.  
  62. TAM is a transfer area manager for WWIV BBS systems. It allows complete
  63. editing of the directory and file record structures used by WWIV as well
  64. as peeking into archives, moving, deleting, inserting, sorting, updating
  65. WWIV's records to match true file sizes, and more. The registered version
  66. allows many of these commands to be done in batch mode, so that you can
  67. perform the same action on a set of tagged files (ideal for moving, for
  68. example).
  69.  
  70. The registered version also does not require a keypress to exit, thus making
  71. the commandline options (see below) more useful for external events, when you
  72. want to keep your file areas sorted hassle-free.
  73.  
  74. TAM is user-friendly and attractive in display, making the most use of a
  75. windowed environment. TAM is also ShareWare. This means that you get a chance
  76. to see if it suits your needs *before* you pay for it. It does also mean,
  77. however, that if you use it beyond a trial period (30 days) that you *do* pay
  78. for it. TAM required an embarassingly large amount of hours to develop and
  79. it is only fair that if you use it, that you register. I have to pay for all
  80. the aspirin I need for the headaches I get writing this stuff, after all.
  81.  
  82. TAM deals with the .DIR and .EXT files in subtly different ways than WWIV
  83. itself does. WWIV keeps "junk" records at the end of a file when you remove
  84. files; TAM does not. Whenever you "A"dd or "D"elete a file record with TAM,
  85. the entire .DIR file (and .EXT file if applicable) is rewritten with all
  86. unused records being deleted. This is slightly slower than the way WWIV does
  87. things, but cleaner and more space-efficient.
  88.  
  89. Perhaps an example would be useful here. Let's say you have a file area that
  90. contains 99 file records. The size of the .DIR file would be 14400 bytes (144
  91. for each record plus 144 for the marker record at the beginning of the .DIR
  92. file). You then use WWIV to "R"emove all but one of these files. One would
  93. think that the .DIR file would then be 288 bytes (144 for the marker and 144
  94. for the remaining record). Right? Wrong. The file would *still* be 14400
  95. bytes in size. The other 98 records would be these junk records. On the other
  96. hand, if you use TAM to "D"elete the 98 records, the file size of the .DIR
  97. file *will* be 288 bytes, as you would expect.
  98.  
  99. There are reasons for doing it either way. With the default WWIV method, if
  100. you have some junk records in a .DIR file, these are used first when adding
  101. records (or uploading files) to that area. This means that WWIV does not
  102. have to write another 144 bytes onto the end of the file, but rather edit
  103. 144 bytes that are already there. This is slightly quicker. It's much
  104. quicker to delete files by using these junk records when removing records
  105. though, since the entire .DIR file need not be rewritten, and in the days
  106. when WWIV was commonly run on XT-class machines with 65 millisecond hard
  107. drives, this was important. These days, however, with cheap AT's and average
  108. drive speeds of 28 milliseconds or better, the cleaner approach used by TAM
  109. makes more sense.
  110.  
  111. Registration gets you access to a registered version with the nag disabled
  112. and the batch features enabled. TAM is in no way crippleware, though. You
  113. can move, delete, and everything else with the unregistered version. You just
  114. can't do it on a set of files all at the same time (hey, there's gotta be
  115. *some* incentive, right?). Registration is lifetime. This means no additional
  116. upgrade costs ever. It doesn't mean that the price won't ever go up - it
  117. might. It means that *you* won't ever have to pay any more. Price changes, if
  118. any, will never affect those who have already registered.
  119.  
  120. If you forget a command, just hit F1 from anywhere and you'll get a menu
  121. of available commands to help you out.
  122.  
  123. If you like TAM and continue to use it beyond the 30-day trial period then
  124. you may send a check or money order for $20 registration to the following
  125. address:
  126.  
  127.                                Jon R. Rickher
  128.                                c/o The Fellowship
  129.                                7035 Ethel
  130.                                St. Louis, MO 63117
  131.  
  132. The Shareware version of TAM may be freely distributed, provided that no
  133. fee is charged for such distribution except for nominal shipping and
  134. handling fees for disk, copying, etc (not to exceed $5), and provided that
  135. no part of the package is left out.
  136.  
  137. TAM was written with Turbo Pascal 6.0, using the Turbo Professional and
  138. Async Professional libraries by TurboPower Software. The source code is nearly
  139. 200K total (not counting the Turbo Professional libraries), so obviously this
  140. has been no trivial undertaking. 200K is about 40,000 words, the size of a
  141. small book.
  142.  
  143. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  144.  
  145. Installation:
  146. ═════════════
  147.  
  148. If you have a previous version of TAM then you should always run the new
  149. TAMCFG program, to make sure if there are new configuration options that they
  150. are set as you would want.
  151.  
  152. If you have not modified your WWIV userrec struct, then simply copy TAM.EXE,
  153. TAMCFG.EXE, and UTS.EXE into your main WWIV directory and run it. If you're
  154. using the GOLDSYS modification then rename TAMGOLD.EXE to TAM.EXE and put
  155. *that* in your main WWIV directory. Thanks to Dawg for making me more aware
  156. of this modification and for providing me with the necessary data files so
  157. that I could create a copy of TAM compatible with that modification.
  158.  
  159. If you have altered your userrec struct then you will need to compile UTS.C
  160. into UTS.EXE using your own VARDEC.H (included with the WWIV source code).
  161. This will allow TAM to remove upload credit when you delete files, if you
  162. wish.
  163.  
  164. For ease of use you might wish to run TAM as a chain, using shrink. It's
  165. also possible that you could use it by making it a callable command using
  166. the WWIV 4.20+ MACROS.TXT file, if you have enough memory. If you try this
  167. and the windows look weird or out of place then you don't have enough memory
  168. to do this. This will likely not work; you will probably need to shrink to
  169. use TAM.
  170.  
  171. Note that TAM will not run remotely unless you use something like DOORWAY to
  172. intercept direct screen writes. TAM is intended for local use, for sysops
  173. who wish to manage their file area(s) more effectively.
  174.  
  175. If this is your first installation *or* if this is an upgrade installation,
  176. then you should delete TAM.CFG and run TAMCFG.EXE in your main WWIV dir to
  177. create a new configuration file. When specifying program names in TAMCFG
  178. it's safer to spell out complete paths, but TAM will search your DOS PATH
  179. for executables when executing other programs so if you are *sure* a
  180. specific program is in your path, then you need only specify the program
  181. name, not the complete path to it.
  182.  
  183. TAMCFG.EXE is fairly self-explanatory in use. Cursor keys or the TAB key
  184. move you from field to field. Control-Enter saves changes, ESC aborts
  185. them.
  186.  
  187. I recommend downloading the latest version of AVIEWCOM and installing that in
  188. your main WWIV directory. TAM will look in the current dir for AVIEWCOM.EXE so
  189. if it is in the WWIV main dir and you run TAM from there, then you will be able
  190. to use the File Level "L"ook command to view documents inside of archives,
  191. without unzipping them.
  192.  
  193. If you wish to use the auto-shelling to UEDIT ability, then you need to have
  194. UEDIT.EXE in your WWIV dir (or your PATH, at least) as well (and your userrec,
  195. obviously, must be compatible with whichever copy you use). Get UEDIT123.ZIP
  196. for this ability.
  197.  
  198. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  199.  
  200.  
  201. Directory Level Commands:
  202. ═════════════════════════
  203.  
  204.  F1   : Help screen, showing available commands.
  205.  
  206.  F2-F9: User-definable. Use TAMCFG to set what programs (if any) these keys
  207.         will call.
  208.  
  209.        When defining the key assignments with TAMCFG, you can use the
  210.         following replaceable parameters:
  211.  
  212.         %1 = FILENAME.EXT
  213.              This is the complete pathname of the file which the cursor is
  214.              on.
  215.         %2 = User number who uploaded the current file.
  216.         %3 = System number of who uploaded the current file.
  217.         %4 = Directory name of current file area, with trailing backslash.
  218.         %5 = Directory name of current file area, without trailing
  219.              backslash.
  220.  
  221.  
  222.         So, to define VPIC to execute and show whatever file the cursor is
  223.         on could be done with:
  224.  
  225.         C:\UTIL\VPIC.EXE %1
  226.  
  227.         UEDIT could be defined with:
  228.  
  229.         C:\WWIV\UEDIT.EXE %2
  230.  
  231.         LIST could be invoked (for text files) with:
  232.  
  233.         C:\UTIL\LIST.COM %1
  234.  
  235.         It's all customizable and up to you. Only the latter two (%4 and
  236.         %5) function at the Directory Level. All of them are usable at
  237.         the file level. The above demo line for UEDIT, if pressed at the
  238.         Directory Level, would simply load UEDIT with its default setting
  239.         on user #1.
  240.  
  241.         All of these key assignments are shown on the System Information
  242.         screen.
  243.  
  244.  F10  : System Information. Shows some info about your system.
  245.  
  246.  <CR> : Hitten <CR> (the ENTER key) puts you into TAM's File Level (see
  247.         below).
  248.  
  249.   A: Add a new file area. The actual directory itself, if it does not exist,
  250.      will be created *if* you give it a valid directory pathname and if
  251.      you specify the complete patname (for instance, "C:\AAA\BBB\CCC\"). The
  252.      created file area will be added *after* the one that the cursor is
  253.      on. (Thus, you cannot create one *before* the first file area, which
  254.      is usually the sysop dir anyway.)
  255.  
  256.   D: Delete a transfer area. You cannot delete *all* of them. There must be
  257.      at least one left. TAM will not allow you to delete all of them. The
  258.      associated *.DIR and *.EXT file(s) (if any) will also be deleted.
  259.  
  260.   E: This command throws you into edit mode. Here you will be able to
  261.      edit all the fields of a directory record, including type, max files,
  262.      etc. The max file limit with TAM is 9999 (WWIV's built-in limit is
  263.      499). This could be made higher, but then WWIV's built-in sorting
  264.      routines would likely have problems - if anyone actually threw more
  265.      files than that in one area. To save a record after you have altered
  266.      it, hit Control-Enter, or Esc to abort the changes.
  267.  
  268.   F: This key puts you into TAM's File Level (see below).
  269.  
  270.   L: Generate file listing for the area that the cursor is on. This listing
  271.      is called FILES.TXT and will be in the current directory. If a file
  272.      by that name already exists (say, if you've generated a listing before),
  273.      then it will be appended to.
  274.  
  275.   O: This function will allow you to sort all file areas, either by date
  276.      uploaded, alphabetically or alphabetically by extension. Registered
  277.      version only. Unregistered version, must sort each file area individu-
  278.      ally. If you have too many files in a file area TAM will error out. The
  279.      allowed maximum is 9999 files, but in terms of practicality it would be
  280.      wiser to stay below 1500 or even 1000 (which is still double the
  281.      standard WWIV limit). The lower your free memory the fewer files TAM
  282.      can handle in a sort, so it's definitely best to run TAM under WWIV's
  283.      shrink or as a standalone executable. See TAM.MOD on how to easily
  284.      implement it as a command from within WWIV, using shrink.
  285.  
  286.   S: This allows you to enter a search specification, all in uppercase, since
  287.      the searches are not case-sensitive.
  288.  
  289.   T: This will tag an untagged directory or untag a tagged directory. Unlike
  290.      File Level tags, Directory Level tags are preserved when moving to and
  291.      from the File and Directory Levels.
  292.  
  293.   U: This function does the equivalent of a WWIV //UPLOAD on the directory
  294.      that the cursor is on.
  295.  
  296.   Z: This command will allow you to update the file sizes of all file
  297.      records in all file areas to match the actual file size in DOS. Files
  298.      that don't actually exist in DOS are left untouched. Registered
  299.      version only. Unregistered version must size-update one at a time.
  300.  
  301.   ]: This searches upward, starting with the current file area. A match is
  302.      found if the search specification is a substring of a filename *or* a
  303.      file description. The cursor is placed on the directory containing the
  304.      match. If you have not yet entered a search spec, you will be told so.
  305.  
  306.   [: Searches downward. In all other respects, the same as the ']' key.
  307.  
  308.   Alt-M: Allows you to move the location of one file area in the list order.
  309.      If you are moving the area farther down the list then it will be
  310.      placed after the directory you select. If you are moving the area
  311.      farther up the list (ie, to a lower number) then it will be placed
  312.      before the directory you select. Experiment with it; you won't hurt
  313.      anything.
  314.  
  315.   Alt-S: Shell to DOS. Just what it says; drops you to a temporary DOS
  316.      shell.
  317.  
  318.   Alt-X: Quick quit, no verification prompt.
  319.  
  320.  
  321. The following global commands only work in the registered version:
  322.  
  323.       O (sort all areas)   Z (update file sizes in all areas)
  324.  
  325. You can still achieve the same effect with the unregistered version by sorting
  326. each file area individually and by hitting "Z" on each file record in each
  327. directory; it just isn't as easy.
  328.  
  329. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  330.  
  331.  
  332. Directory Level Batch Commands:
  333. ═══════════════════════════════
  334.  
  335.    Alt-L: Generates file listings for all tagged directories. The file that
  336.           contains the list is called FILES.TXT and will be in the current
  337.           directory. If such a file already existed then it will be appended
  338.           to when you execute this command.
  339.  
  340.    Alt-T: Tag all untagged directories and untag all tagged directories.
  341.  
  342.    Alt-U: Perform an "U"pload sequence on all tagged directories. If all dirs
  343.           are tagged then this is the equivalent of a WWIV //UPLOADALL but,
  344.           since you don't have to tag them all, it's more flexible. This is
  345.           abortable by laying on the spacebar.
  346.  
  347. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  348.  
  349.  
  350. File Level Commands:
  351. ════════════════════
  352.  
  353.   F1   : Help screen, showing available commands.
  354.  
  355.   F2-F9: User-definable. Use TAMCFG to set what programs (if any) these keys
  356.          will call.
  357.  
  358.          When defining the key assignments with TAMCFG, you can use the
  359.          following replaceable parameters:
  360.  
  361.          %1 = FILENAME.EXT
  362.               This is the complete pathname of the file which the cursor is
  363.               on.
  364.          %2 = User number who uploaded the current file.
  365.          %3 = System number of who uploaded the current file.
  366.          %4 = Directory name of current file area, with trailing backslash.
  367.          %5 = Directory name of current file area, without trailing
  368.               backslash.
  369.  
  370.  
  371.          So, to define VPIC to execute and show whatever file the cursor is
  372.          on could be done with:
  373.  
  374.          C:\UTIL\VPIC.EXE %1
  375.  
  376.          UEDIT could be defined with:
  377.  
  378.          C:\WWIV\UEDIT.EXE %2
  379.  
  380.          LIST could be invoked (for text files) with:
  381.  
  382.          C:\UTIL\LIST.COM %1
  383.  
  384.          It's all customizable and up to you. Only the latter two (%4 and
  385.          %5) function at the Directory Level. All of them are usable at
  386.          the file level. The above demo line for UEDIT, if pressed at the
  387.          Directory Level, would simply load UEDIT with its default setting
  388.          on user #1.
  389.  
  390.          All of these key assignments are shown on the System Information
  391.          screen.
  392.  
  393.   F10  : System Information. Shows some info about your system.
  394.  
  395.    A: Add a new file entry. This does not mean that the actual file that is
  396.       represented by the entry actually exists on the hard drive - it may or
  397.       may not. This does allow you to add an entry then later on just copy
  398.       the actual file to the appropriate directory and it will then show
  399.       as existing on the board. Or you can add an entry for a file that you
  400.       know does exist (changing the name from "NEW" to whatever the real
  401.       filename is), then hit "Z" to update the size to match the true file
  402.       size.
  403.  
  404.    C: Un/Comment. Will uncomment a zipfile if there is no TAMZIP.CMT file
  405.       in the current directory. If there is a file called TAMZIP.CMT in the
  406.       current directory then this will be added as the zip comment.
  407.  
  408.    D: Delete a file record. If the file actually exists in DOS, you will
  409.       be asked if you wish it to be deleted as well. If the file has an
  410.       extended description then this will be deleted too.
  411.  
  412.    E: As with file *areas*, <Enter> will also achieve the same effect and
  413.       put you in editing mode. At the file level particularly, this is
  414.       a fairly powerful tool; you can change the date of the file record
  415.       to, say, 10/10/99 and the WWIV seconds-since-1970 record will be
  416.       adjusted accordingly, meaning that that file will show as new until
  417.       that date. You can insert color codes into the description if you
  418.       so desire as well, by hitting ^P^C and then a number. (Handy for
  419.       making specific files stand out.) You can change the size that WWIV
  420.       thinks the file actually is (thus lowering the ratio effects if you
  421.       lower it, if you use a ratio). Basically any field can be edited.
  422.       Note that if you change the name of the file, that the actual file
  423.       in DOS *is* changed accordingly. As above, Control-Enter saves
  424.       changes, and Esc aborts them.  Note that if you edit the extended
  425.       description (or create one) that this is saved regardless of you
  426.       ESCaping out of the rest of the edit.
  427.  
  428.    G: View GIF file. This option will autoload VPIC and let you view the
  429.       file, if it is a GIF file. Handy for those with large GIF collections
  430.       (like we have on The Fellowship). Note that it's entirely possible
  431.       to use a viewer other than VPIC by specifying a different program in
  432.       that field with TAMCFG. The only stipulation must be that the program
  433.       accepts a filename to load and view on the commandline
  434.  
  435.    M: Move a file. Allows you to move a file from one file area to
  436.       another. If the file actually exists in DOS, and if the file area
  437.       to which you wish to move it has a valid path, then the file will
  438.       also be physically moved in DOS.
  439.  
  440.    O: Will sort the directory, either alphabetically, by date uploaded, or
  441.       alphabetically by extension.
  442.  
  443.    P: Will let you peek into a supported archive type (like the "V"iew
  444.       archive contents of WWIV, except that the viewing takes place in
  445.       a window).
  446.  
  447.    R: Inserts a GIF file's resolution into the file description automatically
  448.       if the file is actually present on the hard drive. It does so in the
  449.       format "WWWxHHHxCCC ... Description here". If the width is greater than
  450.       three digits you will get one less period (dot) separating the
  451.       resolution from the description (to keep it lined up properly).
  452.  
  453.    S: Allows you to enter a search specification, same as in the Directory
  454.       Level commands. A search spec must be entered before you can use the
  455.       [ and ] (search down/search up) commands.
  456.  
  457.    T: Tags an untagged file or untags a tagged file. Note that File Level
  458.       tags are not preserved once you exit to the Directory Level.
  459.  
  460.    U: Allows you to do the equivalent of a //UPLOAD, except that as the
  461.       files are uploaded, you may edit them more completely with TAM's
  462.       file record editor.
  463.  
  464.    V: Virus Check the file the cursor is on, using MacAfee's Scan. If a virus
  465.       is found you will be notified. TAM's audit log (TAM.LOG) will be
  466.       updated regardless of the result.
  467.  
  468.    W: If UEDIT.EXE is in the current directory, and the file record the cursor
  469.       is on shows that the file was uploaded by a user on your system then
  470.       this command will shell to UEDIT (to allow you to see the stats for
  471.       that user, for example, before deciding whether to remove upload
  472.       credit). Note that it's not necessary to use *my* UEDIT.EXE. Any file
  473.       with that name will work as long as it accepts a user number to load
  474.       on the commandline.
  475.  
  476.    X: Edit extended description without entering the edit window. A sort of
  477.       bypass-function to do this single function more efficiently. Note that
  478.       this command is not listed on the available commands at the bottom of
  479.       the screen (I ran out of space for all the options!). This also allows
  480.       you to create an extended description (you will be asked if you wish
  481.       to do so, if there currently is none).
  482.  
  483.    Z: Makes the WWIV record file size match the actual size of the file in
  484.       DOS, if the file exists. Handy for times when the file size might have
  485.       changed (such as running GifLite on a bunch of Gifs, or adding zip
  486.       comments to a bunch of files, or uncommenting all your files, whatever).
  487.  
  488.    Alt-K: Copy file description to clipboard.
  489.  
  490.    Alt-P: Paste file description on clipboard onto current file record.
  491.  
  492.    Alt-S: Shell to DOS. Just what it says; drops you to a temporary DOS
  493.       shell.
  494.  
  495.    Alt-X: Quick quit, no verification prompt.
  496.  
  497. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  498.  
  499.  
  500. File Level Batch Commands:
  501. ══════════════════════════
  502.  
  503.    Alt-C: Uncomments or comments all tagged files in the current file area.
  504.           Registered version only. TAMZIP.CMT is the file that should
  505.           contain the zip comment that you wish to use. If there is no such
  506.           file then the zipfile will be UNcommented.
  507.  
  508.    Alt-D: Deletes all tagged files in the current file area. This batch command
  509.           does *not* ask you whether you wish the files to be physically
  510.           deleted in DOS - it will delete them if they exist. If you wish to
  511.           leave a file in DOS but remove the record from WWIV's knowledge then
  512.           do so with the "D" File Level command and answer "no" to whether
  513.           you wish the file to be physically deleted. Registered version
  514.           only.
  515.  
  516.    Alt-M: Batch moves files to another file area, both the WWIV records, and
  517.           the actual DOS files (if they exist, of course). Registered version
  518.           only. Extended descriptions are also moved accordingly, if there are
  519.           any.
  520.  
  521.    Alt-S: Shell to DOS.
  522.  
  523.    Alt-R: Will insert the GIF resolution for all tagged files that are
  524.           physically present on the drive. See "R" command above. Registered
  525.           version only.
  526.  
  527.    Alt-T: Tags all untagged files and untags all tagged files. Note that File
  528.           Level tags are not preserved once you exit to the Directory Level.
  529.  
  530.    Alt-V: Batch checks tagged files of supported archive types for viruses.
  531.           Registered version only.
  532.  
  533.    Alt-Z: Batch updates record file sizes, so that they match their DOS
  534.           physical counterparts. Registered version only.
  535.  
  536.  
  537. The following batch commands only work in the registered version:
  538.  
  539.                      Alt-C (un/comment)
  540.                      Alt-D (delete)
  541.                      Alt-M (move)
  542.                      Alt-R (insert GIF resolution)
  543.                      Alt-V (virus-scan)
  544.                      Alt-Z (size-update)
  545.  
  546. (Thus Alt-T is rather meaningless, but if ya wanna play, why not?)
  547.  
  548. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  549.  
  550.  
  551. CommandLine Options (Registered Version Only):
  552. ══════════════════════════════════════════════
  553.  
  554.      /SA: Sort all file areas alphabetically.
  555.  
  556.      /SD: Sort all file areas by date uploaded.
  557.  
  558.      /SE: Sort all file areas alphabetically by extension.
  559.  
  560.      /Z : Update file sizes of all files in all file areas to match true DOS
  561.           filesize (for those files that actually do exist in DOS).
  562.  
  563.      /X : Exit TAM after processing one or more of the above commandline
  564.           options.
  565.  
  566.      /L : This commandline switch should be followed immediately by the name
  567.           of an ASCII file which contains file area numbers, one per line,
  568.           with 0 being the first file area (usually the Sysop dir). If this
  569.           file exists then TAM will generate a file listing based upon the
  570.           numbers found within that ASCII file.
  571.  
  572.           It sends this list to a file called FILES.TXT in the current dir.
  573.           If this file exists then it is appended to. The best way to do
  574.           these lists (which are generally done to allow callers to D/L them)
  575.           is to use TAM this way as part of your external event. Here's a
  576.           sample batch file:
  577.  
  578.           @Echo Off
  579.           C:
  580.           Cd\WWIV
  581.           DEL FILES.TXT
  582.           TAM /LBADFILE.TXT
  583.           PKZIP -U -M C:\DLOADS\STUFF\LIST.ZIP C:\WWIV\FILES.TXT
  584.           TAM /LGOODFILE.TXT
  585.           PKZIP -U -M C:\DLOADS\GOODSTUF\LIST.ZIP C:\WWIV\FILES.TXT
  586.  
  587.           This batch file will look first for FILES.TXT and delete it if it
  588.           is found (so that it will not be appended to), then generate a file
  589.           listing using the area numbers located in the ASCII file called
  590.           BADFILE.TXT. It will move/update with PKZIP the resulting FILES.TXT
  591.           to the archibe LIST.ZIP in the C:\DLOADS\STUFF directory. Then
  592.           it repeats the process, but this time uses an area list contained
  593.           in the ASCII file GOODFILE.TXT and PKZIP update/moves that to
  594.           a different directory (like if you have one dir for good callers,
  595.           and one for generic anybody callers, for example).
  596.  
  597.           Note that if the /L switch is the *only* commandline parameter,
  598.           then TAM will never initialize and load its windows, but will
  599.           simply operate on the commandline. The /X is *not* required when
  600.           using the /L switch if generating a file list is all you wish to
  601.           do (as part of the external event, presumably).
  602.  
  603.           Also note that only one /L switch per call to TAM is allowed at
  604.           this time. Do not try and use two /L switches on the same call to
  605.           TAM. If you wish to generate multiple listings then use the above
  606.           sample batch file as an example of how to do so.
  607.  
  608. Example external event commandlines :
  609.  
  610.      TAM /SA /Z /X           { Sort all dirs alphabetically, size update  }
  611.                              { all dirs, then exit.                       }
  612.  
  613.      TAM /LALLFILES.TXT      { Generate a file listing based on the area  }
  614.                              { numbers contained in the file ALLFILES.TXT }
  615.  
  616. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  617.  
  618. This program is dedicated to those who have registered various programs with
  619. me: ESM and UEDIT mainly. Those people are the ones that make the Shareware
  620. concept work, and it is very much appreciated.
  621.  
  622. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  623.  
  624. Revision History:
  625.  
  626. v1.00   ■ First release other than as a prototype.
  627.  
  628. v1.01   ■ Bug fixes.
  629.         ■ Enhanced display.
  630.         ■ Easier extended description editing.
  631.         ■ Added help screen (F1).
  632.  
  633. v1.02   ■ Minor bug fix: if you moved a file to an area which had a 0-byte
  634.           extended description file, the file handle would not be released
  635.           and TAM would eventually crash.
  636.  
  637. v1.03   ■ Minor speed increase.
  638.         ■ Added configuration program for specifying paths to PKZIP and
  639.           turning on or off exploding windows and squeaky windows.
  640.         ■ Slightly lower memory requirements.
  641.  
  642. v1.04   ■ Overlays working properly now, so memory requirement reduced by
  643.           a significant amount.
  644.         ■ Kernel when executing external programs (including the DOS shell)
  645.           reduced to about 7.5k.
  646.         ■ Added /NOMEM option to virus-scanning.
  647.         ■ Added visual bar-graph display when moving files.
  648.         ■ Fixed date-related bug in the file-record editor.
  649.         ■ Added ability to view GIFs (with VPIC) by hitting "G".
  650.         ■ Made TAMCFG default to C:\UTIL\PROGNAME.EXT when run, so typing
  651.           in all the complete paths to the external programs is not necessary
  652.           if they exist in that directory.
  653.  
  654. v1.05   ■ Auto-inserts GIF resolution into file description if the GIF file.
  655.           actually exists on the hard drive.
  656.         ■ Fixed commandline bug when virus-scanning LZH or ARJ files.
  657.         ■ Made the "M"ove files command easier to use.
  658.         ■ Added "U"pload command at File Level, for doing the equivalent of
  659.           a //UPLOAD.
  660.         ■ Fixed another slight date-handling bug related to "N"-scanning the
  661.           file areas.
  662.         ■ Included a small WWIV 'C' modification to make it easy to run TAM
  663.           from within WWIV.
  664.  
  665. v1.06   ■ When "A"dding new file records, the date will now default to the
  666.           current date.
  667.         ■ The Sysop's name (if specified in INIT) is used by default when
  668.           "U"ploading files or "A"dding files, else a generic "Sysop" is used.
  669.         ■ Fixed the price when exiting on the unregistered version so it is
  670.           accurate (twenty dollars = $20.00, not twenty five dollars = $20.00).
  671.         ■ TAM used to crash if you tried to rename a file that actually existed
  672.           in DOS to the same filename as that of another file in that dir. This
  673.           will no longer happen.
  674.  
  675. v1.07   ■ Due to WWIV's keeping "junk" records in .DIR files, the "U"pload
  676.           feature could produce erratic results. This should be fixed.
  677.         ■ Shows a status window when "U"ploading, so if it takes a while, at
  678.           least you know it's working. (And in dirs containing *lots* of
  679.           records, it can take a while.)
  680.         ■ Installed a better runtime error handler, so if you get a runtime
  681.           error, TAM should exit gracefully after telling you what the error
  682.           is (and to contact me), rather than simply crashing. If you get
  683.           such an error, please let me know the circumstances and send me
  684.           the relevant .DIR and .EXT file(s), if any, so I can find and fix.
  685.         ■ Similar to renaming files, if you tried to name or rename a dir
  686.           area's .DIR file to the same name as an existing one, TAM would
  687.           crash. This has been fixed.
  688.  
  689. v1.08   ■ Extended descriptions are now properly deleted when deleting files.
  690.           They were not before, though this was not harmful.
  691.         ■ When copying files from dir to dir, the bar graph was enhanced.
  692.         ■ The runtime error handler was enhanced.
  693.         ■ TAM now keeps a fairly complete audit log. This file will be called
  694.           TAM.LOG and will be in the WWIV GFILES directory if you start TAM
  695.           in a dir containing CONFIG.DAT, else it will be in the current dir.
  696.           Be *sure* to spell out the *complete* path to your GFILES and DATA
  697.           dirs with WWIV's INIT program.
  698.         ■ Some of the windowing was inefficient, resulting in a window being
  699.           closed then immediately opened again with another prompt. This has
  700.           been improved.
  701.         ■ There may have been a bug with the extended descriptions when
  702.           moving files. If there was, it's gone now.
  703.  
  704. v1.09   ■ Audit file (TAM.LOG) improved - more informative and specific.
  705.         ■ The "M"ove file command should be faster now (increased size of
  706.           disk buffer).
  707.         ■ When TAM was run with no CONFIG.DAT present, it was reporting the
  708.           version number incorrectly. This has been fixed.
  709.         ■ Made the "U"pload sequence abortable.
  710.         ■ Added "U"pload command to Directory Level (so you can "U"pload to
  711.           newly created file areas without first moving a temp file into that
  712.           area).
  713.         ■ Changed TAMCFG so you can now specify the background character for
  714.           the "desktop" window.
  715.         ■ If you had two different areas that had the same path and you tried
  716.           to "M"ove one record to the other area, the net result was the
  717.           record *would* be moved but the file would be deleted. Now the file
  718.           will not be deleted if you do this and the record will be moved
  719.           properly.
  720.         ■ Extended descriptions may now be up to 18 lines long, for those
  721.           files that need a *lot* of extra describing. Note that WWIV's default
  722.           unmodified settings range from 0 to 10 lines for extended file
  723.           descriptions, so if you use more than 10 you will have to modify your
  724.           code to allow viewing of the additional lines.
  725.         ■ If you have file attributes set (hidden, read-only, whatever) then
  726.           these are preserved when moving files.
  727.         ■ Deleting files with hidden, read-only or other attributes is now
  728.           possible.
  729.         ■ The datestamp on files that are moved is now preserved.
  730.         ■ TAM will no longer load at all if there isn't enough memory to
  731.           initialize the various windows. If it can be *mostly* loaded then
  732.           you will at least be told how much RAM TAM needs (which depends on
  733.           the currently active video mode, normal 25-line mode requiring the
  734.           least memory).
  735.         ■ When "U"ploading, you may now upload files with the hidden, read-
  736.           only, and/or system attributes set. (So yes, you could define
  737.           C:\ as a file area's directory and put your DOS files themselves
  738.           up for download!)
  739.         ■ Added key command (F10) to tell you how much heap memory is
  740.           available, for informational purposes.
  741.         ■ You are now returned to the directory that TAM was first executed
  742.           from when returning from a DOS shell.
  743.         ■ Added ability to tag/untag directories.
  744.         ■ Added ability to "U"pload on tagged directories (this basically
  745.           provides the equivalent of a WWIV //UPLOADALL, but with some
  746.           added flexibility).
  747.         ■ TAM would not previously "U"pload properly to a directory whose
  748.           path was a root directory of a drive. This has been fixed.
  749.         ■ TAM can now generate a file listing for a single file area or on
  750.           a set of tagged file areas ("L" and "AltL" are the commands,
  751.           respectively).
  752.  
  753. v1.10   ■ Fixed another problem with moving file records for files that do
  754.           not actually exist in DOS.
  755.         ■ TAM now allows you to generate file listings from the command
  756.           line. See commandline documentation above.
  757.  
  758. v1.11   ■ Improved output of file listings.
  759.         ■ Fixed minor annoyance related to duplicate filenames when saving
  760.           file records.
  761.         ■ Fixed slight windowing-related bug where a window was removed
  762.           when it shouldn't have been.
  763.         ■ Upload problems? Probably fixed now. If TAM detects WWIV junk
  764.           records it will automatically clean them out now.
  765.         ■ Should now work with incomplete paths spelled out in INIT for
  766.           the DATA dir and such, though the path must still actually exist.
  767.           If the path does not exist, TAM will let you know.
  768.         ■ No more overlaying. TAM now needs about 285K to run. I suggest
  769.           running it in 25-line mode if you have more than about 800 files
  770.           in any one dir. No overalying should also boost performance some.
  771.  
  772. v1.12   ■ Fixed bug in TAM logfile, where it would repeat a statement when
  773.           moving tagged files, unnecessarily.
  774.         ■ Added ability to specify the default video mode TAM will use,
  775.           so that it doesn't necessarily use the current video mode. For
  776.           example, we run our board in 50-line mode, but I like to run
  777.           TAM in 25-line mode. This ability saves the trouble of having
  778.           to use Norton's or something to switch to 25-line mode and then
  779.           back. Make sure to run the new TAMCFG!
  780.         ■ TAM now displays the number of kilobytes free on the drive which
  781.           it is executed from, rather than the date.
  782.         ■ System Information (F10) now displays a bit more information. This
  783.           was added primarily for debugging, but I left it in for the release
  784.           since the information is potentially useful to anyone.
  785.         ■ Heightened DesqView awareness. Should run more smoothly under
  786.           DesqView. The System Info screen will show you what version (if
  787.           any) of DesqView is loaded.
  788.         ■ When at the File Level, if a file does not exist on the drive (ie,
  789.           it is offline), then the filename will be displayed in red on
  790.           lightgray rather than (normal) black on lightgray. Much easier to
  791.           spot offline files.
  792.         ■ The modification to easily interface TAM and WWIV has been revised
  793.           and improved.
  794.  
  795. v1.13   ■ If you tried to "U"pload to an area that contained no WWIV records
  796.           *and* contained no files in the directory, you'd get some garbled
  797.           junk. This has been fixed.
  798.         ■ A little more stuff was added to the System Info screen.
  799.         ■ The time display is updated a bit more consistently when waiting
  800.           for a keypress (at prompts).
  801.         ■ If you run out of memory during a sort, the error message is now
  802.           more understandable. (I run out of memory with between 2100 and
  803.           2200 records in one file area, about four times WWIV's default.)
  804.         ■ Memory requirements actually reduced somewhat. Not much, but by
  805.           about 8k. Hey, ever 1k counts.
  806.  
  807. v1.14   ■ "U"pload on tagged directories is now much more abortable (with
  808.           the spacebar).
  809.         ■ Now shells to UEDIT.EXE (with "w" command at File Level) if
  810.           UEDIT.EXE exists in the default dir. Auto-loads that user's
  811.           record for editing/viewing.
  812.         ■ There was a bug in relation to adding the GIF resolution where if
  813.           the description became too long, unapproved memory locations would
  814.           be written over, causing system instability. This has been fixed.
  815.  
  816. v1.15   ■ User-definable function keys. You can now specify programs that
  817.           will be shelled to when you hit the F2-F9 keys (F1 is reserved for
  818.           help and F10 is reserved for System Info). The key assignments
  819.           are shown on the System Info screen. See above documentation. This
  820.           is a *very* nice addition (and a big one on my part).
  821.  
  822. v1.16   ■ There was a stack overflow problem when editing extended descrip-
  823.           tions from the file editing window. This should be fixed.
  824.         ■ Extended descriptions, if WWIV has them toggled on but no such
  825.           description exists, will now be toggled off properly.
  826.  
  827. v1.17   ■ Vastly improved the configuration program. I recommend deleting
  828.           TAM.CFG and running TAMCFG.EXE again. You don't have to keep
  829.           re-entering the same stuff each time you run TAMCFG anymore - it
  830.           saves the old config info. TAMCFG looks 1000% better too, and has
  831.           smarter default settings.
  832.         ■ TAM now searches your DOS path when executing externals, so if
  833.           you do not specify the full path to PKZIP (or LHA or whatever) in
  834.           TAMCFG, it will still work if the program *name* you specify does
  835.           exist in your path. Likewise UEDIT.EXE and AVIEWCOM.EXE need not be
  836.           in the WWIV dir, as long as they're in your path.
  837.         ■ You can now rename a file record's filename to that of a file that
  838.           does exist if the file by the name of the original record does
  839.           *not* exist. In other words, if you drop to DOS (or use a function
  840.           key call) to convert FILENAME.ZIP to FILENAME.ARJ, so that the
  841.           former no longer exists except in WWIV's .DIR file, then you can
  842.           rename it properly in WWIV's .DIR record to FILENAME.ARJ.
  843.         ■ Alt-X now exits without a verification prompt from basically
  844.           anywhere, for you efficiency nuts.
  845.         ■ Since there's an "unlimited number of file areas" modification
  846.           floating around, the number of file areas that TAM will now
  847.           directly support has been raised to 256, which should be enough
  848.           for anyone, even if you have several gigabytes of storage space.
  849.         ■ If you did a tag-upload on several dirs, the desktop window could
  850.           be erased, revealing DOS (or whatever) behind it. This should be
  851.           fixed (though it was a cosmetic thing anyway and didn't really
  852.           affect functionality).
  853.         ■ There was an obscure DesqView-related bug that came into effect
  854.           when moving files. This should be fixed.
  855.  
  856. v1.18   ■ Argh. Fix one bug and create another. There was a *major* bug in
  857.           sorting in 1.17 which I somehow created when hunting down the
  858.           DV/moving files bug. It's fixed.
  859.  
  860. v1.19   ■ TAM.LOG deleted. Since you're there when you use TAM, you know what
  861.           you're doing and what you did.
  862.         ■ TAMCFG reads current configuration for exploding windows. In other
  863.           words, if you have exploding windows turned off then TAMCFG will
  864.           not use exploding windows itself when you run it.
  865.         ■ Zip commenting is now supported, as well as uncommenting.
  866.         ■ Function keys can now access replaceable parameters referring to
  867.           the file area directories at the Directory or File Level, rather
  868.           than just the filename, user who uploaded, and system uploaded
  869.           from. See function keys above. All replaceable parameters are
  870.           available at the File Level.
  871.         ■ EMS status, if you had EMS, was being reported inaccurately. It
  872.           should now be accurate.
  873.         ■ For expedience, hitting the enter key at the Directory Level now
  874.           moves you to the File Level. You can still edit the directory
  875.           record with the "E"dit command at the Directory Level.
  876.         ■ Internal format of TAM.CFG changed, so make sure to delete your old
  877.           one and re-run TAMCFG. I know, I know, a pain - I had a hard drive
  878.           crash and had to do a bit of reconstruction and my memory wasn't
  879.           good enough to reconstruct the configuration record structure
  880.           exactly, so it's different internally now. Another episode in the
  881.           "Backup-or-scream" series.
  882.         ■ You can now "A"dd a file to an area that you know exists in that
  883.           DOS directory, without receiving an error message.
  884.         ■ At the File Level, the space bar now toggles a file as tagged or
  885.           untagged then automatically cursors to the next record. The "t"
  886.           command toggles the tag status of a file but does not go to the
  887.           next record automatically. Use whichever is easiest for you. The
  888.           same commands work at the Directory Level but toggle the tag
  889.           status of file areas, rather than file records.
  890.         ■ Can now sort areas alphabetically by extension. The extension
  891.           takes precedence using this sort method. In other words, all EXE
  892.           files and GIF files would be listed before all ZIP files. All
  893.           EXE files would be together, sorted alphabetically. Ditto for the
  894.           other extensions, if any.
  895.  
  896. v1.20   ■ You can now move the location of a file area in the list with
  897.           Alt-M at the Directory Level. Handy for rearranging the order of
  898.           your file areas.
  899.         ■ When you "A"dd a new file area, the directory will be created if
  900.           it is possible to do so. For this to work, however, the complete
  901.           path to the directory *must* be spelled out when editing the
  902.           file area's record. For instance if you "A"dd a new area and
  903.           specify the path to the directory as "C:\AAA\BBB\CCC\DDD\" then
  904.           those directories, or as much of them as hadn't already been
  905.           created, *would* be created. Saves you the time of shelling out
  906.           and creating the directory structures manually. If you simply
  907.           edit an existing file area and change the directory path, the
  908.           directory will *not* be created for you automatically. Moving
  909.           files (if any) and creating that directory is up to you.
  910.         ■ The number of files in each area is now shown on the Directory
  911.           Level display window in a separate column. Easier to see how
  912.           many files are in each area than entering File Level when you
  913.           want this information.
  914.         ■ Added two File Level commands: Alt-K copies the current file
  915.           record's file description to a virtual clipboard and Alt-P pastes
  916.           the description on the clipboard onto the current file record's
  917.           description. Handy for files with similar descriptions, such as
  918.           "QModem, version 4.5, disk 1 of 3", etc.
  919.         ■ When returning from a shell to an external program, occasionally
  920.           there would be something left in the keyboard buffer. This should
  921.           now be fixed.
  922.         ■ If you run TAMCFG.EXE in a shell (or via an F-key call) then the
  923.           settings are re-read when you re-enter TAM. However, the "squeaky
  924.           windows", exploding windows settings etc are only implemented
  925.           once. What *is* re-read that's important are the F-key settings;
  926.           it's now easy to run TAMCFG and have the changes take immediate
  927.           effect on the F-key settings.
  928.         ■ There was a bug related to using 'O' as a DAR for a file area when
  929.           editing directory records. This is fixed.
  930.  
  931. v1.21   ■ There was a minor bug that would show a huge number of files in an
  932.           area at the Directory Level if you removed *all* of the file records.
  933.           TAM now reports 0 files when you do this, as it should.
  934.         ■ Another minor bug: if you moved a 0-byte file, you'd get a runtime
  935.           error. This is fixed - no error and the file and record are moved
  936.           as normal.
  937.         ■ TAM now comes with TAMPOP, a small swapping TSR that allows a shell
  938.           to TAM from within basically any application, using almost all
  939.           free memory, using a hotkey (Alt-T is the default for TAMPOP).
  940.           TAMPOP also allows Alt-D for a high-memory DOS shell from within
  941.           pretty much any application and because of this, its use is
  942.           greatly increased. It gives an extra 250K or so for a DOS
  943.           shell under Telix, for example, over Telix's own DOS shell.
  944.         ■ TAM will now use XMS memory for some (most) of its shells to
  945.           external programs, if any is available. When swapping out, TAM
  946.           tries to use EMS first, then XMS, then disk.
  947.         ■ If you shelled to DOS and were in a different directory than the
  948.           one you originally started in, a TAM.CFG would be created in that
  949.           dir when you exited from the shell. You are now returned to the
  950.           original directory first, so a TAM.CFG will only be written if
  951.           you deleted the one there when in the shell.
  952.         ■ There was some erratic bug when virus-scanning. This should be
  953.           fixed.
  954.         ■ There was a problem with some commandlines to external programs
  955.           being too long for DOS to handle. This is now trapped and an
  956.           error message generated (so you know to shorten some paths).
  957.         ■ For CGA users, the colors shouldn't be as bad as they must've
  958.           been before. The display is checked first to see if it's EGA/VGA
  959.           before assigning high-intensity background colors to anything.
  960.  
  961. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  962.  
  963. Special Thanks:
  964.  
  965. The following people have been helpful in one way or another and are due some
  966. sincere thanks:
  967.  
  968. Alter-Ego      - For finding the extended description/stack overflow bug.
  969. Dawg           - For convincing me to add the GoldSys support.
  970. Dr. Spine      - For pointing out bugs, lots of them.
  971. Frank Reid     - For >invaluable< suggestions for improvements.
  972. Ken Carpenter  - For locating the DV/moving files problem and other stuff.
  973. Luke Nihart    - For finding a couple of bugs and being informative about
  974.                     the details.
  975.  
  976. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  977.  
  978. Hints and tips:
  979.  
  980. 1) If you run TAM from DOS, use SHROOM.COM to load it. Then when it shells to
  981.    external programs, it leaves only an 8K kernel in memory. If you don't
  982.    use SHROOM, TAM still removes most of itself from memory, but SHROOM is
  983.    more efficient if you're memory-constrained.
  984.  
  985. 2) Since batch files will work as user-definable settings for the function
  986.    keys, if you wish to comment a file (rather than uncomment), then you
  987.    can create a program that calls any program of your choice for commenting.
  988.    This isn't necessary for ZIP files since commenting and uncommenting are
  989.    already functional for ZIP files.
  990.  
  991. 3) If you wish to convert a file to another archive type, there is (so far)
  992.    no simple way to do this. The best way at the moment is to create a batch
  993.    file that does the work and takes a filename as a parameter, then define
  994.    one of the definable function keys to call that batch file. Then simply
  995.    edit the record's filename to reflect the new archive extension.
  996.  
  997. 4) The letter commands are case-sensitive. If you have your CAPS LOCK on,
  998.    then many of the commands will not work. The simple solution, obviously,
  999.    is to not leave your CAPS LOCK on. There were practical reasons for doing
  1000.    it this way, believe it or not, and it's not a problem or a bug, just
  1001.    the way it is.
  1002.  
  1003. 5) If you wish to change the path of a file area, the best way to do this is
  1004.    to "A"dd a new file area with the path you desire, then "M"ove all the
  1005.    files from one dir to the new one - then "D"elete the original dir. This
  1006.    will allow you to have the complete path created for you automatically.
  1007.  
  1008. If you have other potentially valuable hints and tips, or useful batch files
  1009. to use as F-key settings, please mail me and I will include them here for
  1010. others.
  1011.  
  1012. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  1013.