tooltype

Tooltype 1.4
Manage tooltypes via commandline.

Copyright © 2006-2008 Christian Rosentreter
All rights reserved.



Introduction
------------

Tooltype is a commandline tool for manipulation of the tooltype
array wich is contained in icon files (#?.info).

Actually I don't know what this is good for really, but a few
years back a friendly fellow (hello analogkid!) on #amiganews.de 
(irc.freenode.net) asked me for such tool which works on MorphOS 
and since there was no proper one and I was bored at the time 
this little tool was created.

Tooltype can be made resident (note: the OS4 port can't be made
resident yet).


Template
--------

FILE/A,MODE,TOOLTYPE,VALUE,VERBOSE/S,NEWICONFILTER/S


FILE     - Name of the icon file without ".info".

MODE     - Operation to be performed on the tooltypes of the icon file,
           must be one of the following:

           ALL=LIST,VIEW,ADD,DEL=DELETE,UPDATE=EDIT

TOOLTYPE - Name of the tooltype. Required for a few modes.

VALUE    - An optional value for adding or updating tooltypes.

VERBOSE  - Print out detailed (success) information after each 
           operation.

NONEWICONFILTER 
         - Newicons store their graphic data traditonally at the
           end of the tooltypes array. Tooltype filters this special
           tooltypes per default. If you actually want to manipulate
           this Newicon data then use this switch. It will influence 
           all modes accordingly.


Usage Examples
--------------

Tooltype <FILE>

    Lists all tooltypes contained in foobar.info. Please note that
    there is no need to add ".info" to the file parameter.

    e.g.:
	> Tooltype SYS:WBStartup/NoCapsLock
    1: CX_PRIORITY=127
    2: (CX_POPUP=AUTO|YES|NO)


Tooltype <FILE> VIEW <TOOLTYPE>

    Shows the content of a single tooltype. This can be useful if
    the value is required for processing inside a DOS or ARexx
    script.

    e.g.:
    > Tooltype SYS:WBStartup/NoCapsLock VIEW CX_PRIORITY
    127


Tooltype <FILE> ADD <TOOLTYPE> [<VALUE>]

    Adds a new tooltype with an optional value.

    e.g.:
    > Tooltype SYS:WBStartup/NoCapsLock ADD FOOBAR
    > Tooltype SYS:WBStartup/NoCapsLock ADD FOO BAR

    > Tooltype SYS:WBStartup/NoCapsLock
    1: CX_PRIORITY=127
    2: (CX_POPUP=AUTO|YES|NO)
    3: FOOBAR
    4: FOO=BAR


Tooltype <FILE> UPDATE <TOOLTYPE> [<VALUE>]

    Updates an exisitng tooltype with an optional value.

    e.g.:
    > Tooltype SYS:WBStartup/NoCapsLock UPDATE CX_PRIORITY -20
    > Tooltype SYS:WBStartup/NoCapsLock UPDATE FOO

    > Tooltype SYS:WBStartup/NoCapsLock
    1: CX_PRIORITY=-20
    2: (CX_POPUP=AUTO|YES|NO)
    3: FOOBAR
    4: FOO


Tooltype <FILE> DELETE <TOOLTYPE>

    Permanently deletes a tooltype.

    e.g.:
    > Tooltype SYS:WBStartup/NoCapsLock DELETE FOOBAR
    > Tooltype SYS:WBStartup/NoCapsLock DELETE FOO

    > Tooltype SYS:WBStartup/NoCapsLock
    1: CX_PRIORITY=-20
    2: (CX_POPUP=AUTO|YES|NO)



Real Life Usage Examples
------------------------

Add copyright information to a whole bunch of icon files:
> List #?.info LFORMAT "Tooltype %m ADD *"(<<<< Copyright © 2008 Christian
Rosentreter >>>>)*"" >executeme.bat
> Execute executeme.bat
> Delete executeme.bat

(actually under MorphOS you could pipe this directly to Execute without the 
need for the temporary file, but this is slightly buggy in MorphOS 1.4.x)



Disclaimer
----------

Tooltype is Freeware.

This software is provided "AS IS," with no warranties of any kind. Use at 
your own risk.


Credits
-------

Copyright © 2006-2008 Christian Rosentreter

http://www.christianrosentreter.com/
http://tokai.binaryriot.org/public/