@database "TTManager" @author "Jody Tierney" @(c) "Copyright © 1996-97 Jody Tierney" @$VER: TTManager.guide 2.2 (9.30.97) @node MAIN "TTManger Documentation" TTManager v2.3 ©1996-97 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 GUI " link THEGUI} @{"The Menus " link MENUS} @{"Keyboard Shortcuts" link KEYS} @{"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 (both of them :-) ) 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, file comment, icon type, and more. ...And all this in an easy to use resizable, font-sensitive GadTools GUI. @{u}@{b}Features:@{ub}@{uu} * Font-sensitive, resizable, style guide compliant GUI. * AppIcon and AppWindows for drag & drop convenience. * Adds itself to Workbench's Tools menu (AppMenu item). * It's a Commodity. * It's localized. * Seven ways to manipulate individual tooltypes: - Add. - Edit. - Toggle. - Delete. - Move. - Duplicate. - Add to Clip. * 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 trash). - Stack. - Default tool. - Comment. - Protection bits. * Rename an icon and its associated file, drawer, or volume. * It's fully functional and free. @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-97, @{"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 stabe 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}! :-) ). @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 @{"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. @{"PAGE " link OPT_PAGE} P Keyword. TOOLTYPES @{"EDITMODE " link OPT_EM} EM Keyword. ADD @{"LOADMODE " link OPT_LM} LM Keyword. REPLACE @{"LOADTYPE " link OPT_LT} LT keyword. ICON @{"MAXUNDO " link OPT_UNDO} MU 0 - 65530 10 @{"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. @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}X@{ub}, @{b}WIDTH@{ub} <0 - 65535> @{b}Y@{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_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_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 INFORMATION or TOOLTYPES. @{b}Default:@{ub} TOOLTYPES @endnode @node OPT_EM "TTManager: Edit Mode Keyword" @toc STARTMEUP @{u}@{b}Edit Mode Keyword:@{ub}@{uu} @{b}EM@{ub}, @{b}EDITMODE@{ub} Which @{"edit mode" link GUI_EDIT} is initially active when a TTManager window is opened. is one of the following: ADD, EDIT, TOGGLE, DELETE, MOVE, DUPLICATE, or ADDTOCLIP. @{b}Default:@{ub} ADD @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 - 65530> 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_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 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}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 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}ToolType Page:@{ub} @{bg fill}|o| TTManager v2.3 |' |[]|@{bg background} @{bg fill} @{bg background}File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{"@| Tool " link GUI_ITYPE}@{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}|Edit Mode: @{"@| Edit " link GUI_EDIT} @{"Undo" link GUI_UNDO}@{"Redo" link GUI_UNDO}|@{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 v2.0 |' |[]|@{bg background} @{bg fill} @{bg background}File: @{"System3.0:WBStartup/TTManager " link GUI_FNAME}@{"@| Tool " link GUI_ITYPE}@{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} Readable @{" " link GUI_PB} Script |@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"./" link GUI_PB} Writable @{" " link GUI_PB} Pure |@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"./" link GUI_PB} Executable @{"./" link GUI_PB} Archived|@{bg fill} @{bg background} @{bg fill} @{bg background}|@{"./" link GUI_PB} Deletable @{" " link GUI_PB} Hidden |@{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} @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. The renaming takes effect when the icon is saved. @{b}Keyboard Shortcut:@{ub} I (activates the string gadget.) @{b}Notes:@{ub} * This not only renames the icon, but the file the icon is associated with, as well. 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 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_PAGE "TTManager Window - Global Gadgets: Page Cycle Gadget" @toc THEGUI @{u}@{b}Page Cycle Gadget:@{ub}@{uu} This gadget switches between the ToolType page, where tooltypes may be manipulated, and the File Information page, where things such as the stack and protection bits may be set. 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. @{b}Keyboard Shortcut:@{ub} p (cycles forwards through the pages.) P (cycles backwards through the pages.) @endnode @node GUI_LOAD "TTManager Window - ToolType Page Gadgets: ToolType Loading Gadgets" @toc THEGUI @{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) is 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 Gadgets: ToolType Display & Editing" @toc THEGUI @{u}@{b}The ListView:@{ub}@{uu} The icon's tooltypes are displayed here. What happens when an item is clicked on depends on the setting of the @{b}Edit Mode@{ub} cycle gadget. @{u}@{b}The ListView String Gadget:@{ub}@{uu} Nothing out of the ordinary here. It's used to add or edit the items in the listview, depending on the @{b}Edit Mode@{ub} cycle gadget's setting. It's disabled if the edit mode isn't @{b}Add@{ub} or @{b}Edit@{ub}. @{u}@{b}Edit Mode Cycle Gadget:@{ub}@{uu} Add - Inserts the new tooltype after the currently selected one. Edit - Lets you change the currently selected tooltype. Toggle - Enables or disables (surrounds with parentheses "()") the selected tooltype. Delete - Any tooltype clicked on is removed from the list. Move - Click on a tooltype, and then click where you'd like to move it to (within reason (and the listview) :-) ). The tooltype will be inserted @{u}after@{uu} the one you clicked on. Duplicate - 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 ;-) ). Add to Clip - Clicking on a tooltype appends it to the text in the current clipboard unit. Use the @{"Clear Clip" link MENU_CB} menu item to clear the contents of the current clipboard unit. @{b}Keyboard Shortcut:@{ub} e (cycles forwards through the possible types.) E (cycles backwards through the possible types.) (Cycling is a non-polluting mode of transport.) @{b}Note:@{ub} The inital setting of the @{b}edit mode@{ub} gadget may be set via the @{"EDITMODE" link OPT_EM} keyword. @endnode @node GUI_UNDO "TTManager Window - ToolType Page 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_SAVE "TTManager Window - Global Gadgets: To Save, Or Not To Save..." @toc THEGUI @next 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. @{b}Keyboard Shortcut:@{ub} A (opens a file requester.) @{b}Save As Notes:@{ub} * The original ".info" file (and any file it may belong to) are unchanged. * Unlike the @{"File Name" link GUI_FNAME} string gadget, only the ".info" file will be saved. * Also, unlike the @{"File Name" link GUI_FNAME} gadget, the destination @{u}may@{uu} be a different volume. @{u}@{b}Cancel Button:@{ub}@{uu} Closes the window without saving anything. @{b}Keyboard Shortcut:@{ub} C (closes the window.) @endnode @node GUI_STACK "TTManager Window - Information Page Gadgets: Stack Gadget" @{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 Gadgets: Default Tool Gadget" @{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 Gadgets: Comment Gadget" @{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 Gadgets: Protection Bit Gadgets" @{u}@{b}Protection Bit Checkbox Gadgets:@{ub}@{uu} These checkbox gadgets are used to set the various AmigaDOS 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. Hidden - Unused by AmigaDOS. It balances out the GUI nicely, though. :-) @{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 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} @{"./ Close After Save?" link MENU_CAS} @{"Open... [A]O" link MENU_OPEN} @{"Copy [A]C" link MENU_CB} @{"Protection »" link MENU_PB} @{"Disable All [A]-" link MENU_TTON} @{"./ Warnings? " link MENU_WARN} ~~~~~~~~~~~~~~~~ @{"Paste [A]V" link MENU_CB} @{"Toggle All [A]\ " link MENU_TTON} @{"./ Create Icons? " link MENU_ICONS} @{"Save [A]S" link MENU_SAVE} @{"Clear Clip [A]0" link MENU_CB} ~~~~~~~~~~~~~~~~~~~~~~ @{"Save As... [A]A" link MENU_SAVE} @{"Clip Unit »" link MENU_CB} @{"Delete »" link MENU_DEL} ~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~ @{"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} ~~~~~~~~~~~~~~~~ @{"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. @{b}Menu Shortcut:@{ub} A @{b}Save As Notes:@{ub} * The original ".info" file (and any file it may belong to) are unchanged. * Unlike the @{"File Name" link GUI_FNAME} string gadget, only the ".info" file will be saved. * Also, unlike the @{"File Name" link GUI_FNAME} gadget, the destination @{u}may@{uu} be a different volume. @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. * My e-mail address. * The path and name of the icon being edited. * 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} ›A @{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_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} @{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 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. @{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 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_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 KEYS "TTManager: Keyboard Shortcuts" @prev MENUS @{u}@{b}Gadget Keys - Global:@{ub}@{uu} File string gadget i 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 Edit Mode cycle gadget e, E 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 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 (okay, three) 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". The renaming process consists of first calling the AmigaDOS Copy command, and then Delete if the copy was successful (this will probably be improved later). - The Information page doesn't display any relevant/useful information for disk icons. ...Yet. @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: ...Which brings me to my next point. :-) If TTManager is to be multilingual, I'll need your help. 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. 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, and that "Archived" is a longer word than "Script", "Pure", or "Hidden". 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. :-) - Interesting information if the icon belongs to a disk. - An "Image" page? We'll see... - More information in the About requester. - More error checking/requesters. - ARexx interface. - Search requester. - Multiselection in the listview. - New default AppIcon image. - 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}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. - 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