home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TGUP131.ZIP / TGUP.DOC < prev    next >
Text File  |  1993-06-01  |  9KB  |  270 lines
  1. Documentation for TGUpload V1.31
  2. ===============================
  3. READ ALL OF IT !!! The online help is NOT complete !!!
  4.  
  5. !!! THE MOST ADVANCED LOCAL UPLOAD PROCESSOR FOR TELEGARD 2.7 !!!
  6. -----------------------------------------------------------------
  7. ... and the most AWESOME thing i've seen so far !
  8.  
  9. Features :
  10.  
  11. - upload in one or more directories.
  12. - sort all or single filebase(s), rewrite and therefor pack them.
  13.   this way no need for extra filepackers
  14. - powerful browse mode : view nearly all data of a file-record, just
  15.   press return and u can edit it.
  16. - easy handling.
  17. - automatically inserts FILE_ID.DIZ if file is in ZIP format.
  18.   (In fact, it grabs the most information it can pack into TG's
  19.    limited space - that are 260 chars )
  20. - automatically inserts GIF specs when ul'ing new GIFs
  21. - if entering a verbose description and saving the record, TGUpload
  22.   searches for a free record in VERBOSE.DAT instead of just appending.
  23.   This will take a moment if u have a large VERBOSE.DAT, but this
  24.   way u allways have used your precious hard-drive to the best.
  25. - if one of TG's download dir's points to a cd-rom, it will be skipped.
  26. - if waiting for keyboard input, TGUp gives its free time back when
  27.   running under a multi-tasking environment such as DesqView (tm),
  28.   Windows etc.
  29.  
  30. Warranties : NONE ! Use at your own risk !
  31.  
  32. I strongly recommend to make a backup, just to make sure that TGUP works
  33. save on YOUR system too !
  34.  
  35. Requirements :
  36. ==============
  37. - A BBS running Telegard 2.7
  38. - Some Ram (i have successfully testet it running in a DV Window w/ 500k
  39.   free)
  40. - COMSPEC environment variable must be set.
  41. - PKUNZIP has to be on the path.
  42.  
  43. USAGE :
  44. =========
  45.  
  46. Well, here we go... though i'm german and my english is probably not the
  47. best, i'll try everything that you understand at least the basic operation
  48. of TGUP. The online help system is currently NOT covering every possible
  49. action you can do w/ TGUP, so be sure to read EVERYTHING closely !
  50.  
  51. Brief overview over availabale keys :
  52.  
  53. while at the MAIN screen :
  54. ==========================
  55.  
  56. ALT-A - start a simple, global search routine. currently searches only
  57.         the filenames.
  58.  
  59. ALT-F - global "fix" of the file-records.
  60.         fixes on/offline, when online filesize is also fixed.
  61.         fixes ul'ed date (in string format) -> to numeric date that
  62.         TG uses.
  63.  
  64. ALT-S - global sort'n'rewrite of the filebases.
  65.         all filebases are read-in and writed back in sorted order
  66.         (filename ascending).
  67.  
  68. ALT-U - local ul-mode
  69.  
  70. while in browse mode :
  71. ======================
  72.  
  73. ALT-C - clear tags.
  74.  
  75. ALT-D - delete file(s) - records and optional physical.
  76.  
  77. ALT-F - fix current filebase
  78.  
  79. ALT-M - move file(s) to selected destination dir
  80.  
  81. ALT-S - sort'n're-write current filebase
  82.  
  83. ALT-T - toggle On/Offline on high-lighted or tagged files
  84.  
  85. ALT-V - toggle validation on high-lighted or tagged files
  86.  
  87. TAB, Cursor Left/Right
  88.  
  89.       - switch display to one of three different data screens
  90.  
  91. Cursor Up/Down
  92.  
  93.       - scroll one filerecord up/down
  94.  
  95. Pg Up/Down
  96.  
  97.       - advance one page up or down
  98.  
  99. CTRL-Pg Up/Down
  100.  
  101.       - jumps to beginning/end of the filebase
  102.  
  103. Any Alphanumeric Key jumps to the first matching filename (if there is one)
  104.  
  105. RETURN
  106.  
  107.      - lets u edit current record
  108.  
  109. SPACE
  110.      - Tag current record
  111.  
  112. Uploading files :
  113. =================
  114.  
  115. Select one Filebase (by highlighting it trough moving w/ the cursor keys)
  116. and hit RETURN or select several Filebase by tagging them w/ SPACE and then
  117. hit RETURN.
  118.  
  119. If that filebase doesn't exist, it will be created automatically !
  120.  
  121. If TGUpload finds anything that is not yet in the TELEGARD Filebases, you're
  122. prompted to ul it. You can then enter either (y/ENTER) or (n/ESC).
  123. TGUpload DOESN'T find files like 4DOS DESCRIPT.ION files (which has
  124. the HIDDEN attribut) like TG does. I'd allways found that annoying.
  125.  
  126. Now, if you're about to edit a record, TGUpload starts there in the
  127. field for the description and then moves (by RETURN or CURSOR DOWN) to
  128. the verbose description. If you want to edit ul'ers name and such stuff,
  129. move to those input fields from the first line of the verbose description
  130. using CURSOR UP. But i don't think that you will have to in most of the
  131. cases because TGUpload suggests all relevant data.
  132. If you'd made a mistake, just hit ESC and TGUpload will abort editing
  133. the current file and skips to the next in the queue (if there is any).
  134.  
  135. Starting BROWSE mode :
  136. ======================
  137.  
  138. Just high-light the filebase you want to browse and press return.
  139. You can now navigate through the filebase using the cursor-keys,
  140. pg up/down, ctrl-pg up/down, the TAB key or just press return on
  141. a high-lighted record if you want to edit it.
  142.  
  143. You may also tag one or more filerecords and perform DELETE or MOVE
  144. actions on them... or do the same thing w/ a high-lighted record
  145. (if no others have been tagged!)
  146.  
  147. If you press ALT-V on a filerecord and this file hasn't been validated
  148. yet AND the usernumber is <> #1 then you're show the file-data of that
  149. user and asked if you wanted to credit him/her.
  150. This action can be done on either high-lighted or tagged files.
  151.  
  152. Pressing ALT-T on a filerecord simply toggle the filestatus for that
  153. file from on- to offline and vice versa.
  154. This action can be done on either high-lighted or tagged files.
  155.  
  156. ALT-Z invokes a DOS-Shell with the COMSPEC specified command processor.
  157. TGUP swaps automatically to XMS/EMS/DISK (if it swaps to disk, it chooses
  158. the swap path specified in STATUS.DAT).
  159.  
  160.  
  161. Leaving BROWSE mode :
  162. =====================
  163.  
  164. Just press ESC...
  165.  
  166. While you're back at the Filebase selection box, hitting ESC ends the program.
  167.  
  168. Registration:
  169. =============
  170. I'd appreciate ANY amount for the work that i put into this project.
  171. The program has NO limits and delays anyways, so it's up to you
  172. supporting MODEM WORLD BBS with a donation or not.
  173.  
  174. Distribution:
  175. =============
  176. Is limited to BBS which charge nothing for dl'ing this file (except a usual
  177. ul/dl ratio there maybe).
  178. It is under no circumstances allowed to distribute via shareware/pd vendors!
  179. For offering it on a CD-Rom u should contact the author for permission (not for
  180. a fee of course)
  181.  
  182. Author :
  183. ========
  184.  
  185. Joern Knechtel
  186. Rhoenstr. 10
  187.  
  188. 8750 Aschaffenburg / Germany
  189.  
  190. Email : MODEM WORLD BBS  ++49-6021-92200  Fido 2:249/26
  191.  
  192.  
  193. Credits :
  194. =========
  195.  
  196. Thnx Martin Pollard (and the rest of the crew :-) for
  197.      writing Telegard.
  198. Thnx also TechnoJocks for their TTT toolkit.
  199. Thnx also Phil Katz for PKZip, which offers by far the best
  200.      compression/speed performance.
  201. Thnx to ABSoft for their TPMULxxx and TPGIFxxx *.TPU's
  202. Thnx to Ralf Brown for his great work : both, the Interrupt-List
  203.      and his SPAWN() function.
  204.  
  205.  
  206. History :
  207. =========
  208.  
  209. After 2 years of waiting that one of those guru's makes the TG sysops
  210. happy w/ something that is really working...
  211.  
  212. V1.0  - Initial Release   04/05/93
  213.  
  214. V1.1  - BugFix : V1.0 exits w/ a run-time error if to many
  215.                  Filebases have been tagged.
  216.  
  217.         Now allows entering a verbose description too.
  218.  
  219. V1.2  - Now suggests automatically a description if the file
  220.         to be uploaded is in ZIP format and contains FILE_ID.DIZ.
  221.         This will save a lot of work i guess...
  222.  
  223. V1.21 - Forgot to save the correct numerical date to the file-records,
  224.         this has been fixed.
  225.  
  226. V1.22 - Fixed incorrect display of TG's MCI colors when searching a dir
  227.         for new files.
  228.         - FIRST PUBLIC release
  229.  
  230. V1.23 - added Browse Mode     (now it grows more & more into a real
  231.                                filemanagment tool instead of a simple
  232.                                upload)
  233.         added filebase sorting
  234.         fixed error that exits TGUp when running w/ command.com
  235.  
  236. V1.24 - added automatic insertion of GIF specs when uploading new
  237.         GIFs.
  238.       - fixed error that exits when a filebase is setup, but hasn't
  239.         been created... TGUp now creates this first record automatically.
  240.  
  241. V1.25 - added best fit fill logic for FILE_ID.DIZ
  242.       - added moving of files
  243.  
  244. V1.26 - oops, moving of files if source & destination path were the same
  245.         resulted in a loss of files - fixed (and now forbidden).
  246.       - fixed again (and hopefully the last time) a bug w/ the numeric date.
  247.       - added XMS/EMS/Disk swapping routine when searching for File_ID.DIZ
  248.         - this makes TGUp a little less memory dependant.
  249.  
  250. ... several bugs fixed (and i'm sure there are still some :)
  251.  
  252. V1.29 - added "i was born under a wandering bar" :-) for sorting and fixing
  253.         file base commands.
  254.       - fixed an anoying bug that was reported by my beta-tester Mario
  255.         Carrano, but never (Nearly never :-) happened to me, which
  256.         allowed files being ul'ed multiple times in the same dir.
  257.  
  258. V1.30 - the SECOND PUBLIC release. (oops ? no, sorry :-)
  259.  
  260. V1.31 - added a DOS-Shell for the Browse-Mode
  261.       - skipps FILES.BBS when uploading files
  262.       - when validating a User, FilePoints are added according to the
  263.         settings in Syste-Setup.
  264.       - when fixing single or all filebases, filepoints are set
  265.         according to their setting in System-Setup
  266.  
  267.  
  268. ...and still a long way to go...
  269.  
  270.