@database "TTManager" @author "Jody Tierney" @(c) "Copyright © 1996-98 Jody Tierney" @$VER: TTManager.guide 3.4 (21.4.98) @node MAIN "TTManger Documentation" TTManager v3.3 ©1996-98 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} @{"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. With 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} * Font-sensitive, resizable, style guide compliant GadTools GUI. * 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: - French, - German, - Greek, - Polish. * Button-bar with the following tooltype-editing features: - Add. - Toggle. - Delete. - Move. - Duplicate. - 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. * 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. * 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). @{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-98, @{"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 Vellis Alexandros. @{fg shine}polski@{fg text}/ ttmanager.catalog - Polish language catalog for TTManager. Created by Lukasz Jodlowski. 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}/ TTMLoadIcon.rexx - Open TTManager windows from the CLI or from directory utilities. 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.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 @{"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. @{"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. @{"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 @{"DEFAULTTOOLMENU " link OPT_DTM} DTM Text. None. @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_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 Keyword" @toc STARTMEUP @{u}@{b}AppIcon Keyword:@{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_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_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 @next 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_DTM "TTManager: Default Tool Menu Entry Keyword" @toc STARTMEUP @next STARTMEUP @{u}@{b}Default Tool Menu Entry Keyword:@{ub}@{uu} @{b}DTM@{ub}, @{b}DEFAULTTOOLMENU@{ub} <@{"text" link IQUAL}> The DEFAULTTOOLMENU keyword adds items to TTManager's @{"Default Tool" link MENU_DTM} menu. When one of these user-defined menu items is selected, the icon's default tool will be replaced with the menu's text. Up to 61 items may be added to the Default Tool menu. The method for adding the items depends on whether TTManager is started from Workbench or a CLI. When starting from an icon (Workbench), use multiple DEFAULTTOOLMENU tooltypes to set up the menu. For example: DEFAULTTOOLMENU=C:IconX DEFAULTTOOLMENU=C:XIcon DEFAULTTOOLMENU=SYS:Utilities/Multiview DEFAULTTOOLMENU=SYS:Utilities/xMore DEFAULTTOOLMENU=SYS:RexxC/RX (...and so on.) When starting TTManager fom a CLI, just issue the DEFAULTTOOLMENU keyword and the items you want in the menu, seperated by a space. Example: DTM C:IconX C:XIcon SYS:Utilities/xMore (...and so on.) @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}TTManager Menu Item and 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}TTManager Menu Item and No Icons Selected:@{ub} TTManager will open a @{"window" link THEGUI} for each selected icon. @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. @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"} No action is performed (This will change in v3.4). @{"b"}Volume Information Page:@{"ub"} No action is performed. @endnode @node THEGUI "TTManager: The GUI" @toc MAIN @next MENUS @{u}@{b}TTManager's Window:@{ub}@{uu} TTManager may have 25 windows open at once. They resemble the following: @{b}Volume Information Page:@{ub} @{bg fill}|o| TTManager v3.3 |' |[]|@{bg background} @{bg fill} @{bg background}+------+ File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{bg fill} @{bg background} @{bg fill} @{bg background}|| 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.3 |' |[]|@{bg background} @{bg fill} @{bg background}+------+ File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{bg fill} @{bg background} @{bg fill} @{bg background}|| 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.3 |' |[]|@{bg background} @{bg fill} @{bg background}+------+ File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{bg fill} @{bg background} @{bg fill} @{bg background}|| 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}@{"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} @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: :Disk. @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_NEW} and @{"Open" link MENU_OPEN} menu options. * Closing the window. * Quitting TTManager. @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 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}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 Gadget" @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.) @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. @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}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. @endnode @node MENUS "TTManager Menus" @toc MAIN @next KEYS @prev THEGUI @{u}@{b}Menus:@{ub}@{uu} @{u}@{bg shine}Project Edit Information ToolTypes Settings @{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} @{"./ Only Icons In File Req?" link MENU_OI} @{"Open... [A]O" link MENU_OPEN} @{"Copy [A]C" link MENU_CB} @{"Default Tool »" link MENU_DTM} @{"Disable All [A]-" link MENU_TTON} @{"./ Volume Page On Disk? " link MENU_VPOD} ~~~~~~~~~~~~~~~~ @{"Paste [A]V" link MENU_CB} @{"Protection »" link MENU_PB} @{"Toggle All [A]\ " link MENU_TTON} @{" Move If New Volume? " link MENU_MNV} @{"Save [A]S" link MENU_SAVE} @{"Clear Clip [A]0" link MENU_CB} ~~~~~~~~~~~~~~~~~~~~~~ @{"./ Close After Save? " link MENU_CAS} @{"Save As... [A]A" link MENU_SAVE} @{"Clip Unit »" link MENU_CB} @{"Delete »" link MENU_DEL} @{"./ Warnings? " link MENU_WARN} ~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~ @{" Create Icons? " link MENU_ICONS} @{"Close [A]1" link MENU_CLOSE} @{"Undo [A]U" link MENU_UNDO} @{"Load From Icon »" link MENU_LDTT} ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @{"Close All [A]!" link MENU_CLOSE} @{"Redo [A]Z" link MENU_UNDO} @{"Load From ASCII »" link MENU_LDTT} @{"Snapshot " link MENU_SNAP} ~~~~~~~~~~~~~~~~ @{"Flush »" link MENU_UNDO} ~~~~~~~~~~~~~~~~~~~~~~ @{"About... [A]?" link MENU_ABOUT} @{"Save As ASCII... [A]D" link MENU_SASCII} ~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~ @{"Quit [A]Q" link MENU_QUIT} @{"Sort [A]T" link MENU_SORT} @{"Reverse [A]R" link MENU_REV} "[A]" represents the right Amiga key. @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} 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} 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} 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} 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 @{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} 1 @{u}@{b}Close All@{ub}@{uu} Closes all open (TTManager) windows. @{b}Menu Shortcut:@{ub} ! @{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). * 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} ? @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} 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} X @{u}@{b}Copy@{ub}@{uu} Copies the tooltype list to the clipboard. @{b}Menu Shortcut:@{ub} 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} 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} 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} U @{u}@{b}Redo@{ub}@{uu} Redo undoes an undo. :-) @{b}Menu Shortcut:@{ub} 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_NEW} 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} ' @{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} " @endnode @node MENU_ITYPE "TTManager Menus: Information - Icon Type" @{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" @{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} @{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. - These menu items (up to 61) are set using the @{"DEFAULTTOOLMENU" link OPT_DTM} keyword. 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" @{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_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} + @{u}@{b}Disable All@{ub}@{uu} Brackets all tooltypes with parentheses ("()"), thus disabling them. @{b}Menu Shortcut:@{ub} - @{u}@{b}Toggle All@{ub}@{uu} Any disabled tooltypes are enabled, and vice-versa. @{b}Menu Shortcut:@{ub} \ @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} . @{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} < @{u}@{b}Current To End@{ub}@{uu} Deletes all tooltypes from the currently selected one onwards. @{b}Menu Shortcut:@{ub} > @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} 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} 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} R @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} : @{b}Only Icons In File Requester@{ub} 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} : @{b}Volume Page On Disk@{ub} 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} : @{b}Move If New Volume@{ub} 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_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} : @{b}Close After Save@{ub} 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} : @{b}Warnings@{ub} 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 @next MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}./ Create Icons? @{bg background} @{b}Create Icons@{ub} 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 @next MENUS @{u}@{b}Menus:@{ub}@{uu} @{bg shine}@{u}Settings @{uu}@{bg background} : @{bg shine}Snapshot @{bg background} @{b}Snapshot@{ub} 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 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 @{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" @{u}@{b}ARexx:@{ub}@{uu} TTManager's port name is "TTMANAGER". Commands: @{"NEW " link RX_NEW} @endnode @node RX_NEW "TTManager Arexx: NEW" @{u}@{b}NEW@{ub}@{uu} NEW [] Opens a new TTManager window, loading . If no file name is given, a file requester will be opened. @endnode @node DAMMIT "TTManager: @#%*!!!" @{u}@{b}Known Bugs:@{ub}@{uu} If you come across any bugs, please report them to @{"me" link SMEGHEAD}. @endnode @node NOTES "TTManager: Be Advised..." @{u}@{b}Note:@{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. @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: - French - Created by Frederic Delacroix. - German - Created by Gerald Schnabel. - Greek - Created by Vellis Alexandros. - Polish - Created by Lukasz Jodlowski. 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? We'll see... - More information in the About requester. - More error checking/requesters. - Expand and improve the ARexx interface - More commands and more options. - Search requester. - Multiselection in the listview. - Patch into and replace Workbench's Information requester. - Ability to open windows on public screens. 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.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 Vellis Alexandros. - 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 ). - 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 []. 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. - 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. - Gerald Schnabel - Beta testing, German translation. - Michael "Max Headroom" Taylor - Beta testing. - Frederic Delacroix - French translation. - Lukasz Jodlowski - Polish translation, - Beta testing. - Vellis Alexandros - Greek translation. - 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. Also, new catalogs/translations will appear there. @{b}Snail:@{ub} Jody Tierney 29118 Lark Street Elkhart, IN 46514-9579 USA @{b}E-mail:@{ub} jtierney@cyberlink-inc.com @{b}WWW:@{ub} http://www.cyberlink-inc.com/jtierney @endnode