@database "TTManager" @author "Jody Tierney" @(c) "Copyright © 1996-99 Jody Tierney" @$VER: TTManager.guide 3.10 (20.8.99) @node MAIN "TTManger Documentation" TTManager v3.5c ©1996-99 J. Tierney @{"Introduction " link HOWDY} What TTManager is, and what it can do. @{"Legalities " link SMEG} The part no one bothers to read. @{"Requirements " link NEEDS} They're few. @{"Installation " link STUFFIT} Nothing to it. The Interface @{"Startup Options " link STARTMEUP} "If you start me up..." @{"Commodity Control " link CX} @{"The AppMenu " link SELECTIT} @{"The AppIcon " link DROPIT} @{"The AppWindows " link DROPIT2} @{"WBInfo Patch " link PATCHIT} @{"The GUI " link THEGUI} @{"The Menus " link MENUS} @{"Keyboard Shortcuts" link KEYS} @{"ARexx " link AREXX} @{"Known Bugs " link DAMMIT} Time to stand in the tea chest. @{"Notes " link NOTES} A few things to be aware of. @{"Localization " link LOCALE} @{"To Do " link TODO} Today the ToolTypes; tomorrow the world! @{"History " link WASDONE} Once upon a time... @{"Credits " link GRACIAS} Many thanks to... @{"The Author " link SMEGHEAD} Hey, that's me! @endnode @node HOWDY "TTManager: What Is It?" @{u}@{b}Introduction:@{ub}@{uu} TTManager began as an attempt to improve upon the tooltype editing features offerred by Workbench's standard icon information requester. Since version 2.0 it's become a complete alternative to the information requester, allowing the user to not only manipulate tooltypes, but also the protection bits (supports MultiUser File System), file comment, icon type, and more. ...And all this with an easy to use, resizable, font-sensitive, localized, GadTools GUI. @{u}@{b}Features:@{ub}@{uu} * TTManager can, optionally, replace Workbench's Information requester. * Font-sensitive, resizable, style guide compliant GadTools GUI. * GUI(s) may be opened on public screens. * AppIcon and AppWindows for drag & drop convenience. * Adds itself to Workbench's Tools menu (AppMenu item). * It's a Commodity. * It's localized. Includes catalogs for the following languages: - Czech, - French, - German, - Greek, - Polish, - Swedish. * Button-bar with the following tooltype-editing features: - Add. - Toggle. - Delete. - Move. - Duplicate. - Toggle boolean values. - Cut to Clipboard. - Copy to Clipboard. - Paste from Clipboard. - Clear Clipboard contents. * Load tooltypes from ".info" or ASCII files in the following ways: - Replace. - Append. - Only new. - Only existing. * Tooltypes may be saved to an ASCII text file. * Three multiple-deletion options: - All. - Current to top. - Current to end. * Multiple undo/redo. * Sort and reverse options. * Enable, disable, or toggle all tooltypes at once. * Clipboard support - Cut, Copy, and Paste to/from units 0-9. * Set the: - Icon type (tool, project, drawer, disk, or garbage). - Stack. - Default tool - Featuring a user-definable menu for quicky setting often-used tools. - Comment. - Protection bits - Including MultiUser File System's. * Clone the Stack, Default Tool, Comment, and/or Protection bits of another icon. * Rename an icon and its associated file, drawer, or volume. * View volume information: - Format (OFS, FFS, OFS International, or FFS International) - Read only, or readable and writable. - Block size. - Total amount of space (bytes and blocks) on the volume. - Used space (bytes, blocks, and a percentage gauge). - Free space (bytes and blocks). * Icon image display. * ARexx port (55 commands so far). * User-definable ARexx menu with the ability to automatically run scripts when a window is opened. * Mouse-over zones in the GUI which report additional information. * It's fully functional, and free (well, Giftware). @endnode @node NEEDS "TTManager: Requirements" @{u}@{b}Required:@{ub}@{uu} - Workbench 2.04 or higher. - Workbench 2.1 or above is needed for localization (locale.library v38). - Workbench 3.0 or above is required for the Patch WBInfo option. @{u}@{b}Recommended:@{ub}@{uu} - @{b}Cycle To Menu@{ub} or @{b}MCP@{ub} - Drop-down menus for cycle gadgets. - @{b}New Edit@{ub}, @{b}MCP@{ub}, or @{b}MultiCX@{ub} - Clipboard support and better editing for string gadgets. @endnode @node SMEG "TTManager: Legal Issues" @{u}@{b}Copyright:@{ub}@{uu} TTManager is copyright ©1996-99, @{"Jody J. Tierney" link SMEGHEAD}. All rights reserved. ...Lefts, ups, downs, and all other directions, dimensions, and orientations are also reserved (that ought to cover things :-) ). TTManager is @{b}Giftware@{ub}. If you find it useful, consider sending a little something (or even a big something :-) ) my way. @{u}@{b}Distribution:@{ub}@{uu} TTManager is freely distributable in it's original form by any means you care to employ (FTP sites, BBSes, CD-ROMs and coverdisks (I'd appreciate a copy), carrier pigeons, holocubes, etc.). The only restriction (but it's an important one) is that @{b}no fee@{ub}, beyond a nominal charge to cover media and copying, which is not to exceed $4 US, is attached. TTManager may not be included with any commercial product without written permission from the author. Special permission is granted to include TTManager on the Aminet CD-ROMs and Fred Fish's disks and CD-ROMs. @{u}@{b}Disclaimer:@{ub}@{uu} No warranties, expressed or implied. Use this program at your own risk. Although much effort has been, and continues to be, put into this program to ensure safe and stable operation, I take no responsibility for any damages and/or losses incurred through the use/misuse of this program. @endnode @node STUFFIT "TTManager: Installation" @{u}@{b}Installation:@{ub}@{uu} Place TTManager anywhere you'd like (well, not @{u}there@{uu}! :-) ). The following files should be in the archive: @{u}File @{uu} @{u}Description: @{uu} @{fg shine}TTManager@{fg text}/ @{fg shine}Catalogs@{fg text}/ @{fg shine}deutsch@{fg text}/ ttmanager.catalog - German language catalog for TTManager. Created by Gerald Schnabel. @{fg shine}français@{fg text}/ ttmanager.catalog - French language catalog for TTManager. Created by Frederic Delacroix. @{fg shine}greek@{fg text}/ ttmanager.catalog - Greek language catalog for TTManager. Created by Alexandros Vellis. @{fg shine}polski@{fg text}/ ttmanager.catalog - Polish language catalog for TTManager. Created by Lukasz Jodlowski. @{fg shine}Svenska@{fg text}/ ttmanager.catalog - Swedish language catalog for TTManager. Created by Fredrik Ismyren. @{fg shine}ÃeÓtina@{fg text}/ ttmanager.catalog - Czech language catalog for TTManager. Created by Radim Demel. ttmanager.cd - Catalog description file; used to generate foreign language catalogs for TTManager. ttmanager_blank.ct - A blank translation file. @{fg shine}Rexx@{fg text}/ TTM-ActiveTTsToTop.rexx - Inactive tooltypes are moved to the bottom of the list. TTM-DM2LoadIcon.rexx - Open TTManager windows from DiskMaster II. TTM-DToolReplace.rexx - Replace default tools with preferred ones. TTM-LoadIcon.rexx - Open TTManager windows from the CLI or from directory utilities. TTM-resetDirs.rexx - Resets default file requester paths. TTM-ShowVersion.rexx - Displays the current file's version information. TTM-TmpSnapshot.rexx - Snapshots the current window dimensions, but doesn't save them permanently. TTM-TTSearch.rexx - Searches the tooltype list for a string. TTManager - TTManager itself, the main program. TTManager.info - TTManager's trusty iconic companion. TTManager.guide - The very file you're reading now. TTManager.guide.info - The documentation's ever-faithful sidekick. TTManager.menus - A sample @{"menu file" link menufile}. TTManager.info @{b}Notes:@{ub} - The catalog files from TTManager 2.x will not work with version 3.x. - The ARexx script(s) have usage instructions at the top of the file. Simply view them with a text reader. @endnode @node STARTMEUP "TTManager: Startup Options" @next CX @{u}@{b}Startup Options:@{ub}@{uu} The following options may be used as ToolTypes or CLI arguments. All are optional. @{u}Keyword @{uu} @{u}CLI Shortcut@{uu} @{u}Argument @{uu} @{u}Default Setting @{uu} @{"LEFTEDGE " link OPT_POS} X 0 - 65535 0 @{"TOPEDGE " link OPT_POS} Y 0 - 65535 0 @{"WIDTH " link OPT_DIM} W 0 - 65535 0 @{"HEIGHT " link OPT_DIM} H 0 - 65535 0 @{"CASCADEX " link OPT_CSCD} CSCX +/- 0-65535 0 @{"CASCADEY " link OPT_CSCD} CSCY +/- 0-65535 0 @{"PUBSCREEN " link OPT_PS} PS Screen name. Default public screen. @{"FONT " link OPT_FONT} F Font name. Default screen font. @{"FONTSIZE " link OPT_FONT} FS Point size. Default screen font size. @{"APPICON " link OPT_AI} AI Icon name. No name - use internal image. @{"APPICONX " link OPT_AI} AIX 0 - 65535 None - Workbench places it. @{"APPICONY " link OPT_AI} AIY 0 - 65535 None - Workbench places it. @{"NOAPPICON " link OPT_AI} NAI None. An AppIcon appears. @{"NOAPPMENU " link OPT_NAM} NAM None. TTManager appears in WB's Tools menu. @{"ICONDISPLAYWIDTH " link OPT_IDWH} IDW 0-65535 0 @{"ICONDISPLAYHEIGHT" link OPT_IDWH} IDH 0-65535 0 @{"PAGE " link OPT_PAGE} P Keyword. TOOLTYPES @{"LOADMODE " link OPT_LM} LM Keyword. REPLACE @{"LOADTYPE " link OPT_LT} LT keyword. ICON @{"MAXUNDO " link OPT_UNDO} MU 0 - 2 billion 10 @{"ONLYICONSINFREQ " link OPT_OI} OI None. "#?" is the default pattern. @{"VOLPAGEONDISK " link OPT_VPOD} VPOD None. The page isn't switched. @{"MOVEIFNEWVOL " link OPT_MNV} MNV None. The original file is untouched. @{"CURSORATDATA " link OPT_CAD} CAD None. Cursor is at the 1st character. @{"CLOSEAFTERSAVE " link OPT_CAS} CAS None. Windows remain open. @{"NOWARNINGS " link OPT_NW} NW None. Warning requesters appear. @{"NOICONS " link OPT_NI} NI None. Save As ASCII creates an icon. @{"CX_PRIORITY " link OPT_PRI} CXPRI -128 - 127 0 @{"HOTKEY " link OPT_KEY} KEY Key sequence. i @{"MENUFILE " link OPT_MF} MF Menu filename. ENV:TTManager.menus. @{"LANGUAGE " link OPT_LANG} Locale name. Default locale. @{"PATCHWBINFO " link OPT_PWBI} PWBI None. No patching is done. @{"DEFAULTDIR " link OPT_DIR} DIR Dir. name. PROGDIR: @{"DEFAULTASCIIDIR " link OPT_DIR} ADIR Dir. name. PROGDIR: @{"DEFAULTAREXXDIR " link OPT_DIR} RXDIR Dir. name. PROGDIR: @endnode @node OPT_POS "TTManager: Window Position Keywords" @toc STARTMEUP @{u}@{b}Window Position Keywords:@{ub}@{uu} @{b}X@{ub}, @{b}LEFTEDGE@{ub} <0 - 65535> @{b}Y@{ub}, @{b}TOPEDGE@{ub} <0 - 65535> These two keywords set the initial position TTManager's windows will open at. @{b}Default:@{ub} 0. @endnode @node OPT_DIM "TTManager: Window Dimension Keywords" @toc STARTMEUP @{u}@{b}Window Dimension Keywords:@{ub}@{uu} @{b}W@{ub}, @{b}WIDTH@{ub} <0 - 65535> @{b}H@{ub}, @{b}HEIGHT@{ub} <0 - 65535> These two keywords set the dimensions TTManager's windows will initially open to. TTManager may adjust these values to fit the screen size and the minimum space required to create the GUI. @{b}Default:@{ub} 0 (Smallest possible size). @endnode @node OPT_CSCD "TTManager: Window Tiling Keywords" @toc STARTMEUP @{u}@{b}Window Tiling Keywords:@{ub}@{uu} @{b}CSCX@{ub}, @{b}CASCADEX@{ub} <-65535 - 65535> @{b}CSCY@{ub}, @{b}CASCADEY@{ub} <-65535 - 65535> These keywords specify an offset (possibly negative) to be added to a window's initial postition (@{"LEFTEDGE" link OPT_POS} and @{"TOPEDGE" link OPT_POS}). Example: Tooltypes: LEFTEDGE=0, TOPEDGE=5, CASCADEX=5, CASCADEY=10 Window positions: 1st window: 0, 5 2nd window: 5, 15 3rd window: 10, 25 ...and so on. When all windows have been closed, the coordinates will reset to the beginning LEFTEDGE and TOPEDGE values (0, 5 in the above example). @{b}Default:@{ub} 0 (No tiling). @endnode @node OPT_PS "TTManager: Public Screen Keyword" @toc STARTMEUP @{u}@{b}Public Screen Keyword:@{ub}@{uu} @{b}PS@{ub}, @{b}PUBSCREEN@{ub} The public screen TTManager should open its windows on. @{b}Default:@{ub} Default public screen. @endnode @node OPT_FONT "TTManager: Font Keywords" @toc STARTMEUP @{u}@{b}Font Keywords:@{ub}@{uu} @{b}F@{ub}, @{b}FONT@{ub} Font to use in TTMamager's window. It isn't necessary to supply the ".font" extension. @{b}FS@{ub}, @{b}FONTSIZE@{ub} What size the font specified by @{b}FONT@{ub} should be. @{b}Note:@{ub} In order to use a custom font, both @{b}FONT@{ub} and @{b}FONTSIZE@{ub} must be specified. @{b}Default:@{ub} Default screen font. @endnode @node OPT_AI "TTManger: AppIcon Keywords" @toc STARTMEUP @{u}@{b}AppIcon Keywords:@{ub}@{uu} @{b}AI@{ub}, @{b}APPICON@{ub} Use 's image instead of TTManager's default AppIcon image. It isn't necessary to supply the ".info" extension. @{b}AIX@{ub}, @{b}APPICONX@{ub} <0 - 65535> @{b}AIY@{ub}, @{b}APPICONY@{ub} <0 - 65535> These two keywords specify the location of the AppIcon on the Workbench screen. Note that the vertical (Y) position "0" is just below the screen's title bar. @{b}NAI@{ub}, @{b}NOAPPICON@{ub} If specified, TTManager will not create an AppIcon. @{b}Default:@{ub} Create an AppIcon using the built-in image, and allow Workbench to determine its position. @endnode @node OPT_NAM "TTManager: No AppMenu Keyword" @toc STARTMEUP @{u}@{b}No AppMenu Keyword:@{ub}@{uu} @{b}NAM@{ub}, @{b}NOAPPMENU@{ub} TTManager will not add itself to Workbench's "Tools" menu. @{b}Default:@{ub} TTManager will add an item to the Tools menu. See the @{"AppMenu" link SELECTIT} section for more info. @endnode @node OPT_IDWH "TTManager: Icon Display Dimension Keywords" @toc STARTMEUP @{u}@{b}Icon Display Dimension Keywords:@{ub}@{uu} @{b}IDW@{ub}, @{b}ICONDISPLAYWIDTH@{ub} <0 - 65535> @{b}IDH@{ub}, @{b}ICONDISPLAYHEIGHT@{ub} <0 - 65535> These keyowrds set the dimensions of the icon display area, in the upper left corner of the @{"GUI" link THEGUI}. @{B}Note:@{ub} It's safe to use values which are too small or too large. These will automatically be adjusted as necessary. - The minimum width (currently) is 60 pixels. - The maximum width is limited by the width of the screen, and the amount of space required by the gadgets to the right of the icon display. - The minimum height is twice the height of a string gadget plus a little extra (currently 4 pixels), and thus varies with the size of the font used. - The maximum height is limited by the screen's height, and the amount of vertical space required by the rest of the GUI. @{b}Default:@{ub} 0 (Smallest possible size). @endnode @node OPT_PAGE "TTManager: Page Keyword" @toc STARTMEUP @{u}@{b}Page Keyword:@{ub}@{uu} @{b}P@{ub}, @{b}Page@{ub} Which @{"page" link GUI_PAGE} is initially active when a TTManager window is opened. is either VOLUMEINFO, INFORMATION, or TOOLTYPES. @{b}Default:@{ub} TOOLTYPES @endnode @node OPT_LM "TTManager: Load Mode Keyword" @toc STARTMEUP @{u}@{b}Load Mode Keyword:@{ub}@{uu} @{b}LM@{ub}, @{b}LOADMODE@{ub} Which @{"load mode" link GUI_LOAD} is initially active when a TTManager window is opened. is one of the following: REPLACE, APPEND, NEW, or EXISTING. @{b}Default:@{ub} REPLACE @endnode @node OPT_LT "TTManager: Load Type Keyword" @toc STARTMEUP @{u}@{b}Load Type Keyword:@{ub}@{uu} @{b}LT@{ub}, @{b}LOADTYPE@{ub} Which @{"load type" link GUI_LOAD} is initially active when a TTManager window is opened. is either: ICON or ASCII. @{b}Default:@{ub} ICON @endnode @node OPT_UNDO "TTManager: Maximum Undo Levels Keyword" @toc STARTMEUP @{u}@{b}Maximum Undo Levels Keyword:@{ub}@{uu} @{b}MU@{ub}, @{b}MAXUNDO@{ub} <0 - 2 billion> How many operations TTManager remembers, and may undo. Setting MAXUNDO to "0" disables the undo system (don't do this; I spent a lot of time on the undo routines - use 'em! :-) ). @{b}Default:@{ub} 10 @endnode @node OPT_OI "TTManager: Only Icons In File Requester Keyword" @toc STARTMEUP @{u}@{b}Only Icons In File Requester Keyword:@{ub}@{uu} @{b}OI@{ub}, @{b}ONLIICONSINFREQ@{ub} If specified, a file requester's default pattern will be "#?.info", thus only displaying icons and directories. @{b}Default:@{ub} The file requester's default pattern is "#?" (all files). @endnode @node OPT_VPOD "TTManager: Volume Page On Disk Keyword" @toc STARTMEUP @{u}@{b}Volume Page On Disk Keyword:@{ub}@{uu} @{b}VPOD@{ub}, @{b}VOLPAGEONDISK@{ub} If this keyword is specified, TTManager will open to the @{"Volume Information" link GUI_PAGE} page whenever a disk icon is loaded. This option may also be enabled or disabled by the @{"Volume Page On Disk" link MENU_VPOD} menu option. @{b}Default:@{ub} TTManager always opens to the default page (set by the PAGE keyword). @endnode @node OPT_MNV "TTManager: Move If New Volume Keyword" @toc STARTMEUP @{u}@{b}Move If New Volume Keyword:@{ub}@{uu} @{b}MNV@{ub}, @{b}MOVEIFNEWVOL@{ub} This option controls TTManager's renaming behavior when a different volume is involved. If this option is in effect, then a file will be copied to the new volume, and the original will be deleted. This option may also be enabled or disabled by the @{"Move If New Volume" link MENU_VPOD} menu option. @{b}Default:@{ub} A copy is performed, and the original file is left unchanged. @endnode @node OPT_CAD "TTManager: Cursor At Data Keyword" @toc STARTMEUP @{u}@{b}Cursor At Data Keyword:@{ub}@{uu} @{b}CAD@{ub}, @{b}CUSORATDATA@{ub} This option influences the placement of the cursor in the tooltype listview's @{"string gadget" link GUI_EDIT}. If Cursor At Data is enabled and the tooltype is of the form "TOOLTYPE=VALUE" then the cursor's initial position will be just after the equal sign. Otherwise the cursor starts, as usual, at the first character. @{b}Example:@{ub} Enabled: DEFAULTPATH=@{bg fill}X@{bg background}-Files:Text/ ^- Cursor position Disabled: @{bg fill}D@{bg background}EFAULTPATH=X-Files:Text/ ^- Cursor position This option may be enabled or disabled at any time via the @{"Cursor At Data" link MENU_CAD} menu option. @{b}Default:@{ub} The cursor starts at the first character. @endnode @node OPT_CAS "TTManager: Close After Save Keyword" @toc STARTMEUP @{u}@{b}Close After Save Keyword:@{ub}@{uu} @{b}CAS@{ub}, @{b}CLOSEAFTERSAVE@{ub} If this keyword is specified, the TTManager window will be closed after a @{"Save" link MENU_SAVE} operation. This option may also be enabled or disabled by the @{"Close After Save" link MENU_CAS} menu option. @{b}Default:@{ub} TTManager's windows remain open after saving. @endnode @node OPT_NW "TTManager: No Warnings Keyword" @toc STARTMEUP @{u}@{b}No Warnings Keyword:@{ub}@{uu} @{b}NW@{ub}, @{b}NOWARNINGS@{ub} If specified, "Are you sure?" requesters and the like are supressed. This option may also be enabled or disabled by the @{"No Warnings" link MENU_WARN} menu option. @{b}Default:@{ub} Warning requesters are enabled. @endnode @node OPT_NI "TTManager: No Icons Keyword" @toc STARTMEUP @{u}@{b}No Icons Keyword:@{ub}@{uu} @{b}NI@{ub}, @{b}NOICONS@{ub} Does this option seem a bit strange in an icon manipulation program? :-) It's used by the @{"Save As ASCII" link MENU_SASCII} menu option - whether or not the text file will have an icon. This option may also be enabled or disabled by the @{"Create Icons" link MENU_ICONS} menu option. @{b}Default:@{ub} Create icons. @endnode @node OPT_PRI "TTManager: Commodity Priority Keyword" @toc STARTMEUP @{u}@{b}Commodity Priority Keyword:@{ub}@{uu} @{b}CXPRI@{ub}, @{b}CX_PRIORITY@{ub} <-128 - 127> Sets TTManager's priority as a Commodity. @{b}Default:@{ub} 0 @endnode @node OPT_KEY "TTManager: Hotkey Keyword" @toc STARTMEUP @{u}@{b}Hotkey Keyword:@{ub}@{uu} @{b}KEY@{ub}, @{b}HOTKEY@{ub} <@{"key sequence" link IQUAL}> When the hotkey is pressed TTManager opens a file requester allowing you to select icon(s) to edit. The default hotkey combination is "rcommand shift i" (the right Amiga key, either shift key, and "i"). @{b}Default:@{ub} rcommand shift i (The right Amiga key, either shift key, and "i".) @endnode @node OPT_MF "TTManager: Menu File Keyword" @toc STARTMEUP @{u}@{b}Menu File Keyword:@{ub}@{uu} @{b}MF@{ub}, @{b}MENUFILE@{ub} The user may add items to the Default Tool and ARexx menus by creating a @{"menu definition file" link MENUFILE}. By default, TTManager searches for the file "ENV:TTManager.menus"; this option allows a different menu definition file to be used. @{b}Note:@{ub} The menufile scheme replaces the old method of using DEFAULTTOOLMENU@ to add items to the @{"Default Tool" link MENU_DTM} menu (the DEFAULTTOOLMENU@ keyword no longer exists). @{b}Default:@{ub} ENV:TTManager.menus @endnode @node OPT_LANG "TTManager: Language Keyword" @toc STARTMEUP @{u}@{b}Language Keyword:@{ub}@{uu} @{b}LANGUAGE@@{ub} This option allows you to use TTManager in a language other than your default Locale. @{b}Default:@{ub} Your default Locale is used if a TTManager catalog exists. Otherwise english is used. @endnode @node OPT_PWBI "TTManager: Patch WBInfo Keyword" @toc STARTMEUP @{u}@{b}Patch WBInfo() Keyword:@{ub}@{uu} @{b}PWBI@{ub}, @{b}PATCHWBINFO@{ub} When invoked, TTManager patches the WBInfo() function and thus replaces Workbench's standard icon information requester. WBInfo() patching may also be enabled or disabled with the @{"Patch WBInfo" link MENU_PWBI} menu option. @{b}Note:@{ub} This option is only available with Workbench 3.0 or above. See the @{"WBInfo Patch" link PATCHIT} section for more information. @{b}Default:@{ub} The WBInfo() function is not patched. @endnode @node OPT_DIR "TTManager: Default Directory Keywords" @toc STARTMEUP @next STARTMEUP @{u}@{b}Default Directory Keywords:@{ub}@{uu} @{b}DIR@{ub}, @{b}DEFAULTDIR@{ub} @{b}ADIR@{ub}, @{b}DEFAULTASCIIDIR@{ub} @{b}RXDIR@{ub}, @{b}DEFAULTAREXXDIR@{ub} These three keywords control the initial file requester paths. DEFAULTASCIIDIR is used by the ASCII loading and saving options. DEFAULTAREXXDIR is used by the Execute ARexx option. DEFAULTDIR is used in all other situations. @{b}Default:@{ub} PROGDIR: @endnode @node MENUFILE "TTManager: User-Definable Menus" @next MENUFILE @prev MENUFILE @{u}@{b}User-Definable Menus:@{ub}@{uu} TTManager currently has four menus which the user may add their own items to. These menus are: @{"Information->Default Tool" link MENU_DTM} @{"ARexx " link MENU_RX} @{"ARexx->Auto Open " link MENU_RXAUTO} @{"ARexx->Auto Close " link MENU_RXAUTO} Menus are defined in a plain text file with one or more lines in the following format: ID=MENUID TITLE CMD=COMMAND <command> [KEY <key>] [ON=CHECKED] <id> - Identifies which menu to add an item to. Valid IDs are: DEFAULTTOOL AREXX_SCRIPT AREXX_AUTOOPEN AREXX_AUTOCLOSE <title> - The menu's text. Enclose in quotation marks if this contains spaces. <key> - A hotkey for the menu item. <key> is case-insensitive; "a" = "A". <command> - DEFAULTTOOL - Ignorred. AREXX_... - Filename of an ARexx script to run. Enclose in quotation marks if this contains spaces. CHECKED or ON - If specified, this menu item checkmark-state is "on". Ignorred by DEFAULTTOOL and AREXX_SCRIPT menus. @{b}Examples:@{ub} MENUID DEFAULTTOOL TITLE "C:XIcon" KEY I ID AREXX_AUTOOPEN TITLE "Fix DTools" CMD Rexx:TTM-DToolReplace.rexx ON @{b}Notes:@{ub} - The menu files may contain blank lines, extra spaces, and tabs. Any text after a semicolon (";") is ignorred. - By default, menu definitions are loaded from ENV:TTManager.menu. Use the @{"MENUFILE" link OPT_MF} keyword to override this. - This scheme has replaced using the (now non-existant) DEFAULTTOOLMENU keyword to define Default Tool menu items. @endnode @node CX "TTManager: The Commodity Interface" @prev STARTMEUP @next SELECTIT @{u}@{b}Commodity Control:@{ub}@{uu} TTManager responds to the following commands from the Commodities Exchange: @{b}Show Interface@{ub}: This will open TTManager's @{b}About@{ub} requester with three options: @{b}Okay@{ub} - This simply closes the requester. @{b}Open@{ub} - Opens a file requester; a new @{"window" link THEGUI} will be opened for each file selected. @{b}Quit@{ub} - Quits TTManager. This requester will also appear whenever an attempt to start a second TTManager is made. @{b}Hide Interface@{ub}: Closes all open TTManager windows. @{b}Active@{ub}/@{b}Inactive@{ub}: When TTManager is in an active state, the hotkey may be used to invoke a file requester and open icons for editing. @{b}Remove@{ub}: Quits TTManager. If @{"Warnings" link MENU_WARN} are enabled, you will recieve an "Are you sure?" requester. @{u}@{b}Hotkey:@{ub}@{uu} TTManager has a hotkey, specified by the @{"HOTKEY" link OPT_KEY} startup option. When this @{"key sequence" link IQUAL} (@{i}rcommand shift i@{ui} by default) is recieved TTManager opens a file requester, allowing icons to be selected for editing. @endnode @node IQUAL "TTManager: Input Qualifiers" @prev IQUAL @next IQUAL @{u}@{b}Qualifiers:@{ub}@{uu} The following qualifiers may be used when specifing a hotkey. Those marked with an asterisk ("*") require version 38 of the commodities.library (Workbench 2.1). @{b}shift@{ub} - Either shift key. @{b}lshift@{ub}, @{b}left_shift@{ub} * - Left shift key. @{b}rshift@{ub}, @{b}right_shift@{ub} * - Right shift key. @{b}caps@{ub} - Caps lock key or either shift key. @{b}capslock@{ub}, @{b}caps_lock@{ub} * - Caps lock key. @{b}control@{ub}, @{b}ctrl@{ub} * - Control key. @{b}alt@{ub} - Either alt key. @{b}lalt@{ub}, @{b}left_alt@{ub} * - Left alt key. @{b}ralt@{ub}, @{b}right_alt@{ub} * - Right alt key. @{b}numericpad@{ub}, @{b}numpad@{ub} *, @{b}num_pad@{ub} *, @{b}numeric_pad@{ub} * - A key on the numeric keypad. @{b}lcommand@{ub}, @{b}left_command@{ub} *, @{b}lamiga@{ub} *, @{b}left_amiga@{ub} * - Left Amiga key. @{b}rcommand@{ub}, @{b}right_command@{ub} *, @{b}ramiga@{ub} *, @{b}right_amiga@{ub} * - Right Amiga key. @{b}leftbutton@{ub}, @{b}lbutton@{ub} *, @{b}left_button@{ub} * - Left mouse button. @{b}midbutton@{ub}, @{b}mbutton@{ub} *, @{b}middlebutton@{ub} *, @{b}middle_button@{ub} * - Middle mouse button. @{b}rightbutton@{ub}, @{b}rbutton@{ub} *, @{b}right_button@{ub} * - Left mouse button. @endnode @node SELECTIT "TTManager: The AppMenu" @prev CX @{u}@{b}TTManager AppMenu Item:@{ub}@{uu} @{bg shine}@{u}Tools @{uu}@{bg background} : @{bg shine}TTManager@{bg background} : TTManager adds an item (creatively named "TTManager") to Workbench's Tools menu. What happens when this item is selected depends on whether any icons are also selected. @{b}No Icons Selected:@{ub} TTManager will open an information requester with three options: @{b}Okay@{ub} - This simply closes the requester. @{b}Open@{ub} - Opens a file requester; a new @{"window" link THEGUI} will be opened for each file selected. @{b}Quit@{ub} - Quits TTManager. @{b}Icon(s) Selected:@{ub} TTManager will open a @{"window" link THEGUI} for each selected icon. The @{"NOAPPMENU" link OPT_NAM} keyword may be used to disable the addition of the TTManager AppMenu item. @endnode @node DROPIT "TTManager: The AppIcon" @{u}@{b}TTManager AppIcon:@{ub}@{uu} TTManager's Appicon may have icons dropped onto it, and may also be double-clicked. @{b}Dropping Icons:@{ub} Dropping icons onto TTManager's AppIcon will open a @{"window" link THEGUI} where the icon's tooltypes may be edited. @{b}Double-Clicking:@{ub} Double-clicking TTManager's AppIcon will open an information requester with three options: @{b}Okay@{ub} - This simply closes the requester. @{b}Open@{ub} - Opens a file requester; a new @{"window" link THEGUI} will be opened for each file selected. @{b}Quit@{ub} - Quits TTManager. Creation of an AppIcon may be suppressed by using the @{"NOAPPICON" link OPT_AI} keyword. The position of the AppIcon may be set using the @{"APPICONX" link OPT_AI} and @{"APPICONY" link OPT_AI} keywords. @endnode @node DROPIT2 "TTManager: The AppWindows" @{u}@{b}TTManager AppWindows:@{ub}@{uu} TTManager's @{"windows" link THEGUI} are AppWindows; icons may be dropped into them. What happens next depends on which @{"page" link GUI_PAGE} is currently active. @{b}ToolType Page:@{ub} The tooltypes of the selected icon(s) will replace or be appended to the current tooltype list. The specific action depends on the current settings of the @{"Load Mode" link GUI_LOAD} and @{"From Type" link GUI_LOAD} cycle gadgets. @{b}File Information Page:@{ub} The stack, default tool, comment, and/or protection bit settings of the new icon will replace the current settings. Which attributes are copied depends on the states of the @{"Copy From" link MENU_COPYFROM} menu items. @{b}Volume Information Page:@{ub} No action is performed. @endnode @node PATCHIT "TTManager: The WBInfo Patch" @{u}@{b}TTManager WBInfo Patch:@{ub}@{uu} TTManager may optionally patch Workbench.Library's WBInfo() function, replacing Workbench's standard icon information requester with TTManager's own @{"GUI" link THEGUI}. The @{"PATCHWBINFO" link OpT_PWBI} keyword determines if the patch is applied when TTManager is first started. Afterwards, the @{"Settings->Patch WBInfo" link MENU_PWBI} menu may be used to install/remove the patch. Version 39, or above, of the workbench.library is required to use the WBInfo patch (the WBInfo() function isn't present in earlier versions). With earlier Workbenches (2.x), the PATCHWBINFO keyword is ignorred, and the menu item will be ghosted and unselectable. @endnode @node THEGUI "TTManager: The GUI" @toc MAIN @next MENUS @{u}@{b}TTManager's Window:@{ub}@{uu} TTManager's windows resemble the following: @{b}Volume Information Page:@{ub} @{bg fill}|o| TTManager v3.5c |' |[]|@{bg background} @{bg fill} @{bg background}+-------+ File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"<Icon>" link GUI_ICON}| Type: @{"@| Tool " link GUI_ITYPE} @{" Undo " link GUI_UNDO} @{" Redo " link GUI_UNDO}@{bg fill} @{bg background} @{bg fill} @{bg background}+-------+ @{bg fill} @{bg background} @{bg fill} @{bg background} ----------- @{"@|Volume Information" link GUI_PAGE} ----------- @{bg fill} @{bg background} @{bg fill} @{bg background}|Type: @{"FFS - Readable/Writable " link GUI_VTYPE}|@{bg fill} @{bg background} @{bg fill} @{bg background}| |@{bg fill} @{bg background} @{bg fill} @{bg background}| Blocks: Bytes: @{"512/block " link GUI_VBLKSZ}|@{bg fill} @{bg background} @{bg fill} @{bg background}|Total: @{"163294 " link GUI_VSPC} @{"83606528 " link GUI_VSPC}|@{bg fill} @{bg background} @{bg fill} @{bg background}| Free: @{"124745 " link GUI_VSPC} @{"63869440 " link GUI_VSPC}|@{bg fill} @{bg background} @{bg fill} @{bg background}| Used: @{"38549 " link GUI_VSPC} @{"19737088 " link GUI_VSPC}|@{bg fill} @{bg background} @{bg fill} @{bg background}| ___________________________________________ |@{bg fill} @{bg background} @{bg fill} @{bg background}||@{bg fill} @{bg background} @{fg shine}23% full@{fg text} ||@{bg fill} @{bg background} @{bg fill} @{bg background}| ------------------------------------------- |@{bg fill} @{bg background} @{bg fill} @{bg background}| |@{bg fill} @{bg background} @{bg fill} @{bg background} --------------------------------------------- @{bg fill} @{bg background} @{bg fill} @{bg background}@{" Save " link GUI_SAVE} @{"Save As..." link GUI_SAVE} @{" Cancel " link GUI_SAVE}@{bg fill}__@{bg background} @{bg fill} |/@{bg background} @{b}File Information Page:@{ub} @{bg fill}|o| TTManager v3.5c |' |[]|@{bg background} @{bg fill} @{bg background}+-------+ File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"<Icon>" link GUI_ICON}| Type: @{"@| Tool " link GUI_ITYPE} @{" Undo " link GUI_UNDO} @{" Redo " link GUI_UNDO}@{bg fill} @{bg background} @{bg fill} @{bg background}+-------+ @{bg fill} @{bg background} @{bg fill} @{bg background} ----------- @{"@| Information " link GUI_PAGE} ----------- @{bg fill} @{bg background} @{bg fill} @{bg background}| Size: 69988 bytes - 137 blocks |@{bg fill} @{bg background} @{bg fill} @{bg background}| Last Modified: 04-Jul-97 - 12:12:47 |@{bg fill} @{bg background} @{bg fill} @{bg background}|Stack: @{"4096 " link GUI_STACK} Default Tool: @{" | |" link GUI_DTOOL}|@{bg fill} @{bg background} @{bg fill} @{bg background}|Comment: @{" " link GUI_NOTE}|@{bg fill} @{bg background} @{bg fill} @{bg background}| |@{bg fill} @{bg background} @{bg fill} @{bg background}| @{"*" link GUI_PB} Standard @{"./" link GUI_PB} Readable @{" " link GUI_PB} Script |@{bg fill} @{bg background} @{bg fill} @{bg background}| @{" " link GUI_PB} Group @{"./" link GUI_PB} Writable @{" " link GUI_PB} Pure |@{bg fill} @{bg background} @{bg fill} @{bg background}| @{" " link GUI_PB} Other @{"./" link GUI_PB} Executable @{"./" link GUI_PB} Archived|@{bg fill} @{bg background} @{bg fill} @{bg background}| @{"./" link GUI_PB} Deletable @{" " link GUI_PB} User |@{bg fill} @{bg background} @{bg fill} @{bg background}| |@{bg fill} @{bg background} @{bg fill} @{bg background} --------------------------------------------- @{bg fill} @{bg background} @{bg fill} @{bg background}@{" Save " link GUI_SAVE} @{"Save As..." link GUI_SAVE} @{" Cancel " link GUI_SAVE}@{bg fill}__@{bg background} @{bg fill} |/@{bg background} @{b}ToolType Page:@{ub} @{bg fill}|o| TTManager v3.5c |' |[]|@{bg background} @{bg fill} @{bg background}+-------+ File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"<Icon>" link GUI_ICON}| Type: @{"@| Tool " link GUI_ITYPE} @{" Undo " link GUI_UNDO} @{" Redo " link GUI_UNDO}@{bg fill} @{bg background} @{bg fill} @{bg background}+-------+ @{bg fill} @{bg background} @{bg fill} @{bg background} ----------- @{"@| ToolTypes " link GUI_PAGE} ----------- @{bg fill} @{bg background} @{bg fill} @{bg background}| @{"Load..." link GUI_LOAD}: @{"@| Replace All " link GUI_LOAD} From: @{"@| Icon " link GUI_LOAD} |@{bg fill} @{bg background} @{bg fill} @{bg background}| ------------------------------------------- |@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"LEFTEDGE=10 " link GUI_EDIT}@{" " link GUI_EDIT}|@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"TOPEDGE=10 " link GUI_EDIT}##|@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"FONT=Helvetica " link GUI_EDIT}##|@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"FONTSIZE=13 " link GUI_EDIT}@{"^" link GUI_EDIT}|@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"APPICON=SYS:WBStartup/TTManager " link GUI_EDIT}@{"v" link GUI_EDIT}|@{bg fill} @{bg background} @{bg fill} @{bg background}| ------------------------------------------- |@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"FONTSIZE=13 " link GUI_EDIT}|@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"+" link EM}@{"(/)" link EM}@{"()" link EM}@{"(=" link EM}@{"I>H" link EM}@{"(\)" link EM}@{"8xM" link EM}@{"->M" link EM}@{"<-M" link EM}@{"0M" link EM} |@{bg fill} @{bg background} @{bg fill} @{bg background} --------------------------------------------- @{bg fill} @{bg background} @{bg fill} @{bg background}@{" Save " link GUI_SAVE} @{"Save As..." link GUI_SAVE} @{" Cancel " link GUI_SAVE}@{bg fill}__@{bg background} @{bg fill} |/@{bg background} @{b}Mouse-Over Zones:@{ub} The screen's titlebar normally displays the path and filename of the icon in the current window. The titlebar text will provide other information when the mouse pointer passes over the following areas of the GUI: The @{"Icon Image Display" link GUI_ICON}, @{"Undo/Redo" link GUI_UNDO} buttons, and the Tooltype page @{"Toolbar" link EM} buttons. @endnode @node GUI_FNAME "TTManager Window - Global Gadgets: Filename Gadget" @toc THEGUI @{u}@{b}File Name Gadget:@{ub}@{uu} Use this gadget to rename the icon currently being edited. If no data is entered, the name is unchanged. Renaming takes effect when the icon is saved. If @{"Move If New Volume" link MENU_MNV} is enabled then the original file will be deleted, otherwise it's left unchanged. @{b}Keyboard Shortcut:@{ub} I (activates the string gadget.) @{b}Notes:@{ub} * Renaming affects the icon @{b}and@{ub} the file the icon is associated with. For example, renaming "DPaintIV" to "DPaint4.6" means both "DPaintIV.info" and "DPaintIV" will be renamed. * The underlying file is only renamed if the icon type hasn't been changed. It makes no sense to rename a drawer, for example, if the icon has been changed to a tool. In cases such as this, the icon is saved using the new name and the original file/drawer/disk name and icon are unchanged. * Disks are renamed (relabeled) only if both the original and new names are: <Volume name>:Disk. @endnode @node GUI_ICON "TTManager Window - Global Gadgets: Icon Image" @toc THEGUI @{u}@{b}Icon Image Display:@{ub}@{uu} The icon's image is displayed here. Clicking on the image will display the icon's selected image (if it has one), or complement the image ("You look very nice, image."). The size of the icon image display may be set using the @{"ICONDISPLAYWIDTH" link OPT_IDWH} and @{"ICONDISPLAYHEIGHT" link OPT_IDWH} startup options. @{b}Mouse-Over Zone:@{ub} When the mouse pointer passes over the Icon Image Display the screen's titlebar will display whether the icon exists or is a default image, and the number of colors the icon uses. @endnode @node GUI_ITYPE "TTManager Window - Global Gadgets: Icon Type Cycle Gadget" @toc THEGUI @{u}@{b}Icon Type Cycle Gadget:@{ub}@{uu} This gadget diaplays the type of icon currently being edited. It may also be used to change the icon's type. The types of icons are: Disk, Drawer, Tool, Project, and Trash. @endnode @node GUI_UNDO "TTManager Window - Global Gadgets: Undo & Redo Buttons" @toc THEGUI @{u}@{b}Undo Button:@{ub}@{uu} Clicking undo undoes the last operation. The number of operations which may be undone is set by the @{"MAXUNDO" link OPT_UNDO} tooltype or CLI option (the default is 10). @{b}Keyboard Shortcut:@{ub} U (performs an undo.) @{u}@{b}Redo Button:@{ub}@{uu} Redo undoes an undo. :-) @{b}Keyboard Shortcut:@{ub} R (performs a redo.) @{b}Note:@{ub} Nearly any operation may be undone. Following is a list of the (few) actions which @{u}cannot@{uu} be undone: * Save * The @{"New" link MENU_OPEN} and @{"Open" link MENU_OPEN} menu options. * Closing the window. * Quitting TTManager. @{b}Mouse-Over Zone:@{ub} When the mouse pointer passes over the Undo or Redo buttons the screen's titlebar will display whether the number of items in the undo buffer. @endnode @node GUI_PAGE "TTManager Window - Global Gadgets: Page Cycle Gadget" @toc THEGUI @{u}@{b}Page Cycle Gadget:@{ub}@{uu} This gadget flips through TTManager's pages: @{b}Volume Information@{ub} - Information about the volume's size and format. @{b}Information@{ub} - File information: size, last modified, stack size, default tool, comment, and protection bits. @{b}ToolTypes@{ub} - Tooltype editing/manipulating. You can go to the last page to see how it all ends. :-) The initial position of this gadget may be set at start-up by the @{"PAGE" link OPT_PAGE} keyword. Also, the Volume Information page can be made to be displayed whenever a disk icon is loaded by setting the @{"Volume Page On Disk" link MENU_VPOD} option. @{b}Keyboard Shortcut:@{ub} p (cycles forwards through the pages.) P (cycles backwards through the pages.) (Cycling is a non-polluting mode of transport.) @endnode @node GUI_SAVE "TTManager Window - Global Gadgets: To Save, Or Not To Save..." @toc THEGUI @{u}@{b}Save Button:@{ub}@{uu} Saves the icon using the path and name displayed in the and @{"file name" link GUI_FNAME} string gadget. If the @{"Close After Save" link MENU_CAS} menu option is set the window will then close itself. @{b}Keyboard Shortcut:@{ub} S (performs a save.) @{u}@{b}Save As Button:@{ub}@{uu} Opens a requester allowing the icon to be saved under a new name. The original ".info" file is unchanged. @{b}Keyboard Shortcut:@{ub} A (opens a file requester.) @{u}@{b}Cancel Button:@{ub}@{uu} Closes the window without saving anything. @{b}Keyboard Shortcut:@{ub} C (closes the window.) @endnode @node GUI_VTYPE "TTManager Window - Volume Information Page: Volume Type" @toc THEGUI @{b}Volume Information Page:@{ub} @{u}@{b}Disk Type Display:@{ub}@{uu} This gadget displays the type of disk loaded, and whether it can be written to. Disk Types: OFS - Old File System. OFS Int. - Old File System, international mode. FFS - Fast File System. FFS Int. - Fast File System, international mode. Read Only - The disk is write protected, or read only. Readable/Writable - The disk can be written to. @endnode @node GUI_VBLKSZ "TTManager Window - Volume Information Page: Bytes/Block" @toc THEGUI @{b}Volume Information Page:@{ub} @{u}@{b}Bytes per Block Display:@{ub}@{uu} Displays how many bytes make up one block. @endnode @node GUI_VSPC "TTManager Window - Volume Information Page: Disk Space" @toc THEGUI @{b}Volume Information Page:@{ub} @{u}@{b}Disk Space Displays:@{ub}@{uu} These gadgets display the total amount of space, both in blocks and bytes, on a disk, and the amount free and used. There is also a gauge showing the percentage of space in use. @endnode @node GUI_STACK "TTManager Window - Information Page: Stack Gadget" @toc THEGUI @{b}Information Page:@{ub} @{u}@{b}Stack Gadget:@{ub}@{uu} This gadget allows you to set the tool's (or default tool's) stack. The stack is an amount of memory reserved for temporary storage. A stack size of "0" means the default stack size will be used (currently 4096 bytes). This gadget is enabled for tool, project, and disk icon types, and disabled for drawers. @{b}Keyboard Shortcut:@{ub} K (activates the integer gadget.) @endnode @node GUI_DTOOL "TTManager Window - Information Page: Default Tool Gadgets" @toc THEGUI @{b}Information Page:@{ub} @{u}@{b}Default Tool String Gadget:@{ub}@{uu} This gadget allows you to set the project's or disk's default tool. This program will be run when the project icon is double-clicked, or when this disk is dropped onto another disk icon. This gadget is enabled for project and disk icon types, and disabled for tools and drawers. @{b}Keyboard Shortcut:@{ub} T (activates the string gadget.) @{u}@{b}File Requester Gadget:@{ub}@{uu} Pressing this gadget (next to the Defaut Tool string gadget) will pop up a file requester. The selected file will become the Default Tool. @endnode @node GUI_NOTE "TTManager Window - Information Page: Comment Gadget" @toc THEGUI @{b}Information Page:@{ub} @{u}@{b}Comment String Gadget:@{ub}@{uu} Tools, projects, and drawers may have an 80 character comment attached to them. @{b}Keyboard Shortcut:@{ub} O (activates the string gadget.) @{b}Note:@{ub} The comment is actually stored along with a file, not in the icon, so the comment will be lost if no file exists when the icon is saved. @endnode @node GUI_PB "TTManager Window - Information Page: Protection Bit Gadgets" @toc THEGUI @{b}Information Page:@{ub} @{u}@{b}Protection Group Gadget:@{ub}@{uu} Selects which group of protectipn bits to display/edit. "Group" and "Other" are for use with MultiUser File System. Standard - Set the standard AmigaDOS protection bits (and MuFS's User bit). Group - Set protection bits (R, W, E, D) for users in the owner's group. Other - Set protection bits (R, W, E, D) for users not in the owner's group. @{u}@{b}Protection Bit Checkbox Gadgets:@{ub}@{uu} These checkbox gadgets are used to set the various AmigaDOS and MultiUser protection bits. Readable - The file may be read. Tools, projects, and drawers. Writable - The file may be written to. Tools, projects, and drawers. Executable - The file may be executed. Tools only. Deletable - The file may be deleted. Tools, projects, and drawers. Script - The file is an AmigaDOS script and may be run without having to issue the Execute command. Projects only. Pure - The file is pure and may be made resident. Tools only. Archived - The file has been backed up. Tools, projects, and drawers. User - Used by MultiUser File System. @{b}Note:@{ub} Protection bits are actually stored along with a file, not in the icon, so the protection bits will be lost if no file exists when the icon is saved. @endnode @node GUI_LOAD "TTManager Window - ToolType Page: ToolType Loading Gadgets" @toc THEGUI @{b}ToolType Page:@{ub} @{u}@{b}Load Button:@{ub}@{uu} Pops up a file requester allowing you to add tooltypes from another icon(s) to the one currently being edited. The exact way the tooltypes are loaded in depends on how the @{b}Load Mode@{ub} and @{b}From Type@{ub} cycle gadgets are set. @{b}Keyboard Shortcut:@{ub} L (opens a file requester.) @{u}@{b}Load Mode Cycle Gadget:@{ub}@{uu} Replace All - The old tooltypes are replaced by the new ones. Append All - The new tooltypes are appended to the end of the tooltype list. Only New - Each new tooltype is checked against the current list of tooltypes, and added to the end of the list if no match is found. Only Existing - Similar to @{b}Only New@{ub}, except that if a match is found the new tooltype replaces the old one. The new tooltype is discarded if it isn't already in the list. @{b}Keyboard Shortcut:@{ub} m (cycles forwards through the possible modes.) M (cycles backwards through the possible modes.) (Cycling is an excellent form of exercise.) @{u}@{b}From Type Cycle Gadget:@{ub}@{uu} This selectes whether the new tooltypes are to come from an ".info" file, or an ASCII text file. @{b}Keyboard Shortcut:@{ub} f (cycles forwards through the possible types.) F (cycles backwards through the possible types.) (Always wear a helmet while cycling.) @{b}Note:@{ub} * The load modes @{b}Only New@{ub} and @{b}Only Existing@{ub} compare the tooltype's keyword. Given the tooltype "(LEFTEDGE=360)", these modes are looking for a match to "LEFTEDGE" (the keyword's value (if any) and whether it's enabled or disabled is ignorred). * TTManager's windows are @{b}AppWindows@{ub}. Icon(s) may be dropped into the window, and the appropriate action (determined by the @{b}Load Mode@{ub} and @{b}From Type@{ub} cycle gagdets) will be performed. * The inital setting of the @{b}load mode@{ub} and @{b}load type@{ub} cycle gadgets may be set via the @{"LOADMODE" link OPT_LM} and @{"LOADTYPE" link OPT_LT} keywords. @endnode @node GUI_EDIT "TTManager Window - ToolType Page: ToolType Display & Editing" @toc THEGUI @{b}ToolType Page:@{ub} @{u}@{b}The ListView:@{ub}@{uu} The icon's tooltypes are displayed here. @{u}@{b}The ListView String Gadget:@{ub}@{uu} Nothing out of the ordinary here. It's used to edit the items in the listview. It's disabled when a @{"move" link EM} is in effect. The cursor may be automatically positioned after an equal sign in the tooltype by setting the CursorAtData @{"startup" link OPT_CAD} option or @{"menu" link MENU_CAD} item. @endnode @node EM "TTManager Window - ToolType Page: The Button Bar" @toc THEGUI @next THEGUI @{b}ToolType Page:@{ub} @{u}@{b}The Button Bar:@{ub}@{uu} From left to right, the buttons are: @{b}Add@{ub} - Inserts a new, blank tooltype after the currently selected one. @{b}Delete@{ub} - The current tooltype is removed from the list. @{b}Toggle@{ub} - Enables or disables (surrounds with parentheses "()") the current tooltype. @{b}Move@{ub} - Select a tooltype in the listview, click on the Move button (the listview's string gadget will be disabled), and then click somewhere in the listview - The tooltype will be inserted @{u}after@{uu} the item you clicked on. To cancel a move, either reselect the same tooltype, or press the move button a second time. @{b}Duplicate@{ub} - Others may struggle with the ethics and morality of cloning; TTManager leaves the matter entirely up to you. :-) Click on a tooltype and an identical copy appears (Marvel Comics is discouraged from using this mode ;-) ). @{b}Boolean Toggle@{ub} - If the tooltype has a boolean value, this button will switch it to the opposite state. Ex: SAVEICONS=TRUE will toggle to SAVEICONS=FALSE. The following boolean pairs are recognized: ON/OFF, YES/NO, and TRUE/FALSE. @{b}Cut to Clipboard@{ub} - The current tooltype is removed from the listview and appended to the current clipboard's contents. @{b}Copy to Clipboard@{ub} - The current tooltype is appended to the text in the current clipboard unit. @{b}Paste from Clipboard@{ub} - The contents of the clipboard are inserted into the tooltype list after the current tooltype. @{b}Clear Clipboard@{ub} - Clears the contents of the current clipboard unit. @{b}Mouse-Over Zone:@{ub} When the mouse pointer passes over a toolbar button the screen's titlebar will display that button's function. @endnode @node MENUS "TTManager Menus" @toc MAIN @next KEYS @prev THEGUI @{u}@{b}Menus:@{ub}@{uu} @{u}@{bg shine}Project Edit Information ToolTypes Settings ARexx @{bg background}@{uu} @{"New... [A]N" link MENU_OPEN} @{"Cut [A]X" link MENU_CB} @{"Icon Type »" link MENU_ITYPE} @{"Enable All [A]+" link MENU_TTON} @{"./ Patch WBInfo? " link MENU_PWBI} @{"Execute... " link MENU_RX} @{"Open... [A]O" link MENU_OPEN} @{"Copy [A]C" link MENU_CB} @{"Default Tool »" link MENU_DTM} @{"Disable All [A]-" link MENU_TTON} @{"./ Only Icons In File Req?" link MENU_OI} ~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~ @{"Paste [A]V" link MENU_CB} @{"Protection »" link MENU_PB} @{"Toggle All [A]\ " link MENU_TTON} @{"./ Volume Page On Disk? " link MENU_VPOD} @{"Auto Open »" link MENU_RXAUTO} @{"Save [A]S" link MENU_SAVE} @{"Clear Clip [A]0" link MENU_CB} ~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~ @{" Move If New Volume? " link MENU_MNV} @{"Auto Close »" link MENU_RXAUTO} @{"Save As... [A]A" link MENU_SAVE} @{"Clip Unit »" link MENU_CB} @{"Copy From... " link MENU_COPYFROM} @{"Delete »" link MENU_DEL} @{"./ Cursor At Data? " link MENU_CAD} ~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~ @{" Stack " link MENU_COPYFROM} ~~~~~~~~~~~~~~~~~~~~~~ @{"./ Close After Save? " link MENU_CAS} @{"<script> " link MENU_RX} @{"Close [A]1" link MENU_CLOSE} @{"Undo [A]U" link MENU_UNDO} @{" Default Tool " link MENU_COPYFROM} @{"Load From Icon »" link MENU_LDTT} @{" Warnings? " link MENU_WARN} @{"Close All (Local) [A]2" link MENU_CLOSE} @{"Redo [A]Z" link MENU_UNDO} @{"./ Comment " link MENU_COPYFROM} @{"Load From ASCII »" link MENU_LDTT} @{" Create Icons? " link MENU_ICONS} @{"Close All [A]!" link MENU_CLOSE} @{"Flush »" link MENU_UNDO} @{"./ Protection " link MENU_COPYFROM} ~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~ @{"Save As ASCII... [A]D" link MENU_SASCII} @{"Snapshot " link MENU_SNAP} @{"About... [A]?" link MENU_ABOUT} ~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~ @{"Sort [A]T" link MENU_SORT} @{"Quit [A]Q" link MENU_QUIT} @{"Reverse [A]R" link MENU_REV} "[A]" represents the right Amiga key. @{b}User-Definable Menus@{ub} The Default Tool and ARexx menus allow for items defined by the user. New menu items are defined in a @{"menu definition file" link MENUFILE} which TTManager loads when it is first run. @endnode @node MENU_OPEN "TTManager Menus: Project - New & Open" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Project @{uu}@{bg background} @{bg shine}New... @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}N@{bg background} @{bg shine}Open... @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}O@{bg background} : @{u}@{b}New@{ub}@{uu} Opens a file requester for an icon to open. The selected file's icon will be opened in a new window. @{b}Menu Shortcut:@{ub} <Right Amiga> N @{u}@{b}Open@{ub}@{uu} Opens the selected file's icon in the current window. The window's previous contents are lost. This operation cannot be undone. @{b}Menu Shortcut:@{ub} <Right Amiga> O @endnode @node MENU_SAVE "TTManager Menus: Project - Save & Save As" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Project @{uu}@{bg background} : @{bg shine}Save @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}S@{bg background} @{bg shine}Save As... @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}A@{bg background} : @{u}@{b}Save@{ub}@{uu} Saves the icon using the path and name displayed in the window's @{"title bar" link GUI_TTLBAR} and @{"file name" link GUI_FNAME} string gadget. If the @{"Close After Save" link MENU_CAS} menu option is set the window will then close itself. @{b}Menu Shortcut:@{ub} <Right Amiga> S @{u}@{b}Save As@{ub}@{uu} Opens a file requester allowing you to save the icon under a different name. The original ".info" file (and any file it may belong to) are unchanged. @{b}Menu Shortcut:@{ub} <Right Amiga> A @endnode @node MENU_CLOSE "TTManager Menus: Project - Close & Close All" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Project @{uu}@{bg background} : @{bg shine}Close @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}1@{bg background} @{bg shine}Close All (Local) @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}2@{bg background} @{bg shine}Close All @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}!@{bg background} : @{u}@{b}Close@{ub}@{uu} Closes the current window. @{b}Menu Shortcut:@{ub} <Right Amiga> 1 @{u}@{b}Close All (Local)@{ub}@{uu} Closes all (TTManager) windows on the current screen. @{b}Menu Shortcut:@{ub} <Right Amiga> 2 @{u}@{b}Close All@{ub}@{uu} Closes all (TTManager) windows on all screens. @{b}Menu Shortcut:@{ub} <Right Amiga> ! @{b}Note:@{ub} If @{"Warnings" link MENU_WARN} are enabled, and the tooltypes have been modified, a confirmation requester will appear before the window is closed. @endnode @node MENU_ABOUT "TTManager Menus: Project - About" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Project @{uu}@{bg background} : @{bg shine}About... @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}?@{bg background} : @{u}@{b}About@{ub}@{uu} Displays the following information: * TTManager's version. * Copyright. * My e-mail address. * Translation credit (Only displayed when using a v3.1, or above, catalog). * Number of open windows and screens used. * The name of the icon being edited, if it's a default icon, and the number of colors in the icon's image. * The number of items in the undo buffer. @{b}Menu Shortcut:@{ub} <Right Amiga> ? @endnode @node MENU_QUIT "TTManager Menus: Project - Quit" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Project @{uu}@{bg background} : @{bg shine}Quit... @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}Q@{bg background} @{u}@{b}Quit@{ub}@{uu} Quits TTManager. Of little use; included for completeness. ;-) @{b}Menu Shortcut:@{ub} <Right Amiga> Q @{b}Note:@{ub} If @{"Warnings" link MENU_WARN} are enabled, and the tooltypes have been modified, a confirmation requester will appear before each window is closed, and one more requester will pop up before TTManager quits. @endnode @node MENU_CB "TTManager Menus: Edit - Cut, Copy, Paste, & the Clipboard Unit" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Edit @{uu}@{bg background} @{bg shine}Cut @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}X@{bg background} @{bg shine}Copy @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}C@{bg background} @{bg shine}Paste @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}V@{bg background} @{bg shine}Clear Clip @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}0@{bg background} @{bg shine}Clip Unit »@{bg background}->@{bg shine}./0@{bg background} : @{bg shine} 1@{bg background} @{bg shine} 2@{bg background} @{bg shine} 3@{bg background} @{bg shine} 4@{bg background} @{bg shine} 5@{bg background} @{bg shine} 6@{bg background} @{bg shine} 7@{bg background} @{bg shine} 8@{bg background} @{bg shine} 9@{bg background} @{u}@{b}Cut@{ub}@{uu} Copies the tooltype list to the clipboard, and then deletes the list. @{b}Menu Shortcut:@{ub} <Right Amiga> X @{u}@{b}Copy@{ub}@{uu} Copies the tooltype list to the clipboard. @{b}Menu Shortcut:@{ub} <Right Amiga> C @{u}@{b}Paste@{ub}@{uu} Inserts the contents of the clipboard into the tooltype list @{b}after@{ub} the current item. @{b}Menu Shortcut:@{ub} <Right Amiga> V @{u}@{b}Clear Clip@{ub}@{uu} Clears any text in the current clipboard unit. Useful with the @{b}Add to Clip@{ub} @{"edit mode" link GUI_EDIT}. @{b}Menu Shortcut:@{ub} <Right Amiga> 0 @{u}@{b}Clip Unit@{ub}@{uu} Allows you to select which clipboard unit (0 to 9) @{b}Cut@{ub}, @{b}Copy@{ub}, and @{b}Paste@{ub} will use. @endnode @node MENU_UNDO "TTManager Menus: Edit - Undo, Redo, & Flushing" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Edit @{uu}@{bg background} : @{bg shine}Undo @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}U@{bg background} @{bg shine}Redo @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}Z@{bg background} @{bg shine}Flush »@{bg background}->@{bg shine}Current Buffer @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}'@{bg background} @{bg shine}All Buffers @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}"@{bg background} @{u}@{b}Undo@{ub}@{uu} Clicking undo undoes the last operation. The number of operations which may be undone is set by the @{"MAXUNDO" link OPT_UNDO} tooltype or CLI option (the default is 10). @{b}Menu Shortcut:@{ub} <Right Amiga> U @{u}@{b}Redo@{ub}@{uu} Redo undoes an undo. :-) @{b}Menu Shortcut:@{ub} <Right Amiga> Z @{b}Note:@{ub} Nearly any operation which may be undone. Following is a list of the (few) actions which @{u}cannot@{uu} be undone: * Save * The @{"New" link MENU_OPEN} and @{"Open" link MENU_OPEN} menu options. * Closing the window. * Quitting TTManager. @{b}Flush:@{ub} @{u}@{b}Current Buffer@{ub}@{uu} Empties the current window's undo/redo buffer. Note that this cannot be undone. :-) @{b}Menu Shortcut:@{ub} <Right Amiga> ' @{u}@{b}All Buffers@{ub}@{uu} Each TTManager window has it's own undo buffer. This option empties the undo undo buffer in every TTManager window. @{b}Menu Shortcut:@{ub} <Right Amiga> " @endnode @node MENU_ITYPE "TTManager Menus: Information - Icon Type" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Information @{uu}@{bg background} @{bg shine}Icon Type »@{bg background}->@{bg Shine} Disk @{bg background} : @{bg shine} Drawer @{bg background} @{bg shine}./Tool @{bg background} @{bg shine} Project@{bg background} @{bg shine} Trash @{bg background} @{u}@{b}Icon Type@{ub}@{uu} Selects the icon type. @endnode @node MENU_DTM "TTManager Menus: Information - Default Tool" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Information @{uu}@{bg background} : @{bg shine}Default Tool »@{bg background}->@{bg Shine}Select...@{bg background} : @{bg shine}Clear @{bg background} @{bg shine}~~~~~~~~~@{bg background} @{bg shine} <user> @{bg background} : @{u}@{b}Default Tool@{ub}@{uu} Sets the icon's default tool. Select - Opens a file requester; the selected file will be the default tool. Clear - Sets the default tool to nothing. <user> - These menu items (up to 28) are defined in the @{"Menu File" link MENUFILE} (<menu id> = DEFAULTTOOL). When one of these items are selected the default tool is set to the name of the menu item. For example, if a menu item named "C:XIcon" is selected then the icon's default tool will become "C:XIcon". @endnode @node MENU_PB "TTManager Menus: Information - Protection" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Information @{uu}@{bg background} : @{bg shine}Protection »@{bg background}->@{bg Shine}./Readable @{bg background} : @{bg shine}./Writable @{bg background} @{bg shine}./Executable @{bg background} @{bg shine}./Deletable @{bg background} @{bg shine} Script @{bg background} @{bg shine} Pure @{bg background} @{bg shine}./Archived @{bg background} @{bg shine}~~~~~~~~~~~~~~~~~~~~@{bg background} @{bg shine} User @{bg background} @{bg shine}./Group - Readable @{bg background} @{bg shine} Group - Writable @{bg background} @{bg shine}./Group - Executable@{bg background} @{bg shine} Group - Deletable @{bg background} @{bg shine} Other - Readable @{bg background} @{bg shine} Other - Writable @{bg background} @{bg shine} Other - Executable@{bg background} @{bg shine} Other - Deletable @{bg background} @{u}@{b}Protection@{ub}@{uu} Sets the tool's, project's, or drawer's protection bits. Readable - The file may be read. Tools, projects, and drawers. Writable - The file may be written to. Tools, projects, and drawers. Executable - The file may be executed. Tools only. Deletable - The file may be deleted. Tools, projects, and drawers. Script - The file is an AmigaDOS script and may be run without having to use AmigaDOS's Execute command. Projects only. Pure - The file is pure and may be made resident. Tools only. Archived - The file has been backed up. Tools, projects, and drawers. The remaining bits are used by the MultiUser File System. If you do not have MuFS installed then setting or clearing these bits will have no effect on your ststem (although they will still be saved). @{b}Notes:@{ub} * Protection bits are actually stored along with a file, not in the icon, so the protection bits will be lost if no file exists when the icon is saved. * If multiuser.library is present in the LIBS: directory, then the MuSetProtection() function will be used to save the protection bits. Otherwise the regular dos.library SetProtection() call is used. @endnode @node MENU_COPYFROM "TTManager Menus: Information - Copy From..." @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Information @{uu}@{bg background} : @{bg shine}Copy From... @{bg background} @{bg shine} Stack @{bg background} @{bg shine} Default Tool @{bg background} @{bg shine}./ Comment @{bg background} @{bg shine}./ Protection @{bg background} @{u}@{b}Copy From...@{uu}@{ub} Opens a file requester allowing you to copy the attributes of another file. Only those attributes with a checkmark beside them will be copied. @{b}Notes:@{ub} * The checkable attributes also determine which attributes are copied when @{"icons are dropped" link DROPIT2} into the window when the @{"Information" link GUI_PAGE} page is active. * Comments and protection bits are stored with a file, not in the icon, and will not be copied if an icon without a file is selected. Likewise, if no file exists for the current icon then these attributes will be lost when the icon is saved. @endnode @node MENU_TTON "TTManager Menus: ToolTypes - Enable, Disable, & Toggle All" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ToolTypes @{uu}@{bg background} @{bg shine}Enable All @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}+@{bg background} @{bg shine}Disable All @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}-@{bg background} @{bg shine}Toggle All @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}\ @{bg background} : @{u}@{b}Enable All@{ub}@{uu} Removes any parentheses ("()") surrounding a tooltype. @{b}Menu Shortcut:@{ub} <Right Amiga> + @{u}@{b}Disable All@{ub}@{uu} Brackets all tooltypes with parentheses ("()"), thus disabling them. @{b}Menu Shortcut:@{ub} <Right Amiga> - @{u}@{b}Toggle All@{ub}@{uu} Any disabled tooltypes are enabled, and vice-versa. @{b}Menu Shortcut:@{ub} <Right Amiga> \ @endnode @node MENU_DEL "TTManager Menus: Edit - Delete" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ToolTypes @{uu}@{bg background} : @{bg shine}Delete »@{bg background}->@{bg shine}All @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}.@{bg background} : @{bg shine}Current To Top @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}<@{bg background} @{bg shine}Current To End @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}>@{bg background} @{b}Delete@{ub} @{u}@{b}All@{ub}@{uu} Deletes the entire tooltype list. @{b}Menu Shortcut:@{ub} <Right Amiga> . @{u}@{b}Current To Top@{ub}@{uu} Deletes the tooltypes from the currently selected one to the beginning of the list. @{b}Menu Shortcut:@{ub} <Right Amiga> < @{u}@{b}Current To End@{ub}@{uu} Deletes all tooltypes from the currently selected one onwards. @{b}Menu Shortcut:@{ub} <Right Amiga> > @endnode @node MENU_LDTT "TTManager Menus: ToolTypes - Loading From Icons & ASCII" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ToolTypes @{uu}@{bg background} : @{bg shine}Load From Icon »@{bg background} @{bg shine}Load From ASCII »@{bg background}->@{bg shine}Replace... @{bg background} : @{bg shine}Append... @{bg background} @{bg shine}Only New... @{bg background} @{bg shine}Only Existing...@{bg background} @{u}@{b}Load From Icon@{ub}@{uu} Pops up a file requester allowing you to add tooltypes from another icon(s) to the one currently being edited. @{u}@{b}Load From ASCII@{ub}@{uu} Same as above, only now the contents of the selected file(s) are added to the list. @{b}Replace@{ub} - The old tooltypes are replaced by the new ones. @{b}Append@{ub} - The new tooltypes are appended to the end of the tooltype list. @{b}Only New@{ub} - Each new tooltype is checked against the current list of tooltypes, and added to the end of the list if no match is found. @{b}Only Existing@{ub} - Similar to @{b}Only New@{ub}, except that if a match is found the new tooltype replaces the old one. The new tooltype is discarded if it isn't already in the list. @{b}Note:@{ub} * The modes @{b}Only New@{ub} and @{b}Only Existing@{ub} compare the tooltype's keyword. Given the tooltype "(LEFTEDGE=360)", these modes are looking for a match to "LEFTEDGE" (the keyword's value (if any) and whether it's enabled or disabled is ignorred). * These menu options are equivalent to setting the @{b}Load Mode@{ub} and @{b}From Type@{ub} cycle gadgets and pressing the @{"Load" link GUI_LOAD} button. @endnode @node MENU_SASCII "TTManager Menus: ToolTypes - Save As ASCII" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ToolTypes @{uu}@{bg background} : @{bg shine}Save As ASCII... @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}D@{bg background} : @{u}@{b}Save As ASCII@{ub}@{uu} Opens a file requester allowing you to save the tooltype list as a text file. An icon will be created for this file if the @{"Create Icons?" link MENU_ICONS} menu option is on. @{b}Menu Shortcut:@{ub} <Right Amiga> D @endnode @node MENU_SORT "TTManager Menus: ToolTypes - Sort" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ToolTypes @{uu}@{bg background} : @{bg shine}Sort @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}T@{bg background} : @{u}@{b}Sort@{ub}@{uu} Sorts the tooltype list into alphabetical order. @{b}Menu Shortcut:@{ub} <Right Amiga> T @{b}Note:@{ub} * The sort is case-sensitive. * The tooltypes are sorted by their keywords only, and their state (enabled or disabled) is ignorred. @endnode @node MENU_REV "TTManager Menus: ToolTypes - Reverse" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ToolTypes @{uu}@{bg background} : @{bg shine}Reverse @{bg shadow}@{fg shine}@{i}A @{ui}@{fg text}@{bg shine}R@{bg background} @{u}@{b}Reverse@{ub}@{uu} Reverses the order of the items in the tooltype list. @{b}Menu Shortcut:@{ub} <Right Amiga> R @endnode @node MENU_PWBI "TTManager Menus: Settings - Patch WBInfo" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} @{bg shine}./ Patch WBInfo? @{bg background} : @{u}@{b}Patch WBInfo@{ub}@{uu} When checked, TTManager will patch Workbench.Library's WBInfo() function, thus replacing Workbench's standard icon information requester with TTManager's @{"GUI" link THEGUI}. Deselecting this option will restore Workbench's standard requester. @{b}Notes:@{ub} * The @{"PATCHWBINFO" link OPT_PWBI} startup option may be used to enable this option when TTManager is first run. * This feature is only available with Workbench 3.0 or above. @endnode @node MENU_OI "TTManager Menus: Settings - Only Icons In File Requester" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Only Icons In File Req?@{bg background} : @{u}@{b}Only Icons In File Requester@{ub}@{uu} When checked, the default pattern for file requesters will be set to "#?.info", displaying only icons and directories. @{b}Note:@{ub} This option may activated at startup with the @{"ONLYICONSINFREQ" link OPT_VPOD} keyword. @endnode @node MENU_VPOD "TTManager Menus: Settings - Volume Page On Disk" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Volume Page On Disk? @{bg background} : @{u}@{b}Volume Page On Disk@{ub}@{uu} When checked, TTManager will display the @{"Volume Information" link GUI_PAGE} page when a disk icon is loaded. @{b}Note:@{ub} This option may activated at startup by the @{"VOLPAGEONDISK" link OPT_VPOD} keyword. @endnode @node MENU_MNV "TTManager Menus: Settings - Move If New Volume" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Move If New Volume? @{bg background} : @{u}@{b}Move If New Volume@{ub}@{uu} If checked and when a file has been renamed to a new volume in the @{"file name" link GUI_FNAME} gadget (for example, changing "DH0:T/This" to "DF0:That") and saved, then the original file will be deleted. Otherwise the original file will remain unmodified. @{b}Note:@{ub} This option may be enabled at startup by using the @{"MOVEIFNEWVOL" link OPT_MNV} keyword. @endnode @node MENU_CAD "TTManager Menus: Settings - Cursor At Data" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Cursor At Data? @{bg background} : @{u}@{b}Cursor At Data@{ub}@{uu} Sets the initial position of the cursor in the listview's @{"string gadget" link GUI_EDIT}. If enabled, and if the tooltype is of the format "<tooltype>=<value>", then the cursor will initially be positioned after the equal sign. Otherwise, it starts on the first character. @{b}Example:@{ub} Enabled: DEFAULTPATH=@{bg fill}X@{bg background}-Files:Text/ ^- Cursor position Disabled: @{bg fill}D@{bg background}EFAULTPATH=X-Files:Text/ ^- Cursor position @{b}Note:@{ub} This option may be enabled at startup by using the @{"CURSORATDATA" link OPT_CAD} keyword. @endnode @node MENU_CAS "TTManager Menus: Settings - Close After Save" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Close After Save? @{bg background} : @{u}@{b}Close After Save@{ub}@{uu} If this menu item is checked, the window will be closed after performing a Save. Otherwise the window remains open. @{b}Note:@{ub} This option may be turned on at startup by using the @{"CLOSEAFTERSAVE" link OPT_CAS} keyword. @endnode @node MENU_WARN "TTManager Menus: Settings - Warnings" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Warnings? @{bg background} : @{u}@{b}Warnings@{ub}@{uu} If this menu item is checked, TTManager will pop up a confirmation requester before certain important actions are performed, such as closing a window when the tooltypes have been modified but not saved, or quitting the program. @{b}Note:@{ub} This option may be turned off on startup by using the @{"NOWARNINGS" link OPT_NW} keyword. @endnode @node MENU_ICONS "TTManager Menus: Settings - Create Icons" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Create Icons? @{bg background} @{u}@{b}Create Icons@{ub}@{uu} An odd option, eh? :-) If this item is checked, then the text file created by the @{"Save As ASCII" link MENU_SASCII} menu option will have an icon. @{b}Note:@{ub} This option may be turned off on startup by using the @{"NOICONS" link OPT_NI} keyword. @endnode @node MENU_SNAP "TTManager Menus: Settings - Snapshot" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}Snapshot @{bg background} @{u}@{b}Snapshot@{ub}@{uu} Sets TTManager's @{"LEFTEDGE" link OPT_POS}, @{"TOPEDGE" link OPT_POS}, @{"WIDTH" link OPT_DIM}, and @{"HEIGHT" link OPT_DIM} tooltypes to the position and size of the current window. A default icon will be created if none was found. @endnode @node MENU_RX "TTManager Menus: ARexx - Excecute Script" @toc MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ARexx @{uu}@{bg background} : @{bg shine}Execute... @{bg background} : @{bg shine}~~~~~~~~~~~~@{bg background} @{bg shine}<script> @{bg background} : @{u}@{b}Execute@{ub}@{uu} Opens a file requester and runs the selected ARexx script. @{u}@{b}<script>@{ub}@{uu} These menu items (up to 58) are defined by the user in the @{"menu file" link MENUFILE} (<menu id> = AREXX_SCRIPT). When selected, the ARexx script given as the <command> argument is executed. @endnode @node MENU_RXAUTO "TTManager Menus: ARexx - Auto Executing Scripts" @toc MENUS @next MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}ARexx @{uu}@{bg background} : @{bg shine}Auto Open »@{bg background}->@{bg shine}./ <user item>@{bg background} @{bg shine}Auto Close »@{bg background} : : @{u}@{b}Auto-Executing ARexx Scripts@{ub}@{uu} These checkmarkable menu items (up to 31) are defined by the user in the @{"menu file" link MENUFILE} (<menu id> = AREXX_AUTOOPEN or AREXX_AUTOCLOSE). Any items which are checked will be automatically executed (the <command> argument) when a TTManager window is opened or closed. The scripts are executed synchronously, beginning with the top-most script in the menu, and continuing until all the checkmarked scripts have been run. @{b}Auto Open Scripts@{ub} Executed after a window has been opened, before control passes to the user. @{b}Auto Close Scripts@{ub} Not yet implemented. @endnode @node KEYS "TTManager: Keyboard Shortcuts" @prev MENUS @{u}@{b}Gadget Keys - Global:@{ub}@{uu} File string gadget i Page cycle gadget p, P Undo button u Redo button r Save button s Save As button a Cancel button c @{u}@{b}Gadget Keys - Information Page:@{ub}@{uu} Stack integer gadget k Default Tool string gadget t Comment gadget o @{u}@{b}Gadget Keys - ToolType Page:@{ub}@{uu} Load button l Load Mode cycle gadget m, M From Type cycle gadget f, F Keys are case-insensitive except for the cycle gadget shortcuts. With a cycle gadget, the shifted key will cycle backwards through the available options. @{u}@{b}Menu Shortcuts:@{ub}@{uu} @{bg shine}@{u}Project @{uu}@{bg background} New... @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} N Open... @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} O Save @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} S Save As... @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} A Close @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} 1 Close All (Local) @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} 2 Close All @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} ! About... @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} ? Quit @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} Q @{bg shine}@{u}Edit @{uu}@{bg background} Cut @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} X Copy @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} C Paste @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} V Undo @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} U Redo @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} Z Flush » Current Buffer @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} ' All Buffers @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} " @{bg shine}@{u}Tooltypes @{uu}@{bg background} Enable All @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} + Disable All @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} - Toggle All @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} \ Delete » All @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} . Current To Top @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} < Current To End @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} > Save As ASCII... @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} D Sort @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} T Reverse @{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background} R "@{bg shadow}@{fg background}@{i}A @{ui}@{fg text}@{bg background}" stands for the right Amiga key. @endnode @node AREXX "TTManager: ARexx Interface" @next DAMMIT @{u}@{b}ARexx:@{ub}@{uu} TTManager's port name is "TTMANAGER". Commands: @{"About " link RX_ABOUT} @{"AddToClip " link RX_CBADD} @{"AddTooltype " link RX_TTADD} * @{"BooleanToggleTooltype" link RX_TTBTGL} * @{"ChangeWindow " link RX_CHWIN} * @{"ClearClip " link RX_CBCLR} @{"CloseWindow " link RX_CLOSEWIN} * @{"DeleteTooltype " link RX_TTDEL} * @{"DuplicateTooltype " link RX_TTDUP} * @{"Flush Undo " link RX_UNDO} * @{"GetClipUnit " link RX_CBUNIT} @{"SetClipUnit " link RX_CBUNIT} @{"GetComment " link RX_CMT} * @{"SetComment " link RX_CMT} @{"GetDefaultDir " link RX_DIRS} @{"SetDefaultDir " link RX_DIRS} @{"RestoreDefaultDir" link RX_DIRS} @{"GetDefaultTool " link RX_DTOOL} * @{"SetDefaultTool " link RX_DTOOL} @{"GetFilename " link RX_FNAME} * @{"SetFilename " link RX_FNAME} @{"GetFont " link RX_FONT} @{"SetFont " link RX_FONT} @{"GetIconType " link RX_ITYPE} * @{"SetIconType " link RX_ITYPE} @{"GetLanguage " link RX_LINGO} @{"SetLanguage " link RX_LINGO} @{"GetScreen " link RX_SCRN} @{"SetScreen " link RX_SCRN} @{"GetStack " link RX_STACK} * @{"SetStack " link RX_STACK} @{"GetTooltype " link RX_TT} * @{"SetTooltype " link RX_TT} @{"GetTooltypeList " link RX_TTLIST} * @{"SetTooltypeList " link RX_TTLIST} @{"GetTTListCurrent " link RX_TTCRNT} * @{"SetTTListCurrent " link RX_TTCRNT} @{"GetTTListTotal " link RX_TTTOT} * @{"GetWindowDims " link RX_WDIMS} @{"SetWindowDims " link RX_WDIMS} @{"GetWindowList " link RX_WINLIST} @{"MoveTooltype " link RX_TTMOV} * @{"New " link RX_NEW} @{"NewWindow " link RX_NEW} @{"Quit " link RX_QUIT} @{"ReadClip " link RX_CBREAD} @{"RequestChoice " link RX_REQCH} @{"ReverseTooltypeList " link RX_TTLREV} * @{"SetTooltypeState " link RX_TTSTATE} * @{"SortTooltypeList " link RX_TTSORT} * @{"TooltypeListToClip " link RX_TTLISTCLIP} * @{"ClipToTooltypeList " link RX_TTLISTCLIP} @{"TooltypeToClip " link RX_TTCLIP} * @{"Undo " link RX_UNDO} * @{"Redo " link RX_UNDO} * These commands require a TTManager window to be open. @endnode @node RX_ABOUT "TTManager ARexx: About" @toc AREXX @{u}@{b}About@{ub}@{uu} Opens the About requester, displaying the following information: * TTManager's version. * Copyright. * My e-mail address. * Translation credit (Only displayed when using a v3.1, or above, catalog). * Number of open windows and screens used. * The name of the icon being edited, if it's a default icon, and the number of colors in the icon's image. * The number of items in the undo buffer. ...and an "Open..." button allowing a new icon to be opened. @{b}Usage:@{ub} About @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_CBADD "TTManager ARexx: AddToClip" @toc AREXX @{u}@{b}AddToClip@{ub}@{uu} Appends text to the current clipboard unit. @{b}Usage:@{ub} AddToClip <text> <text> - Text to add to the clipboard. This text will be appended to the clipboard's current contents. Enclose <text> in quotation marks if it contains spaces. Enter "*n" to insert a linefeed. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @{b}Example:@{ub} /* */ ADDRESS 'TTMANAGER' 'CLEARCLIP' 'ADDCLIP "One"' 'ADDCLIP "Two*nThree"' 'ADDCLIP "Four"' 'READCLIP cb' DO i = 0 TO cb.count - 1 SAY cb.i END Output will be: One Two Three Four @endnode @node RX_TTADD "TTManager ARexx: AddTooltype" @toc AREXX @{u}@{b}AddTooltype@{ub}@{uu} Adds a tooltype to the current window's tooltype list. * This command requires a TTManager window to be open. @{b}Usage:@{ub} AddTooltype <tooltype> [position] <tooltype> - The new tooltype to add to the list. Enclose <tooltype> in quotation marks if it contains spaces. Tooltype should be less than 128 characters long. <position> - Where <tooltype> appears in the list. The first tooltype is position 0. Defaults to after the currently selected tooltype. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Examples:@{ub} Beginning tooltype list: LEFTEDGE=100 TOPEDGE=15 Current tooltype -> (WIDTH=) (HEIGHT=) 'ADDTOOLTYPE "DONOTWAIT" 0' New tooltype list: DONOTWAIT LEFTEDGE=100 TOPEDGE=15 Current tooltype -> (WIDTH=) (HEIGHT=) 'ADDTOOLTYPE "DEFAULTREXXDIR=S:Rexx/"' New tooltype list: DONOTWAIT LEFTEDGE=100 TOPEDGE=15 (WIDTH=) Current tooltype -> DEFAULTREXXDIR=S:Rexx/ (HEIGHT=) @endnode @node RX_TTBTGL "TTManager ARexx: BooleanToggleTooltype" @toc AREXX @{u}@{b}BooleanToggleTooltype@{ub}@{uu} If the tooltype has a boolean value, this command will switch it to the opposite state; otherwise the tooltype is unchanged. The recognized boolean pairs are: ON/OFF, YES/NO, and TRUE/FALSE. * This command requires a TTManager window to be open. @{b}Usage:@{ub} BooleanToggleTooltype [position] <position> - Which tooltype to perform the boolean toggle on. The first tooltype is position 0. Defaults to the currently selected tooltype. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Examples:@{ub} Beginning tooltype list: TOPEDGE=15 (CLOSEWORKBENCH=YES) Current tooltype -> AUTOSAVE=ON 'BOOLEANTOGGLETOOLTYPE' New tooltype list: TOPEDGE=15 (CLOSEWORKBENCH=YES) Current tooltype -> AUTOSAVE=OFF 'BOOLEANTOGGLETOOLTYPE 1' New tooltype list: TOPEDGE=15 (CLOSEWORKBENCH=NO) Current tooltype -> AUTOSAVE=OFF @endnode @node RX_CHWIN "TTManager ARexx: ChangeWindow" @toc AREXX @{u}@{b}ChangeWindow@{ub}@{uu} Changes the active TTManager window. * This command requires a TTManager window to be open. @{b}Usage:@{ub} ChangeWindow [<win ID>] [PREV] [NEXT] [WRAP] [CS=CURRENTSCREEN] <win ID> - Activates the window with ID number <win ID>. ID numbers can be found using the @{"WindowList" link RX_WINLIST} command. PREV - Activates the previous window. NEXT - Activates the next window. WRAP - If specified, will activate the first window if "NEXT" is used on the last window, or the last window if "PREV" is used on the first window. Also handles when <win #> is less than 0 or greater than the number of windows open. CURRENTSCREEN - If specified, NEXT and PREV only operate on windows on the current screen. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_CBCLR "TTManager ARexx: ClearClip" @toc AREXX @{u}@{b}ClearClip@{ub}@{uu} Clears the current clipboard unit. @{b}Usage:@{ub} ClearClip @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_CLOSEWIN "TTManager ARexx: CloseWindow" @toc AREXX @{u}@{b}CloseWindow@{ub}@{uu} Closes a window. * This command requires a TTManager window to be open. @{b}Usage:@{ub} CloseWindow [<win ID>] [FORCE] [ALL] [CS=CURRENTSCREEN] <win ID> - Closes the window with ID number <win ID>. ID numbers can be found using the @{"WindowList" link RX_WINLIST} command. Defaults to the current window. FORCE - The user can't prevent the window from closing. ALL - Close all TTManager windows on all screens. CURRENTSCREEN - Modifies the ALL option so that all the windows on just the current screen are closed. @{b}Results:@{ub} rc - 5 (WARN) = Window(s) not closed. result - Not used. @endnode @node RX_TTDEL "TTManager ARexx: DeleteTooltype" @toc AREXX @{u}@{b}DeleteTooltype@{ub}@{uu} Deletes one or more tooltypes. * This command requires a TTManager window to be open. @{b}Usage:@{ub} DeleteTooltype [<num>] [ALL | TOTOP | TOEND] <num> - The tooltype to delete. 0 = First tooltype. Defaults to the current tooltype. ALL - Deletes the entire tooltype list. TOTOP - Delete from the first tooltype to the current one. TOEND - Deletes the current tooltype and all following ones. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Example:@{ub} Beginning tooltype list: (--- Do Not Delete These Lines ---) IMG=kpvsoi40584rtsg8)7e6g4r7644g3s4 IMG=8we8rr384t7u68646hb8ed6845w8trg IMG=w738r238rw837rw87rw68ht84fr8r3w Current tooltype -> (---------------------------------) (DONOTWAIT) STARTPRI=2 'DELETETOOLTYPE TOTOP' New tooltype list: Current tooltype -> (DONOTWAIT) STARTPRI=2 @endnode @node RX_TTDUP "TTManager ARexx: DuplicateTooltype" @toc AREXX @{u}@{b}DuplicateTooltype@{ub}@{uu} Clones a tooltype. * This command requires a TTManager window to be open. @{b}Usage:@{ub} DuplicateTooltype [<num>] <num> - The tooltype to duplicate. 0 = First tooltype. Defaults to the current tooltype. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Example:@{ub} Beginning tooltype list: Zero One Current tooltype -> Two Three 'DUPLICATETOOLTYPE' New tooltype list: Zero One Two Current tooltype -> Two Three @endnode @node RX_UNDO "TTManager ARexx: Undo, Redo, & FlushUndo" @toc AREXX @{u}@{b}Undo@{ub}@{uu} Undoes the last change. @{b}Usage:@{ub} Undo --- @{u}@{b}Redo@{ub}@{uu} Undoes an Undo. @{b}Usage:@{ub} Redo --- @{u}@{b}FlushUndo@{ub}@{uu} Clears the current window's undo buffer. @{b}Usage:@{ub} FlushUndo [ALL] ALL - Clear every window's undo buffer. * Undo, Redo, and FlushUndo require a TTManager window to be open. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_CBUNIT "TTManager ARexx: GetClipUnit & SetClipUnit" @toc AREXX @{u}@{b}GetClipUnit@{ub}@{uu} Returns the currently active clipboard unit. @{b}Usage:@{ub} GetClipUnit @{b}Results:@{ub} rc - Always 0 (OK). result - The clipboard unit, 0 - 9. --- @{u}@{b}SetClipUnit@{ub}@{uu} Sets which clipboard unit TTManager's various clipboard functions will access. @{b}Usage:@{ub} SetClipUnit <num> <num> - The clipboard unit to use; a number from 0 to 9. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_CMT "TTManager ARexx: GetComment & SetComment" @toc AREXX @{u}@{b}GetComment@{ub}@{uu} Get's the current icon's comment. * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetComment @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The comment. --- @{u}@{b}SetComment@{ub}@{uu} Sets the current icon's comment. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetComment <text> <text> - The comment. Enclose in quotation marks if <text> contains spaces. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_DIRS "TTManager ARexx: GetDefaultDir & SetDefaultDir" @toc AREXX @{u}@{b}GetDefaultDir@{ub}@{uu} Returns the default file requester path. @{b}Usage:@{ub} GetDefaultDir [ASCII] [AREXX] ASCII - Return the default ASCII path. AREXX - Return the default ARexx path. @{b}Results:@{ub} rc - Always 0 (OK). result - The default path. --- @{u}@{b}SetDefaultDir@{ub}@{uu} Sets the default path used by file requesters. @{b}Usage:@{ub} SetDefaultDir <path> [ASCII] [AREXX] <path> - The new default path. ASCII - Make <path> the default ACSII path. AREXX - Make <path> the default ARexx path. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. --- @{u}@{b}RestoreDefaultDir@{ub}@{uu} Resets the path used by file requesters to the default path. @{b}Usage:@{ub} SetDefaultDir [DEFAULT] [ASCII] [AREXX] [ALL] DEFAULT - Restore the default path. ASCII - Restore the default ACSII path. AREXX - Restore the default ARexx path. ALL - Restore all paths to their defaults. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_DTOOL "TTManager ARexx: GetDefaultTool & SetDefaultTool" @toc AREXX @{u}@{b}GetDefaultTool@{ub}@{uu} Get's the current icon's default tool. * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetDefaultTool @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The default tool. --- @{u}@{b}SetDefaultTool@{ub}@{uu} Set's the current icon's default tool. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetDefaultTool [<filename>] <filename> - The default tool to use. A file requester will pop up if none is supplied. Enclose in quotation marks if <filename> contains spaces. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_FNAME "TTManager ARexx: GetFilename & SetFilename" @toc AREXX @{u}@{b}Get Filename@{ub}@{uu} Returns the current icon's filename (and path). * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetFilename @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The filename. --- @{u}@{b}Set Filename@{ub}@{uu} Sets the current icon's filename. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetFilename [<filename>] <filename> - New path/name for this icon. A file requester will pop up if none is supplied. Enclose in quotation marks if <filename> contains spaces. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_FONT "TTManager ARexx: GetFont & SetFont" @toc AREXX @{u}@{b}GetFont@{ub}@{uu} Returns the font name and size in a stem variable. @{b}Usage:@{ub} GetFont <stem> <stem> - A variable to copy the font data into. @{b}Results:@{ub} <stem>.name = Font's name. <stem>.size = Font's size. rc - Always 0 (OK). result - Not used. --- @{u}@{b}SetFont@{ub}@{uu} Set the font all new windows will use. @{b}Usage:@{ub} SetFont <name> <size> <name> - The font's name. It isn't necessary to supply the ".font" extension. <size> - The font's size. @{b}Notes:@{ub} - To avoid GUI layout errors, close all windows before using SetFont. - If the specified font can't be opened, TTManager will use the screen's font. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_ITYPE "TTManager ARexx: GetIconType & SetIconType" @toc AREXX @{u}@{b}GetIconType@{ub}@{uu} Returns the current icon's type (Tool, Project, etc.) * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetIconType @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - DISK, DRAWER, TOOL, PROJECT, or GARBAGE. --- @{u}@{b}SetIconType@{ub}@{uu} Changes the icon's type. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetIconType <type> <type> = DISK, DRAWER, TOOL, PROJECT, OR GARBAGE. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_LINGO "TTManager ARexx: GetLanguage & SetLanguage" @toc AREXX @{u}@{b}GetLanguage@{ub}@{uu} Returns the name of the current locale. @{b}Usage:@{ub} GetLanguage @{b}Results:@{ub} rc - Always 0 (OK). result - The locale name (ex: "greek"). --- @{u}@{b}SetLanguage@{ub}@{uu} Switch to a different language. @{b}Usage:@{ub} SetLanguage <locale> <locale> - The name of the new locale to use (a ttmanager.catalog must exist for this language). Enclose in quotation marks; locales are case-sensitive. @{b}Note:@{ub} To avoid GUI layout errors, close all windows before using SetLanguage. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_SCRN "TTManager ARexx: GetScreen & SetScreen" @toc AREXX @{u}@{b}GetScreen@{ub}@{uu} Returns the name of the current screen which windows and requesters will open on. @{b}Usage:@{ub} GetScreen @{b}Results:@{ub} rc - Always 0 (OK). result - The screen's name. --- @{u}@{b}SetScreen@{ub}@{uu} Instruct windows to open on a different screen. @{b}Usage:@{ub} SetScreen [<screen name>] [DEF=DEFAULT] <screen name> - The name of the public screen to use. TTManager will use the default public screen if this one doesn't exist. DEFAULT - Use the default public screen. This is the same as calling SetScreen with no arguments. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_STACK "TTManager ARexx: GetStack & SetStack" @toc AREXX @{u}@{b}GetStack@{ub}@{uu} Returns the current icon's stack size. @{b}Usage:@{ub} GetStack * This command requires a TTManager window to be open. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The stack size. --- @{u}@{b}SetStack@{ub}@{uu} Sets the size of the current icon's stack. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetStack <num> <num> - The new stack size. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_TT "TTManager ARexx: GetToolType & SetTooltype" @toc AREXX @{u}@{b}GetToolType@{ub}@{uu} Fetch a tooltype. * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetToolType [<num>] <num> - The tooltype to get. Defaults to the current tooltype. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The tooltype. --- @{u}@{b}SetToolType@{ub}@{uu} Replaces a tooltype with new text. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetToolType [<num>] <text> <num> - The tooltype to set. Defaults to the current tooltype. <text> - The new text for the tooltype. Enclose in quotation marks if <text> contains spaces. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_TTLIST "TTManager ARexx: GetTooltypeList & SetTooltypeList" @toc AREXX @{u}@{b}GetTooltypeList@{ub}@{uu} Returns all tooltypes in a stem variable. * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetTooltypeList <stem> <stem> - A variable to copy the tooltype data into. @{b}Results:@{ub} <stem>.count = Total number of tooltypes. <stem>.current = The number of the currently selected tooltype. -1 = No tooltype selected. <stem>.0 to <stem>.(count-1) = The tooltypes. rc - 5 (WARN) = No open windows. result - Not used. --- @{u}@{b}SetTooltypeList@{ub}@{uu} Replace the entire tooltype list. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetTooltypeList <stem> <stem> - A list of new tooltypes. <stem>.0 to <stem>.n = The new tooltypes. <stem>.current = The current tooltype. Not required. It isn't necessary to supply <stem>.count. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_TTTOT "TTManager ARexx: GetTTListTotal" @toc AREXX @{u}@{b}GetTTListTotal@{ub}@{uu} Returns how many tooltypes the current icon has. @{b}Usage:@{ub} GetTTListTotal @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The total number of tooltypes. @endnode @node RX_TTCRNT "TTManager ARexx: GetTTListCurrent & SetTTListCurrent" @toc AREXX @{u}@{b}GetTTListCurrent@{ub}@{uu} Return the current tooltype's position in the list. * This command requires a TTManager window to be open. @{b}Usage:@{ub} GetTTListCurrent @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - The tooltype's position. 0 = top of list). -1 = No tooltype selected. --- @{u}@{b}SetTTListCurrent@{ub}@{uu} Set the current tooltype. * This command requires a TTManager window to be open. @{b}Usage:@{ub} SetTTListCurrent [<num>] [PREV] [NEXT] [WRAP] <num> - Make this tooltype the currently selected one. PREV - Select the previous tooltype. NEXT - Select the next tooltype. WRAP - When specified, the first tooltype will become selected if <num> is greater than the total number of tooltypes in the list or NEXT is used when the current tooltype is the last in the list. Likewise, the last tooltype will be selected if PREV is used on the first tooltype, or <num> is less than zero. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_WDIMS "TTManager ARexx: GetWindowDims & SetWindowDims" @toc AREXX @{u}@{b}GetWindowDims@{ub}@{uu} Returns window position and dimension data. @{b}Usage:@{ub} GetWindowDims <stem> [DEF=DEFAULT] <stem> - A variable to copy the window data into. DEFAULT - The values returned are the default window settings, otherwise the data are the current dimensions of the current window. @{b}Results:@{ub} <stem>.x = Window's left edge. <stem>.y = Window's top edge. <stem>.width = Window's width. <stem>.height = Window's height. <stem>.cascadex = Offset to add to the default left edge of each new window. <stem>.cascadey = Offset to add to the default top edge of each new window. rc - Always 0 (OK). result - Not used. --- @{u}@{b}SetWindowDims@{ub}@{uu} Change the current window's dimension, or the default settings. @{b}Usage:@{ub} SetWindowDims [X=LEFTEDGE] [Y=TOPEDGE] [W=WIDTH] [H=HEIGHT] [CSCX=CASCADEX] [CSCY=CASCADEY] [DEF=DEFAULT] LEFTEDGE, TOPEDGE - Set window's position. WIDTH, HEIGHT - Set window's dimensions. CASCADEX, CASCADEY - Set the tiling offsets. DEFAULT - Alter the default window settings, otherwise the current window is moved and/or resized. There is no difference between the current and default CascadeX and CascadeY values. @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_WINLIST "TTManager ARexx: GetWindowList" @toc AREXX @{u}@{b}GetWindowList@{ub}@{uu} Return information about all open windows. @{b}Usage:@{ub} GetWindowList <stem> [CS=CURRENTSCREEN] <stem> - A varaible to copy the window data into. CURRENTSCREEN - Just return info about the windows on the current screen. @{b}Results:@{ub} <stem>.count = Number of windows open. <stem>.current = ID of the current window. <stem>.<n>.name = Filename of icon in window <n>. <stem>.<n>.id = Window <n>'s ID. <stem>.<n>.<screen> - Name of the screen window <n> is on. (<n> = 0 to count-1) rc - Always 0 (OK). result - Not used. @endnode @node RX_TTMOV "TTManager ARexx: MoveTooltype" @toc AREXX @{u}@{b}MoveTooltype@{ub}@{uu} Moves a tooltype to another position in the tooltype list. * This command requires a TTManager window to be open. @{b}Usage:@{ub} MoveTooltype [FROM <num>] TO <num> FROM - The tooltype to be moved. 0 = first tooltype. Defaults to the current tooltype. TO - The position to move the tooltype to. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Example:@{ub} Beginning tooltype list: Zero One Current tooltype -> Two Three 'MOVETOOLTYPE TO 3' New tooltype list: Zero One Three Current tooltype -> Two @endnode @node RX_NEW "TTManager Arexx: New, NewWindow" @toc AREXX @{u}@{b}New, NewWindow@{ub}@{uu} Open new TTManager windows. @{b}Usage:@{ub} New [<filename> <filename> ...] <filename> - The name of an icon/file to open. Multilpe filenames may be supplied. If no <filename> is given, a file requester will open. Enclose <filename> in quotation marks if it contains spaces. @{b}Results:@{ub} rc - 10 (ERROR) if <filename> couldn't be loaded. result - Not used. @endnode @node RX_CBREAD "TTManager ARexx: ReadClip" @toc AREXX @{u}@{b}ReadClip@{ub}@{uu} Copies the contents of the current clipboard unit into a compound variable. @{b}Usage:@{ub} ReadClip <stem> <stem> - Variable to hold clipboard contents. @{b}Results:@{ub} <stem>.count - Number of lines of text. <stem>.0 to <stem>.count-1 - Clipboard text. rc - Always 0 (OK). result - Not used. @{b}Example:@{ub} /* Print clip unit 0's contents */ 'SETCLIPUNIT 0' 'READCLIP cb' SAY cb.count 'lines.' DO i = 0 TO cb.count - 1 SAY cb.i END @endnode @node RX_TTLREV "TTManager ARexx: ReverseTooltypeList" @toc AREXX @{u}@{b}ReverseTooltypeList@{ub}@{uu} Reverses the order of the tooltypes in the tooltype list. The last tooltype becomes the first, etc. * This command requires a TTManager window to be open. @{b}Usage:@{ub} ReverseTooltypeList @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Example:@{ub} Beginning tooltype list: Zero One Current tooltype -> Two Three 'REVERSETOOLTYPELIST' New tooltype list: Three Current tooltype -> Two One Zero @endnode @node RX_REQCH "TTManager ARexx: RequestChoice" @toc AREXX @{u}@{b}RequestChoice@{ub}@{uu} Opens a requester, displaying some text and buttons. @{b}Usage:@{ub} RequestChoice TITLE <text> BODY <text> [BUTTONS <text>] TITLE <text> - The requester's title. BODY <text> - Text to appear inside the requester. BUTTONS <text> - Seperate buttons with the "|" character. Ex: "Yes|Maybe|No" If omitted, one button named "Okay" will be displayed. @{b}Notes:@{ub} - Enclose in quotation marks any text containing spaces. - Use "*n" to insert a linefeed. @{b}Results:@{ub} rc - Always 0 (OK). result - The number of the button the user pressed. The rightmost button (usually the cancel option) is number "0", thus the buttons are numbered: 1, 2, 3, ..., 0. @endnode @node RX_STATE "TTManager ARexx: SetTooltypeState" @toc AREXX @{u}@{b}SetTooltypeState@{ub}@{uu} Adds or removes parentheses around a tooltype, thus making it active or inactive. @{b}Usage:@{ub} SetTooltypeState [<num> | ALL] [ON=ACTIVE | OFF=INACTIVE | TOGGLE] <num> - The tooltype to modify. 0 = First tooltype. Defaults to the current tooltype. ALL - Modify the entire tooltype list. ACTIVE - Make the tooltype active (remove any bracketing parentheses). INACTIVE - Encloses the tooltype in parentheses. TOGGLE - Inactive tooltypes become avtive, and vice-versa. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Example:@{ub} Beginning tooltype list: TOPEDGE=15 (CLOSEWORKBENCH=YES) AUTOSAVE=ON 'SETTOOLTYPESTATE ALL TOGGLE' New tooltype list: (TOPEDGE=15) CLOSEWORKBENCH=YES (AUTOSAVE=ON) @endnode @node RX_TTSORT "TTManager ARexx: SortTooltypeList" @toc AREXX @{u}@{b}SortTooltypeList@{ub}@{uu} As the name implies, this sorts the tooltype list. Tooltypes are sorted alphabetically, by their keywords. The tooltype's value (if it has one) and whether or not it's disabled is ignorred. @{b}Usage:@{ub} SortTooltypeList @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @{b}Example:@{ub} Beginning tooltype list: TOPEDGE=15 (CLOSEWORKBENCH=YES) AUTOSAVE=ON 'SORTTOOLTYPELIST' New tooltype list: AUTOSAVE=ON (CLOSEWORKBENCH=YES) TOPEDGE=15 @endnode @node RX_TTLISTCLIP "TTManager ARexx: TooltypeListToClip & ClipToTooltypeList" @toc AREXX @{u}@{b}TooltypeListToClip@{ub}@{uu} Copies the tooltype list to the current clipboard unit. It can also delete the tooltype list after copying it. @{b}Usage:@{ub} ToolTypelistToClip [CUT] CUT - The tooltype list will be deleted after being copied to the clipboard. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. --- @{u}@{b}ClipToTooltypeList@{ub}@{uu} Copied the contents of the current clipboard unit into the tooltype list. @{b}Usage:@{ub} ClipToTooltypeList [<position>] <position> - Where in the list the clipboard contents will be inserted at. Defaults to just after the current tooltype. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_ "TTManager ARexx: TooltypeToClip" @toc AREXX @{u}@{b}@TooltypeToClip{ub}@{uu} Copies a tooltype into the current clipboard unit, appending it to any existing clipboard data. @{b}Usage:@{ub} TooltypeToClip [<num>] [CUT] <num> - The tooltype to append to the clipboard. CUT - Delete the tooltype after appending it. @{b}Results:@{ub} rc - 5 (WARN) = No open windows. result - Not used. @endnode @node RX_QUIT "TTManager ARexx: QUIT" @toc AREXX @next AREXX @{u}@{b}Quit@{ub}@{uu} Quits TTManager. If warnings are enabled the user may abort this command. @{b}Usage:@{ub} Quit @{b}Results:@{ub} rc - Always 0 (OK). result - Not used. @endnode @node RX_ "TTManager ARexx: " @toc AREXX @{u}@{b}@{ub}@{uu} @{b}Usage:@{ub} @{b}Results:@{ub} rc - Always 0 (OK). rc - 5 (WARN) = No open windows. result - Not used. @endnode @node DAMMIT "TTManager: @#%*!!!" @prev AREXX @{u}@{b}Known Bugs:@{ub}@{uu} - Crashes when memory is very low. If you come across any bugs, please report them to @{"me" link SMEGHEAD}. @endnode @node NOTES "TTManager: Be Advised..." @{u}@{b}Notes:@{ub}@{uu} - @{b}Sort@{ub} and the @{b}Only ...@{ub} load modes compare the tooltype's keyword, and ignore any value or whether it's disabled or not. This is a feature, not a bug. :-) - The various options in the @{b}Settings@{ub} menu are shared by all TTManager windows (this is intentional). - The @{b}About@{ub} requester's text isn't yet attractively formatted. - TTManager's tooltype list is (currently) limited to around 65,534 tooltypes (if you call that a limit (show me the program that uses 60,000+ tooltypes! :-) )). - TTManager's windows aren't independent processes. If one window is performing a time consuming task (sorting 60,000 tooltypes? :-) ) input to other TTManager windows will be blocked. In practice, this isn't something which is likely to be noticed. - Protection bits and comments are stored with a file, not in the icon. So if you save an icon and there isn't a file that goes along with it the comment and protection bit settings will be lost. - TTManager can now move a file across volumes. For example, "DH0:T/Maybe" could be renamed and moved to "DF0:Definitely". In cases such as this, the file is actually copied (using the AmigaDOS Copy command). The original file may be deleted or left unchanged, depending on the @{"Move If New Volume" link MENU_MNV} setting. - Drawer icons without drawers, dropped onto the AppIcon or AppWindow, will not be loaded (TTManager recieves an appmessage, but no lock). Using the file requester to select them works. - The DEFAULTTOOLMENU keyword no longer exists. Instead, menu items are added via a @{"menu definition" link MENUFILE} file. @endnode @node LOCALE "TTManager: Now Yer Speakin' My Language!" @{u}@{b}Localization:@{ub}@{uu} As of version 2.2, TTManager supports localization. To use TTManager in the language of your choice you'll need WorkBench 2.1 or above, and a catalog file (ttmanager.catalog) for your language. Currently, there are catalogs for the following languages: - Czech - Created by Radim Demel. <demel.radim@opf.slu.cz> - French - Created by Frederic Delacroix. <fdelacroix@nordnet.fr> - German - Created by Gerald Schnabel. <Gerri@studbox.uni-stuttgart.de> - Greek - Created by Alexandros Vellis. <avellis@pemail.net> - Polish - Created by Lukasz Jodlowski. <ljodlo@ucku4.uck.pk.edu.pl> - Swedish - Created by Fredrik Ismyren. <myrn@tjohoo.se> If you're interested in creating a catalog or translating the docs then please e-mail me, and I'll let you know if anyone is currently doing so. @{b}Notes:@{ub} - The catalog files from TTManager 2.x will not work with version 3.x. - A possible problem is that TTManager's interface may not adapt properly to a new language. The layout routines assume the Load button, Load Mode and Load Type cycle gadgets form the widest part of the interface. If this isn't the case in your language, please let me know and I'll fix it (TTManager, that is :-) ). @endnode @node TODO "TTManager: The Shape Of Things To Come" @{i}Today the ToolTypes; tomorrow the world!@{ui} @{u}@{b}Future Plans:@{ub}@{uu} Some possibilities for the future are: - Bug fixes; replacing them with newer, more interesting bugs. (Priority.) - Fiddle with the code to make it more efficient and to introduce new bugs to fix. :-) - An "Image" page? Very likely. - More information in the About requester. - More error checking/requesters. - Expand and improve the ARexx interface - More commands and more options. - Search requester. - Integer requester. - Multiselection in the listview. If there's a feature you'd like to see, or think should be a priority, let @{"me" link SMEGHEAD} know. @endnode @node WASDONE "TTManager: Binary Archaeology" @{u}@{b}History:@{ub}@{uu} A long time ago, on a hard drive far, far away... @{b}3.5c@{ub} - Forgot to remove a WriteF() - Bug fix: The default ASCII and ARexx dirs weren't initialized, which could result in an Enforcer hit. - Reported by Nils Goers. @{b}3.5b@{ub} - Bug fix: The auto-executing ARexx scripts feature was broken. - Bug fix: The DEFAULTASCIIDIR and DEFAULTAREXXDIR keywords were ignorred in v3.5a. @{b}3.5a@{ub} - File requester now remembers last-used path, last-used ASCII path, and last-used ARexx path. - Suggested by Oliver Fabre. - New ARexx command: RestoreDefaultDir. - Fixed two Enforcer hits. - Reported by Nils Goers and Kevin Glynn. - Temporary fix to the icon image display: the Backfill highlight mode will be ignorred if TTM's window's bitmap isn't in Chip RAM. I hope to come up with something better soon... Flood(), Picasso96, and chunky screens = lock up. :-( - Reported by Nils Goers, who discovered the P96 connection. - Bug fix: The clear clipboard routine now puts an empty FORM 0000 into the clipboard instead of an empty FTXT, which would cause Multiview to crash when viewing the clipboard. - Reported by Kevin Glynn. - Bug fix: Enforcer hit when file requester opened, used, opened, canceled, opened. @{b}3.5@{ub} - TTManager can replace Workbench's Information requester. - New startup and menu option: PATCHWBINFO, and "Settings->Patch WBInfo?". - Thanks to Gerald Schnabel for the patching code! - Suggested by nearly everyone. - The screen's titlebar text changes depending on where the mouse pointer is. "Mouse-over" zones: Icon image display, Undo/Redo gadgets, toolbar on Tooltype page. - Suggested by Fredrik Ismyren. - Icon image display highlighting works more like Workbench. - Suggested by Gerald Schnabel. - 22 new ARexx commands. - New startup options: DEFAULTDIR, DEFAULTASCIIDIR, DEFAULTAREXXDIR, - Suggested by Radim Demel. NOAPPMENU. - Suggested by Gerald Schnabel. - Internal changes to screen, window, list, and clipboard handling, library opening, localization, plus misc. - Bug fix: Stupid mistake in the close message port routine. - Bug fix: MungWall hits when pasting if the clipboard text didn't end with a linefeed. - Bug fix: Non-existant ARexx commands would cause Enforcer hits; the match - Bug fix: Signal handling was incorrect. - Bug fix: TTM won't quit until any script it's launched has finished. loop looked one step beyond the end of the command list. - Bug fix: Renaming routine ignorred cases where onle the filename's case was changed (ex: "t:bla" to "T:Bla"). There have been many changes, bugs, and beta versions between versions 3.3 and 3.4. @{b}Special thanks@{ub} (alphabetically) to Frederic Delacroix, Radim Demel, Greg Donner, Nils Goers, Fredrik Ismyren, Lukasz Jodlowski, Dominique Neveu, Gerald Schnabel, and Michael Taylor for suggestions, bug reports, and beta testing above and beyond the call of duty. @{b}3.4@{ub} - The listview string gadget is activated when a tooltype is selected. - Cursor At Data menu and startup option. - Suggested by Frederic Delacroix. - Boolean Toggle tooltype-editing feature. - Suggested by Frederic Delacroix. - The clipboard cut, copy, and paste routines first store the string gadget's contents. - Internal improvements to many routines. - Information->Copy From... and the AppWindow allow for copying the attributes of other files (stack, default tool, comment, and protection bits). - Rewrote the ARexx interface - 32 commands so far... - Replaced the DEFAULTTOOLMENU startup option with a more flexible menu- definition scheme. - ARexx menu, supporting user-defined items and automatic script execution. - Removed the old 25-window limit! - TTManager can open it's windows on other public screens. - Suggested by many. - LANGUAGE startup option. - Changed the "big font" error message to something a bit more sensible. - Sugested by Fredrik Ismyren. - Requester when a menu definition file isn't found/couldn't be loaded. - Suggested by Gerald Schnabel. - The icon display can now be toggled between the normal and selected images. - Suggested by many. - The icon image display now immediatly responds to mouse-clicks (just like Workbench.) - Suggested by Gerald Schnabel. - If the icon doesn't have an alternate image, it will be complemented. - User-defined menu items may have a keyboard shortcut. - Bug fix: A couple functions didn't check if there was a tooltype currently selected. - Bug fix: Undo-flushing didn't trigger an interface update. - Bug fix: The PAGE startup option was broken. - Bug fix: The Volume Information page was the default page. - Bug fix: Removed a duplicate line of code. - Bug fix: NOWARNINGS and CREATEICONS startup options didn't work when TTM was started from an icon. - Reported by Fredrik Ismyren. - Bug fix: The APPICON option didn't work when an ".info" extension was supplied. - Reported by Fredrik Ismyren. - Bug fix: Loading a new icon to an old window would cause the filename to become corrupted. - Reported by Greg Donner. - Bug fix: The "Icon modified" requester would pop up twice. - Bug fix: Renaming would fail if an icon didn't have an associated file. - Bug fix: When renaming the original icon was never deleted. - Bug fix: The "Rename error" requester wasn't given any args. - Bug fix: The file requester routine could generate a couple Enforcer hits. - Reported by Nils Goers, Greg Donner. - Bug fix: The file requester glyph was 1 pixel too wide & tall. - Reported by Gerald Schnabel. - Bug fix: The icon image display routine didn't check if the icon image was in Chip RAM. It does now, & will copy the data if necessary. - Reported by Nils Goers. - Bug fix: TTM could be fooled by a single-image icon with non-null data in the alternate-image field. - Reported by Nils Goers. @{b}3.3@{ub} - Added the @{b}CASCADEX@{ub} and @{b}CASCADEY@{ub} start-up options. - Added support for MultiUser File System's protection bits. - Suggested by Lukasz Jodlowski. - Added the @{b}Snapshot@{ub} menu item. - Suggested by Michael Taylor, and Greg Donner. - Bug fix: The protection-bit masking in the save-icon routine didn't allow for the MuFS bits (and wasn't quite right to begin with, anyway). - Reported by Lukasz Jodlowski. - Assigns won't be expanded if only one file is selected from a file requester. - Suggested by Michael Taylor. - Added the @{b}Default Tool@{ub} menu. - Suggested by Michael Taylor. - Bug fix: The calculations for a window's minimum width weren't quite right. - Some internal improvements and minor bug fixes. - Bug fix: A "Please insert volume Last Modified" requster would pop up when loading an icon from a file requester if the path was blank. - Reported by Lukasz Jodlowski. - Bug fix: The snapshot feature didn't update the default X, Y, width, and height variables - TTM had to be quit and restarted to use these values. - Reported by Gerald Schnabel @{b}3.2@{ub} - Small improvements to the update-interface routine. - Added the @{b}Only Icons In File Requester@{ub} option. - Suggested by G.A. Green - New in the @{b}About@{ub} requester: - The icon's path is no longer displayed. - "exists" or "default" displayed after the icon's name, depending on whether an icon actually exists or if a default icon was loaded. - Suggested by G.A. Green - The number of colors an icon's image uses is reported. - Bug fix: An "improvement" in v3.1 resulted in only project icons being created for iconless files. Oops. :-) - Added a file requester button for the @{b}Default Tool@{ub} gadget. - Suggested by Michael Taylor. - The icon's image is now displayed. - Suggested by Michael Taylor. - Relocated the @{b}Undo@{ub} & @{b}Redo@{ub} gadgets; they're always available now. - Tooltypes are now saved for disk, drawer, & garbage icons. - Reported by Joern Krueger. - New start-up options: @{b}ICONDISPLAYWIDTH@{ub} and @{b}ICONDISPLAYHEIGHT@{ub}. - Bug fix: The keyboard shortcut for the Page cycle gadget was broken. - Reported by Gerald Schnabel. @{b}3.1@{ub} - Improved icon saving and renaming. - The strings for the @{b}Undo@{ub} and @{b}Redo@{ub} gadgets are comparred to find the longest one. - Bug fix: When the undo list was full old items were removed, but not killed. - Bug Fix: The ARexx command "New" didn't strip the ".info" extension. - Reported by Michael Taylor. - The @{b}About@{ub} requester can now credit the Locale translator (new entry in the v3.1 .cd/.ct files - still 100% compatible). - Suggested by Alexandros Vellis. - Shed some excess bytes here and there. @{b}3.0d@{ub} - The @{b}Add@{ub}, @{b}Toggle@{ub}, and Duplicate buttons will first check the string gadget's contents (handy if, like me, you occasionally forget to hit <RETURN>). - The filename gadget no longer does a case-insensitive comparison, so "bla" can be renamed to "Bla". - Bug fix: A call to FreeMenus() was missing. @{b}3.0c@{ub} - Bug fix: At 100%, the percent-full guage was 1 pixel too wide. - The filename gadget wasn't hooked into the undo system. Is now. @{b}3.0b:@{ub} - Bug fix: The ARexx command "New" didn't work properly when no filename was given. - Bug fix: Editing a blank line caused an Enforcer hit. - Bug fix: The @{b}Cut@{ub} & @{b}Copy to Clipboard@{ub} edit buttons didn't check if there was a tooltype selected. - Bug fix: The icon wouldn't be deleted during an across-volume rename. - Bug fix: If a rename was cancelled due to a fle with the same name already existing the icon would stil be saved to the new destination. @{b}3.0a (limited beta release):@{ub} - Minor bug fixes. - Added an ARexx port, named "TTMANAGER". - Added an ARexx command: New [<filename>]. This allows TTM windows to be opened from the CLI or directory utilities. - Suggested by Rob Sullivan, Richard Knight, and James Kückmann. @{b}3.0 (limited beta release):@{ub} - Replaced the Edit Mode cycle gadget with a button bar. - Thanks to Michael Taylor for the suggestion this evolved from. - Two new edit buttons: @{b}Cut to Clipboard@{ub} and @{b}Clear Clipboard@{ub}. - Removed the @{b}Hidden@{ub} protection-bit checkbox gadget. - Removed the @{b}EDITMODE@{ub} tooltype. - New default AppIcon image. - Added the @{b}Volume Information@{ub} page. - New catalog - 2.x catalogs no longer valid (sorry). - Added @{b}Volume Page On Disk@{ub} option. - Added @{b}Move If New Volume@{ub} option. - Reordered the pages to: @{b}Volume Information@{ub}, @{b}Information@{ub}, @{b}Tooltypes@{ub}. @{b}2.4d:@{ub} - Bug fix: Renaming could GURU if a file by the same name existed and had to be overwritten. @{b}2.4c:@{ub} - Renaming now works like Workbench: same volume = rename, different volume = copy. - Improved the calculation for the longest right-side protection string. - Fixed a deadlock situation which would occur if an error happened before a window's message port was assigned. @{b}2.4b:@{ub} - When renaming, the old icon would still exist if it didn't have a file. - Small improvements to string disposal. - Fixed the last of the bugs causing TTManager to be less than stable (if the replace string routine needed to create a new string, no one recieved the new string's address). - Special thanks to Michael Taylor for bug reports and beta testing above and beyond the call of duty. :-) @{b}2.4a:@{ub} - If no file exixts, the protection bits are given default values of Readable, Writeable, Executable, and Deletable. - Bug fix: A coule strings were never freed.. - Bug fix: String-trimming routine needed a "greater-than-zero" test, as opposed to just "not zero". - Bug fix: "Maximum windows open" warning would be reported as "font too big". @{b}2.4:@{ub} - Improved the Commodity interface. - Starting a second TTManager pops up the @{b}About@{ub} requester. - TTManager responds to Show/Hide Interface commands. - Found and removed a couple pieces of useless code. - Found and fixed a bug which could cause occasional crashes or lock-ups. - Reported by Jeff Dettman. - Canceling a file requester no longer quits TTManager (an undocumented "feature" in v2.3 :-) ). - Reported by Gerald Schnabel. - "Hidden" no longer has a colon. :-) - Reported by Gerald Schnabel. - Sort was broken, and would cause GURUs. - Reported by Gerald Schnabel. - Changes to the ttmanager.cd file (changes are listed at the top of the file). - The layout routines no longer assume "Archived" to be a longer word than "Script", "Pure", or "Hidden". - The interface wasn't updated after icons were dropped onto the AppWindow. - Bug fix: Bad CLI args would cause a crash. - Reported by Rob Sullivan. - Bug fix: Attempting to load a file which didn't exist would cause a crash. - The "Last Modified:" date might have extra spaces if english is not your native language (OS's fault! :-) ). - Reported by Gerald Schnabel. @{b}2.3:@{ub} - Optimized localization routines, and a few others. - New error messages; better error handling in window-opening routines. - Fixed several goofs/oversights I made in v2.2 (it was a beta anyway). :-) - Warning requester when tooltype list exceeds 65,535 items (as if :-) ). @{b}2.2:@{ub} - Localized. @{b}2.1:@{ub} - Many internal changes: - List, string, resource, file requester, and file name handling routines and GUI/menu updating routines replaced with newer, improved code. - Fixed (most) known bugs. So how many new ones did I introduce?! :-) @{b}2.0a:@{ub} - The listview string gadget would initially be empty if @{b}EDITMODE@{ub} was set to "EDIT". A crash would result if this non-existant string was edited. - Keyboard shortcuts for page-specific gadgets only function when their page is active (except for the @{b}Undo@{ub} and @{b}Redo@{ub} buttons). - The @{b}Stack@{ub}, @{b}Default Tool@{ub}, and @{b}Comment@{ub} gadgets now have keyboard shortcuts. - Updated the docs. @{b}2.0:@{ub} - Many big changes: - Added the @{b}Icon Type@{ub} cycle gadget. - Added the @{b}Page@{ub} cycle gadget... - ...And the @{b}Information@{ub} page, which allows manipulation of a file's: - Stack, - Default Tool, - Comment, and - Protection bits. - The @{b}File name@{ub} gadget now displays the path and file name. The window's title bar just displays "TTManager v2.0". - Removed the @{b}Original Name@{ub} menu item. The @{b}File name@{ub} gadget is now serviced by the undo routines. - The undo routines now handles the @{b}File name@{ub} gadget and all new gadgets and menus. - The @{b}File name@{ub} gadget can now move files across volumes, and relabel disks. - Added the @{b}Information@{ub} menu. - The keywords for @{b}EDITMODE@{ub}, @{b}LOADMODE@{ub}, and @{b}LOADTYPE@{ub} no longer have to be entered in all caps. @{b}1.3a:@{ub} - Fixed the bug which crashed 68000/68010 systems (had GTLV_LABELS set to -1 when creating the gadget (dumb, dumb, dumb, dumb, dumb, dumb, dumb)). - Fixed the minimum window height and listview height calculations. Again. - A little more code cleaning, and small fixes. @{b}1.3:@{ub} - @{b}Clear Clip@{ub} menu option. - @{b}Add to Clip@{ub} edit mode. - Some code cleaning; saved 624 bytes. @{b}1.2a:@{ub} - Changed the default hotkey string to a 2.04 compatible format. @{b}1.2:@{ub} - TTManager is now a Commodity. - Added an AppMenu item (why didn't I think of this before?). - Quits when a Break-C is recieved. - @{b}NOAPPICON@{ub}, @{b}CX_PRIORITY@{ub}, and @{b}HOTKEY@{ub} keywords. @{b}1.1a:@{ub} (unreleased) - No longer keeps a permanent lock on Workbench; only when a window is open. @{b}1.1:@{ub} - @{b}EDITMODE@{ub}, @{b}LOADMODE@{ub}, and @{b}LOADTYPE@{ub} keywords. - Items pasted from the clipboard are now inserted after the currently selected tooltype. @{b}1.0:@{ub} - Bug fixes, and general fiddling around with things. @{b}0.9b:@{ub} - @{b}MAXUNDO@{ub} keyword; undos can now be limited or disabled. - Some minor bug fixes. @{b}0.9a:@{ub} - Okay, the "Duplicate" edit mode can @{u}really@{uu} be undone now. - Also able to be undone/redone: - The delete all/current to top/end menu options. - Clipboard cutting and pasting. - All the load-modes (replace all, append all, etc. (from either icons or ASCII)). @{b}0.9:@{ub} - Undo & Redo. So far, the following can be undone/redone: - All the edit modes, add, edit, toggle, delete, move, & duplicate. - Reverse tooltype list. - Enable/disable/toggle-all tooltypes. - Flush undo buffer (current & global). - The "About" requester now displays some info. about the current window. - Keyboard shortcuts for more of the menus & the GUI. @{b}0.8:@{ub} - Improved the quit-program process (as if you would ever want to quit TTManager (well, maybe to start up a newer version) :-) ). - Huge internal changes; optimised and replaced about half the source with OO code. @{b}0.7b:@{ub} - Fixed various Enforcer hits and bugs. @{b}0.7a:@{ub} - Added a version string. - Bug Fix: Didn't check if tooltype pointer was NIL. @{b}0.7:@{ub} - Clipboard support. @{b}0.6:@{ub} - Sort. - The tooltype load modes "Only New" & "Only Existing". - Fixed the window minimum-height calculation. @endnode @node GRACIAS "TTManager: Credit Where Credit Is Due Dept." @{b}Many thanks to the folowing:@{ub} - God - Life, the universe, and everything. - My parents. - Wouter van Oortmerssen - Amiga E, the best programming language I've ever used. - Jason Hulance - The rexxvar.m E module and the ReadArgs() article in CU Amiga. Both had a deep impact on TTM's ARexx interface. - Matt Dillon/Aaron Digulla - DME/XDME. - Heinz Wrobel - HWGRCS. - Peter Bornhall - Iconite, an excellent icon package. The AmigaGuide and drawer icon were created from the Iconite clipart, which I mangled a bit to get to four colors. - My cat - Various programming suggestions and solutions. "Sleep on it," being one of many valuable lessons. - Greg Donner - Beta testing. <gregdonner@earthlink.net> - Gerald Schnabel - Beta testing, German translation. <Gerri@studbox.uni-stuttgart.de> - Michael "Max Headroom" Taylor - Beta testing. <rushmax@calweb.com> - Frederic Delacroix - French translation, - Beta testing. <fdelacroix@nordnet.fr> - Lukasz Jodlowski - Polish translation, - Beta testing. <ljodlo@ucku4.uck.pk.edu.pl> - Alexandros Vellis - Greek translation. <avellis@pemail.net> - Radim Demel - Czech translation, - Beta testing. <demel.radim@opf.slu.cz> - Fredrik Ismyren - Swedish translation, - Beta testing. <myrn@tjohoo.se> - Nils Goers - Beta testing. <nils@goers.line.org> - The Ramones, U2, Blondie, Deborah Harry, The Heads, Lord of the Dance soundtrack - Music to program by. - @{u}You@{uu} - For using TTManager! @endnode @node SMEGHEAD "TTManager: Me" @{u}@{b}Contacting Me:@{ub}@{uu} Comments, questions, bug reports, or whatever can be directed to me at the addresses below (e-mail is preferred). Check out the Web page from time to time; the latest versions of whatever I happen to be working on will always be available there first, and also new catalogs and scripts. @{b}E-mail:@{ub} jtierney@cyberlink.com @{b}Web Pages:@{ub} Main: http://www.cyberlink.com/jtierney TTManager: http://www.cyberlink.com/jtierney/ttm.html @{b}Snail:@{ub} Jody Tierney 29118 Lark Street Elkhart, IN 46514-9579 USA @endnode