home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / tagbet.zip / WHATSNEW.ENG < prev   
Text File  |  1995-03-15  |  20KB  |  547 lines
  1. Readme for OffTag 1.1 Beta/6
  2. New Features of Beta/6 (compared to Beta/5) are marked with Beta/6:
  3.  
  4. OffTag 1.1 Beta/6 is a complete version. You don't need OffTag 1.0.
  5.  
  6. Upgrade from 1.0:
  7. ================================
  8. 1. Backup Old version
  9. First save your old 1.0 Tagger.exe and tagger.cfg somewhere, so you can step
  10. back in case of a severe error in this beta.
  11.  
  12. 2. Copy Executables
  13. Then put the new exe's in your tagger directory and put the new EMX.DLL (and
  14. the RXANSI.DLL) where you typically store your DLL's. Be sure to erase
  15. (or replace) all older EMX.DLL on your drives.
  16. (Credits go to S.Mullarkey for his RXANSI.DLL)
  17.  
  18. 3. Adjust Tagger.cfg
  19. If you have a customized color setting, you can use config.cmd to complete the
  20. the new tokens.
  21. CONFIG.CMD is new (still limited to some sections) and allows to
  22. define tagger.cfg interactive with some little help. It will be completed
  23. in the release version.
  24.  
  25. 4. Update language files
  26. If you customized your language files you may compare it to the new english.lng
  27. for the new tokens used. If you used the original one then simply copy it
  28. over.
  29.  
  30. 5. Start Tagger.exe
  31. If you start Tagger.exe it should begin rescanning your filebase (if you
  32. enabled the filebase-feature).
  33.  
  34. 6. Continue.
  35. I hope it all runs now ;-). Now you can (if you want) take a look at the new
  36. features of OffTag 1.1 (beta/6) below.
  37.  
  38. Upgrade from beta/5:
  39. ====================
  40.  
  41. 1. Copy tagger.exe, tagserve.exe and update emx.dll (it is now version
  42.    0.9a fix02).
  43.  
  44. 2. Copy tagger.hlp, tagger.hlf, english.lng, deutsch.lng.
  45.    (you need to update the language files because there's the new menu-
  46.     option "Global Find" in the area-menu)
  47.  
  48. 3. Copyfile.cmd, viewit.cmd and getid.cmd now read a file (filepath.cfg)
  49.    which holds common path info.
  50.  
  51.  
  52. Bugs fixed:
  53. ===========
  54.  
  55. Tagger trapped when the "Pick up new Files" function was used on ".." in the
  56. Allfiles or Newfiles List.
  57.  
  58. An %TAG ALIAS definition at the end of the last include-file of the
  59. filearea.ctl let the Tagger wait forever on RESCAN.
  60.  
  61. The Carrier Detect didn't work in beta/5rev3 (this was TAGFIX06).
  62.  
  63.  
  64. Tagger hung on exit or logged a 3171 in SYSPOPUP.LOG when run under Warp
  65. (in beta/5  previous to beta/5rev2).
  66.  
  67. The Access-Level "Hidden" was not recognized.
  68.  
  69. "Goto" aborted OffTag when used in an unsorted all- and newfiles lists.
  70. The include statment did not work multiple times in one file.
  71. /t /b or /tb will be recognized and treated right now.
  72. The "Hidden" Access-Level is now recognized.
  73. Downloadcounters holding '-' instead of spaces or zeroes are recognized now.
  74.  
  75. The Area (of beta/4) grouping had bugs. Groups with no Fileareas in them had
  76. not been shown. And OffTag crashed if the area description was longer than
  77. about 100 chars.
  78.  
  79. OffTag 1.0 did not show the files when entering areas when running in
  80. Warp Beta II, it could not open for some reason the files.bbs files.
  81. This is fixed, but i don't know why ;-), perhaps because i used a newer
  82. compiler version.
  83.  
  84. New Feature 1: External Functions:
  85. ----------------------------------
  86. Now users of Offtag can issue an external function when in the filemenu
  87. (typically an archive viewer).
  88.  
  89. If you use a language File you have to add a letter (e.g. "V") to the
  90. filemenu string in this file.
  91.  
  92. Add those Lines to your tagger.cfg.
  93.  
  94. External
  95.   VIEWIT.CMD
  96. End
  97.  
  98. This will spawn VIEWIT.CMD if the user issues the extern-command (e.g. when
  99. pressing "V". The VIEWIT.CMD i provided will list zip,arj and lzh contents and
  100. dump any other file to the user.
  101. YOU HAVE TO ADJUST THE PATHS TO THE ARCHIVERS IN VIEWIT.CMD ;-)
  102.  
  103. New Feature 2: File-Manager:
  104. ----------------------------
  105. When passing the Parameter "FILEMANAGER" to the tagger it gets into File-
  106. Manager Mode. There you can Move/Copy/Kill Files in different Areas.
  107. Also included is a Dupe-Listing mode (just like New-Files, but it checks for
  108. dupes in your file-base).
  109.  
  110. As this is a beta, be careful. The Kill command actually deletes Files.
  111. Also backup your files.bbs files. I tried to stay on the safe side and
  112. the tagger creates a *.bak of the files.bbs if it changes it.
  113.  
  114. Warning:
  115. Be sure to enable the start with the "FILEMANAGER" parameter only to people
  116. with sysop status because this mode allows sight and action (including
  117. Kill) on ALL defined file-areas.
  118.  
  119. The Dupelister:
  120.   Lists Files which appear more than one time in either the whole filebase
  121.   or in one group of areas (if you entered one). This is done either by
  122.   matching the filename only or filename+extension.
  123. beta/6:
  124.   The Dupelister always lists the area-title even when the list is sorted.
  125.   So some area titles may appear multiple times.
  126.  
  127. File-Manager actions:
  128.  
  129.   The File-Manager acts only on the files of one area. If the Display-Mode
  130.   includes multiple areas the tagger takes the area of the currently
  131.   highlighted file. This may be irritating on sorted lists when files
  132.   of different areas follow directly.
  133.   Also the actions ONLY work if a file is highlighted (not on '..' and
  134.   not on Area-Headlines) except for the PickUp option.
  135.  
  136.   If some files in this area are tagged the actions will work on the
  137.   tagged files of the area (not on tagged files in any other area).
  138.   If no file is tagged in the area they work on the highlighted file.
  139.  
  140. Move:
  141.   Moves the file(s) to another filearea which can be selected. This is
  142.   actually done by first Copying the File to the destination area and
  143.   then Killing the File in the source-area.
  144.  
  145. Copy:
  146.   This is a Dupe-Producer, it has been requested so i implemented it.
  147.   Same as Move without deleting the Source.
  148.  
  149. Kill:
  150.   Will erase the selected file(s) out of the files.bbs and from the disk.
  151.   You will be prompted for Yes/No before the files are killed.
  152.  
  153. Edit:
  154.   Edit the file description.
  155.   Additionally you can now Replace the description by the contents of a
  156.   description file (e.g. File_Id.Diz). See the Tagger.Cfg part for more info.
  157.  
  158. PickUp:
  159.   Adopts new files (present in the areas downloadpath) in the filelist.
  160.   See the Tagger.Cfg part on information how to exclude specific files
  161.   from adopting.
  162.  
  163. Drop:
  164.   Deletes a file out of the files.bbs. But it stays physically on the disk.
  165.  
  166. Rename:
  167.   In work.
  168.  
  169. DriveInfo:
  170.   Lists the Size and Free Space of all Drives stated in the tagger.cfg
  171.  
  172. The Tagger filebase is updated on leaving the tagger.
  173. Tagger also creates a file called "areascan.log" which holds the changed
  174. areas. This can be used with utilities (like fbp.exe).
  175.  
  176. Known Error: The filebase is not updated (yet) when Tagger exits via
  177.              Timeout or Carrier loss.
  178.  
  179.   Get Description:
  180.     While Adopting New Files or Editing existing Files you can get the File-
  181.     Description out of the Archive. The provided cmd-file GETID.CMD does this.
  182.     More about this in the TAGGER.CFG news, below.
  183.  
  184.   Limited Filemanager Rights:
  185.     You can restrict each Filemanager function to a specified Userlevel.
  186.     More about this in the TAGGER.CFG section.
  187.  
  188.  
  189. New Feature 3: Shared Memory Server:
  190. ------------------------------------
  191. Especially for BBS's with many files, the start up of OffTag took quite a
  192. while. I re-engineered the internal structures and memory-management to offer
  193. maxmimum performance for big filebases. But i added also the "Shared Memory
  194. Server" which significantly speeds up loading and which let's the Tagger
  195. hog less memory on Multi-Node systems.
  196.  
  197. It works like this:
  198.   You start TAGSERVE.EXE which will stay running in background all the time.
  199.   TAGSERVE loads the Filebase into Memory and will offer it to all Tagger
  200.   Sessions which are started on the same computer.
  201.  
  202.   Each Tagger session itself mirrors some essential information (which is
  203.   stored in the filebase.dat) from the shared memory pool and accesses the
  204.   Data (these are the contents filebase.dmp) of the shared memory whenever
  205.   needed. So the loading time will reduce to some memory transfer and perhaps
  206.   some time for swapping in (if needed parts of the memory pool had been
  207.   swapped out).
  208.  
  209.   TAGSERVE itself will remark when the filebase has been changed by UPDATE,
  210.   RESCAN or the filemanager and reload the filebase.
  211.  
  212.   If you do not use the default name "FILEBASE" or you use another path
  213.   for the filebase than the default (current) path you can pass the name
  214.   with the parameter "FILEBASE=<Name>" to TAGSERVE.
  215.     Example:
  216.       TAGSERVE FILEBASE=c:\base\mybase
  217.  
  218. New Parameters:
  219. ---------------
  220.   FILEMANAGER     starts the Tagger in the Filemanager Mode
  221.                   ! All File-Areas can then be seen, altered
  222.   STARTALLFILES   starts the Tagger immediately in the allfiles-list
  223.   STARTNEWFILES   starts the Tagger immediately in the newfiles-list
  224.  
  225.   WRAPATCR        Ideal for Graphical FILE_ID.DIZ in multi-line descriptions.
  226.                   This wraps the description display (in WRAP mode) like in
  227.                   the files.bbs. (needs a rescan to work)
  228.  
  229.   CLEANUPDESC     This will eliminate all Non-Ascii chars (<32 and >127) in the
  230.                   file-description and also multiple spaces. This can help
  231.                   speed up tagger loading and reduce memory utilization when
  232.                   many file_id.diz's are in the files.bbs.
  233.  
  234.   UPDATE=<Area1>,<Area2>,....
  235.                   Partial Rescan only for the stated areas. Faster than a
  236.                   usual Rescan. Be sure not to include any spaces in this
  237.                   expression.
  238.                   Example: UPDATE=UPLOADS,F100,AC-FILES
  239.  
  240.   SHOWPROGRESS    Shows litte dots, as the tagger loads :)
  241.  
  242.   WAITTRANSMIT    This new feature lets the tagger react more directly on user
  243.                   keystrokes. It checks OS/2's send-buffer and will wait on
  244.                   transmitting data until the send-buffer is nearly empty.
  245.                   Especially for low-speed modem users this provides a
  246.                   substantial increase in performance. I recommend to
  247.                   enable this feature immediately :) (put it in the parameter
  248.                   section of tagger.cfg).
  249.  
  250.   DESCID=         Descid already existed, but now Descid can optionally
  251.                   be defined as multiple chars. E.g. DESCID=" |"
  252.  
  253.   COMMENTID=      This is really new. This statement allows to include
  254.                   comments of your FILES.BBS in the Tagger Filelist (only
  255.                   in unsorted view).
  256.                   Example: COMMENTID="- "
  257.                   A RESCAN is needed to include the comments.
  258.  
  259.   DEBUGRESCAN     This comment shows some info when the tagger does a rescan
  260.                   perhaps useful, perhaps not ;-).
  261.  
  262.   GRAPHICS=[1/0]  OffTag offers now a charset for Non-Ibm Users, this is
  263.                   usually read of the lastusxx.bbs, but can be overridden here.
  264.                   GRAPHICS=0 sets the Non-Ibm Charset.
  265.                   (Note: In local mode you will always see graphics chars,
  266.                    no matter what graphics parameter is set)
  267.  
  268.   VIDEO=[0,1,2]   This Overrides the Users Video-Setting. OffTag will use
  269.                   Ansi for 0 and 1 [TTY and ANSI] and AVATAR for Value 2.
  270. beta/6:
  271.   NOSHAREDMEM     If this Parameter is specified, OffTag won't use the
  272.                   Shared-Memory Filebase, even if Tagserve is running.
  273.  
  274.  
  275. New in tagger.cfg:
  276. ------------------
  277.   Miscellaneous Section
  278.   ---------------------
  279.   desclimit <n>
  280.  
  281.   e.g. desclimit 80
  282.   This statement limits the maximum length per file description which is
  283.   stored in OffTag. This can reduce (like cleanupdesc) the filebase and
  284.   thus speed up loading and reduce memory use of tagger at the cost of
  285.   information. The internal limit of OffTag is 1000 chars.
  286.  
  287.  
  288.   usecreationdate
  289.  
  290.   Forces the tagger to use the Creation Date of a file instead of the
  291.   Last Write Date. If the Creation Date is zero however (e.g. on
  292.   FAT-Partitions) the Last Write Date is taken.
  293.  
  294.   nodownloadmenu
  295.  
  296.   Tagger starts immediatly when Download is selected. It uses the first
  297.   Protocol-Definition in the Protocols section.
  298.  
  299.   bbsdesclimit
  300.  
  301.   Limits each line edited in filemanagermode to this length.
  302.  
  303.   (beta/6)
  304.   Protocols Section
  305.   -----------------
  306.   A new Keyword which has to be stated to be first (see tagger.doc for details)
  307.   when used.
  308.  
  309.   Local/Extern: Specifies if Menu-Option is for local or external use.
  310.                 If not specified the option is displayed in both cases.
  311.  
  312.   Color Section
  313.   -------------
  314.   Colors can be defined now with color tokens. Look in the provided example
  315.   tagger.cfg. The easiest Way to define Colors is to use CONFIG.CMD.
  316.  
  317.   FileManager Section
  318.   -------------------
  319.   ACCESS <Action> <Userlevel>
  320.     This allows to restrict certain Filemanager actions to different User-
  321.     levels (Sysop is Default). Anyway all Functions only work when the
  322.     FILEMANAGER Parameter ist passed to the Tagger.
  323.     The Actions are :
  324.       DELETE COPY MOVE EDIT ADOPT DROP UPDATE RENAME DRIVES
  325.  
  326.     Example:
  327.       Access Move AsstSysop
  328.       (Allows Users with level AsstSysop to move files)
  329.  
  330.   NOTADOPT <Filemask> <Filemask> ......
  331.     Specifies which files not to List when you use the Adopt/Pickup command.
  332.     Multiple NOTADTOP lines will be recognized.
  333.  
  334.     Example:
  335.       NotAdopt *.cmd *.bak FILES.BBS FILES.IDX FILES.DMP FILES.DAT
  336.  
  337.   DRIVEINFO <DriveLetter> <DriveLetter> ....
  338.     Lets you specify the drive letters of the drives to be listed in the
  339.     free space info.
  340.  
  341.     Example:
  342.       DriveInfo C D E F M N
  343.  
  344.   FILEIDSPAWN
  345.     The CMD-File/Program to be started if you want to get a file-description
  346.     out of an archive.
  347.  
  348.   FILEID
  349.     The Name of the textfile holding the file-id (if found) when returning to
  350.     OffTag.
  351.  
  352.   DEFAULTDESCRIPTION
  353.     The Standard Description which will be preset on newly adopted files.
  354.  
  355. Read-Only Areas:
  356. ----------------
  357. "Fileoverride Download <Priv-Level>[/<Lock>]"
  358. If you use this statement in an area-definition of the filearea.ctl the
  359. tagger will allow download in this area only for the defined priv-level
  360. and above. But the area will be displayed to everyone which has a priv-level
  361. sufficcient for the "FileAccess" statement.
  362.  
  363. You have type the entire Word "Download" a single "D" is NOT recognized by
  364. OffTag.
  365.  
  366. Area-Grouping:
  367. --------------
  368. This is a powerful feature for sysops which have very many Fileareas.
  369. The Tagger now allows to group fileareas in groups and sub-groups like
  370. directories. The definition of groups is done (as comment) in the
  371. filearea.ctl (and included files). The statements listed below have to
  372. follow directly after the %.
  373.  
  374. Just a note: Be sure to RESCAN your Filebase after changing any group-
  375. statements. Only then the changes will be recognized.
  376.  
  377.  
  378. These commands are supported:
  379.  
  380. %TAG GROUP <GroupName> <Description>
  381. ---------------------------------------
  382.  
  383.   Defines a group. If the group is a subgroup of another group the
  384.   groupname has to start with the upper-groupname then "\" then the
  385.   groupname itsself (like a directory path to a subdirectory).
  386.   All groups have to start with a "\".
  387.   Usually you define all groups at the begin of the filearea.ctl, anyway
  388.   the groups have at least to be defined before they are used in the
  389.   PATH and ALIAS commands.
  390.  
  391.  
  392.   Example:
  393.     %TAG GROUP \OS/2         all about OS/2
  394.     %TAG GROUP \OS/2\INTERN  local os/2 areas
  395.     %TAG GROUP \OS/2\AC-NET  os/2 areas of the ac-network
  396.  
  397. %TAG PATH <Groupname>
  398. -----------------------
  399.   The Path command defines the group that will be used for the following
  400.   Fileareadeclarations. It can be stated multiple times for the same group
  401.   if areas of one group are not listed sequentially in your filearea.ctl.
  402.   Example:
  403.     %TAG PATH \OS/2\INTERN
  404.  
  405.  
  406. %TAG ALIAS <Groupname>
  407. ------------------------
  408.   The Alias command allows to let one filearea appear in different groups.
  409.   It has to be placed BEHIND the area-declaration.
  410.   You can use multiple ALIAS commands per group.
  411.  
  412. Example of a filearea.ctl which is formatted for Tagger grouping.
  413.  
  414. %Now for the Groupdeclarations
  415. %TAG GROUP \OFFLINE   Our filelists, new uploads, sysop portrait ...
  416. %TAG GROUP \MUSIC     Doobeedo
  417. %TAG GROUP \GRAPHICS  Pictures
  418.  
  419.  
  420. %TAG PATH \OFFLINE
  421.  
  422. area 0
  423.   filelist files\0.bbs
  424.   fileaccess Twit
  425.   fileinfo Filelists, infos
  426.   download e:\prog\emx\samples\files
  427.   upload   c:\upload
  428. end area
  429. %TAG ALIAS \MUSIC
  430. %TAG ALIAS \GRAPHICS
  431.  
  432. area 1
  433.   filelist files\1.bbs
  434.   fileaccess disgrace/1
  435. %
  436. %  this area is readonly until level Worthy (included)
  437. %
  438.   fileoverride download Privil
  439.   fileinfo New Uploads
  440.   download c:\upload
  441.   upload   c:\upload
  442. end area
  443.  
  444. %TAG PATH \MUSIC
  445.  
  446. area 400
  447.   filelist files\400.bbs
  448.   fileaccess disgrace/4
  449.   fileinfo SB / Adlib Tools
  450.   download d:\4\400
  451.   upload   c:\upload
  452. end area
  453.  
  454. %TAG PATH \GRAPHICS
  455.  
  456. area 500
  457.   filelist files\500.bbs
  458.   fileaccess disgrace/5
  459.   fileinfo GIFs
  460.   download d:\5\500
  461.   upload   c:\upload
  462. end area
  463.  
  464. area 508
  465.   filelist files\508.bbs
  466.   fileaccess disgrace/5
  467.   fileinfo Offline User Portraits
  468.   download d:\5\508
  469.   upload   d:\5\508
  470. end area
  471. %TAG ALIAS \OFFLINE
  472.  
  473. Area-Dependent Commands:
  474. ------------------------
  475. The commands WRAPATCR,CLEANUPDESC,DESCLIMIT and MULTILINEDESC can be applied
  476. to particular areas. Simply put them before the area-definition(s) in the
  477. filearea.ctl. And put them after the areas again (with a '-' added) to switch
  478. them off again.
  479. Example:
  480.  
  481. %TAG CLEANUPDESC
  482. area 1
  483. ....
  484. end
  485. %TAG DESCLIMIT 40
  486. area 2
  487. ...
  488. end
  489. %TAG CLEANUPDESC-
  490. %TAG DESCLIMIT 1000
  491.  
  492. If WRAPATCR,CLEANUPDESC or MULTILINEDESC have already passed as Parameter this
  493. has no effect as the Parameters apply globally. In the case of desclimit
  494. the smaller value (of tagger.cfg or declared in .ctl) is taken.
  495. You need to do a rescan after having changed the filearea.ctl.
  496.  
  497. New Language-File tokens (just as reference):
  498. ---------------------------------------------
  499.  
  500. filehelpline2      the second menu-line for the file-tagging menu
  501. areahelpline2      the second menu-line for the area/group-selction menu
  502. externtitle        headline of the "spawning external-function" menu
  503. externmsg          message line of that extern-window :)
  504. notallowed         The message displayed here will be displayed to users
  505.                    which try to tag a file which are they not allowed to
  506.                    download
  507.  
  508. fm_filehelpline    File-Manager equivalents to the Tagger-Menulines
  509. fm_filehelpline2   simply use your current language file or none
  510. fm_filemenu        Tagger will then default on english menues in File-
  511. fm_areahelpline    Manager mode.
  512. fm_areahelpline2
  513. fm_areamenu
  514.  
  515.  
  516. Some little other Features:
  517. ---------------------------
  518. beta/6:
  519.   A new Command in the AreaMenu now allows direct Global Search without
  520.   having to select Allfiles first.
  521.  
  522.   In Local Mode OffTag now automagically adjusts to the screensize currently
  523.   set.
  524.   In  Warp you can set many different screensizes for OS/2
  525.   Windows. Try out a Mode co120,40 (in a window) ;-).
  526.  
  527.   It's faster, did you remark it ?
  528.  
  529.   The Parameter NOFILESDAT should be redundant now. If the tagger does not
  530.   find a files.dat for a file area he will automatically try to add size and
  531.   date from the file-system.
  532.  
  533.   AVATAR is now supported. The support is quite basic, yet.
  534.  
  535.   The com-port treatment has been changed it should do a better job now on high
  536.   speed connects (like the german 64kbit ISDN) now. (i hope at least it does :)
  537.  
  538.   In the language-files the Space-Character can now be used to disable
  539.   Menu Keys.
  540.  
  541.  
  542. This all is preliminary. If you encounter problems and/or errors with OffTag
  543. please mail me:
  544.  
  545. Fido:                                Internet:
  546. Michael Mrosowski 2:240/5022.1       lagaffe@offline.sh.sub.de
  547.