@DATABASE "M-Tag line oriented tagging" @NODE MAIN " M-Tag documentation" @{"M - T a g" Link What_is_ita} @{"v 3.6" Link Historya} (c) P. Eastham 1993 - 1995. @{"IMPORTANT NOTES" Link imp} @{"What is it? " Link What_is_ita} @{"Config file " Link cfg} @{"Setting up " Link Setting_Upa} @{"Memory notes " Link Memory} @{"Invalid Keyfile" Link keyfile} @{"History " Link Historya} @{"Special thanks " Link John} NOTE: Changes in parameter's @ENDNODE @NODE imp " IMPORTANT NOTES" Version 3.4 - You can now store your data files in any directory you wish. Upon startup, M-Tag will look for 'DLGConfig:Master/M-Tag'. If this file doesn't exist, then M-Tag will assume 'Master:' to be the directory where you have your data files stored. Version 3.5 - No special requirements. @ENDNODE @NODE What_is_ita "What is M-Tag?" M-Tag is a single file area browse and tag utility. It has the following features: o Allows the user to sort in the 4 DLG native modes. o Defaults to users selected sort method, and updates their data file if they select a different sort method. o Adds 2 new sort modes - Size in both directions. o Doesn't update file order flag in above case as DLG doesn't support it. o Allows tagging by number. o Accepts range tagging. o Shows files already tagged. o Shows new files in the areaduring normal listing. o Shows users current tag status when they attempt to tag files. o If file can not be found, user is asked if they still wish to tag. o Correctly adds to batch file. o Supports the M-Tag.CDL CD-ROM updating system. o Allows single-key mass-tagging of all/new files. This should be the last major upgrade to M-Tag, unless big changes are made to DLG's filebase structure. Bug fixes and minor enhancements will be made though. @ENDNODE @NODE cfg " Config file" M-Tag has configurable colors and configurable mass-tagging. These are achieved via a config file. The config file is called '@{"DLGConfig:Master/M-Tag.cfg" link imp}'. You will notice it is also the config file for M-TagFS, and shares config keywords with M-Scan. Valid keywords for M-Tag are: SCANTAGDISPLAY= This is the display color config line. See the included config file on how to change these colors. Example: SCANTAGDISPLAY=625166152 NOTE: This keyword is also used for M-Scan MASSTAG= This keyword enables/disables the tagging of all files listed with 1 keypress. Example: MASSTAG=ON MASSTAG=OFF Default: OFF. NOTE: This keyword is also used for M-Scan MAXTAG= This keyword allows you to set the maximum number of tagged files the user can tag from within M-Scan. NOTE: This keyword is also used for M-TagFS and M-Scan. RATIOBLOCK= This keyword en/disables ratio checking. When on, the user will not be able to tag a file if the file will exceed their ratio. Example: RATIOBLOCK=ON Example: RATIOBLOCK=OFF Default: RATIOBLOCK=ON NOTE: This keyword is also used for M-TagFS and M-Scan. TIMEWARN= This keyword turns on/off time warning. This feature will warn the user that they no longer have the time to download the files they have tagged. It only displays a message when they tag a file. Example: TIMEWARN=ON Example: TIMEWARN=OFF Default: TIMEWARN=ON NOTE: This keyword is also used for M-TagFS and M-Scan. @ENDNODE @NODE Setting_Upa "How to set-up M-Tag" Copy the M-Tag executable to '@{"DLGConfig:Master/M-Tag" link imp}'. Create a menu item to call M-Tag. M-Tag takes 1 parameter. Call M-Tag thus: DLGConfig:Master/M-Tag -A%File_AreaNumber [-M] -H%File_UserHighFile The -M switch is used to set GFA's internal memory. It will take a value in Bytes or KB. For example: DLGConfig:Master/M-Tag -A%File_AreaNumber -M100000 will give you 100000 bytes of internal ram. If the number is less than 1000, it is multiplied by 1024 to give number of K. Copy M-Tag.help to DLGConfig:Menu/File_Main/!.help (or whatever command letter you use). This explains the various tagging options available to the user. Copy the M-Tag.WCD file to @{"DLGConfig:Master/M-Tag.WCD" link imp}. This is a plain text file which holds the wildcardes available. The inclosed file has only a subset of what is available. Consult your AmigaDOS manual for the full list. The generally accepted wildcard '*' is translated into the AmigaDOS '#?' before a match is attempted. Installation is now complete. @ENDNODE @NODE Memory "M-Tag memory availability" M-Tag now uses the -M parameter to set internal working RAM. There is no way to monitor memory usage in M-Tag, so you will have to test it in your big areas and see if it has enough. @ENDNODE @node keyfile "Invalid keyfile" Some sysops may have been lucky enough to download the release of the M-Tag package released onto AmiNet which had my keyfile in the archive. If you are such a sysop, be warned that all updates AND any new utilities I release will NOT function if this invalid keyfile is detected. @ENDNODE @NODE Historya "History of M-Tag" Version 1.0 - Initial release. Version 1.1 - Fixed description length problem. - Changed the output when tagging files. Much smoother now. - Fixed a problem with private area's. Now exits cleanly when in private area. Version 1.2 - Changed memory handling routines a little. - Changed the way M-Tag holds the file information. Now uses memory depending on how many files in area. - Added end of list break. Version 1.3 - Fixed a problem with the batch file being locked, preventing it from being deleted. - Added tag list check for 255 files. Version 1.4 - Added new files only option. - Added number of days back (Since last call was useless!). - Added filename search. - Added filename/description search. - Made wildcard list help sysop editable. Version 2.0 - Added .CDL support. - Removed the -A from the command switch. Now just takes the %-Switch. - Added global filepath support. Version 2.0a - Fixed a bug which caused enforcer hits, and perhaps crashed some machines. Version 2.0b - Fixed a small display error. - Added option to tag a non-existant file anyway. Version 2.0c - Fixed a severe bug when more than 255 files tagged. - Fixed even more severe bug when more than 127 files tagged. This bug appears to be in DLG itself. Version 2.1 - If registered, only displays the program ID on most occasions. The 'registered to' banner will appear randomly upon exit. Version 2.2 - Now accepts comma as seperator when inputing file numbers. - Added a delay after several error messages. - Tidied up memory error trapping. - Now free's an 8 byte leak if port could not be determined. Version 3.0 - Added program trap for sysops using accidently distributed keyfile. Will exit the program. - Fixed a 100 byte memory leak in the keyfile decode section. - Fixed a possible crash if something odd happened to the wildcard file. - Fixed a 516 byte leak if user data file could not be read. - Added DLG emulation of file order methods. - Updates users file order flag if they select a different order from with-in M-Tag. - Now shows files already tagged. - Added size sorting option to the list! Version 3.0a - Fixed a MAJOR bug that would fragment memory dramatically when used in private file area. Version 3.1 - Added configurable colors for some output. - Fixed a bug in the display of wildcard help screen. - Now allows user to mass tag all files on the current page, or just new files on the current page. Version 3.1a - Added config keyword: MAXTAG. See M-TagFS.Guide for details. Version 3.2 - Added RATIOBLOCK keyword. - Changed the way the keyfile is read in. - Changed parameter's. - Added -M parameter. - Changed order of select methods. - Added TIMEWARN keyword. Version 3.3 - Added support for downloading descriptions. - Re-wrote start-up routine. Now much quicker! - Now REQUIRES M-Support. - Now needs a new command switch. Version 3.4 - Fixed a nasty bug which caused a system crash if there were more than 255 files in a user's batch list. - Can now use any path to store data files. Version 3.5 - Now has dynamic file size display, rather than displaying the bytes of the file. - Removed the '...' if the description was to long to fit. - Made the description better fit the users screen width. - Made the line of dashes at the end of the area better fit the users screen width. Version 3.6 - Fixed a bug in the calculation of the users ratio. @ENDNODE @NODE john " Special thanks" Special thanks to John Veldthuis of Virus Checker fame. There are lots of sysops out there who's system memory will be eternally gratefull. See @{"GFA's problem" link M-TagP.guide/GFA} for an overview of the problem. @ENDNODE