The CanDo How To Book, Version 1.022: New features of CanDo Version 1.02: Improved Utilities -- Located in CanDoExtras:Utilities (All utilities, other that TheInstaller, are documented in the Addendum.) TheInstaller (An improved CanDoInstaller) This utility is primarily for Hard drive users, though, if enough room exists on a WorkBench disk, some CanDo files may be installed to it. TheInstaller allows for selective placement of important CanDo files on a Hard drive with CanDo's Icon Default TOOLTYPES being correctly set for immediate use. We recommend that prior to running TheInstaller you create a drawer on your Hard drive, named CanDo, in which CanDo can be installed. The normal procedure will be to accept the first two stages: "C" directory to "C:" and "libs" directory to "Libs:". When TheInstaller asks for the directory to install CanDo itself, enter the path of the drawer you created. Install all further files to this path. TheBinder is improved. New Utilities: ThePrinter TheRelocator More tooltypes (described in Addendum) Improved control for CanDo V1.02 Control-F4 - Quick save of current deck (if it has filename) Control-F8 - Scrollscreen up/down Control-F9 - CanDo to back (along with user window) Control-Shift-F9 - CanDo to back Control-F10 - CanDo to front (along with user window) Control-Shift-F10 - CanDo to front Improved CanDo default searching When CanDo is started, it finds its default settings as follows: If CanDo is started From WorkBench AND ToolTypes exist in CanDo's Icon Use ToolTypes for defaults Else If CanDo.Defaults exists in current directory Use it for defaults Else If S:CanDo.Defaults exists Use it for defaults Else Use Built-in defaults EndIf EndIf EndIf New features of CanDo version 1.02: An index to the manual is included in the back of the addendum. This index encompasses CanDo's main manual, the addendum itself, and this file. You can copy and paste a card between decks or within the same deck. Here is the procedure: 1) Select "Copy" from the Objects menu. 2) Click on the "Card" icon between the next and previous card arrows on the Main Control Panel. 3) Select a card from the Card List Requester. 4) This will bring you back to the Main Control Panel. The Card is now in the Paste buffer. You may then load in another deck and select "Paste" from the Objects menu to insert this card. Improved coordinate system: both crosshairs and coordinate location are available, along with being able to turn off the sprite cursor. Crosshairs have been added to all object placement functions. Please note: these crosshairs indicate the hit area of the object, not the border of the object. When using these crosshairs to align a button with another, place the lines just inside the button edge. Some practice with this will help you to align buttons, fields and memo objects very quickly. Improved error handling handles all known errors. CanDo now manages memory more efficiently, thus runs better on 1 megabyte machines. Improved DOS EditorTool: a "CD & OK" button, added to the Dos Editor Tool, automatically inserts a script which runs an application from its own directory. DeckRunner and DeckBrowser, located in C:, can run bound and unbound decks. This allows persons to run CanDo decks distributed over BBS'S and networks without owning CanDo. New licensing policy for cando.library: Commercial developers should contact INOVATRONICS for information regarding licensing agreement to distribute applications that use the library. Flexible CanDo file requester: both height and width are adjustable, and icon suppression is now available from CanDo's tooltypes. The user interface has been modified to ensure that all OK and Cancel buttons on requesters are on the same side. The Deck Menu on CanDo's MainPanel now provides the familiar "SaveAs..." option to allow files to be saved under different names. Also, the "About" has been moved to the "Misc" menu, and renamed to CanDo {Version} Info. The Script Editor has an additional menu item: "About this script..." which tells you which script of which object you are editing, as well as the current line and column of the cursor. An Expert Mode option has been added. This option is turned on by adding "ExpertMode = ON" to your ToolTypes in CanDo's Icon or as a line in Cando.defaults. Expert Mode enables additional menu items on the Main Control Panel, such as "Flush Buffers" and "Dispose Variables". These items let you manually clear buffers and variables that are not in use. New keys are available to control CanDo: Control-F8 moves the CanDo screen up and down, like the up/down button next to the front/back gadgets. Control-F9 pushes the CanDo screen to the back. Control-F10 brings the CanDo screen to the front. In the Script Editor, Right-Amiga-P now asks you if you really wish to print the script if AUTOREQUESTERS are enabled. Problems and difficulties we found in versions 1.0 and 1.01 that were fixed with version 1.02: Shift-clicked selected deck not loaded with CanDo if DefaultDeck specified in ToolTypes. Deck specified as parameter on command line not loaded if DefaultDeck specified in cando.defaults. JAM2 draw mode used with extended print styles, like SHADOW, caused trouble. Card Movement commands were permitted in StartUp, AfterStartUp and Leaving scripts, which prevented the card from being edited. Errors in StartUp and AfterStartup scripts resulted in CanDo exiting back to DOS or Workbench. There was no way from within CanDo to retrieve the CanDo screen when a system requester popped up and pushed it to the back, behind the current screen. Control-F10 now returns the CanDo screen to the front. CanDo will now prevent you from saving a deck with the same name as any card in the deck. Known CanDo Limitations Cannot use double-quotes or the Alt-W character in object/card/routine names. CanDo removes them if you do use them. Cannot use card movement commands in card scripts (StartUp, AfterStartUp, Leaving scripts). If you do, this will cause an error and will bring up the error system. Cannot use proportional fonts in documents and you will not be allowed to select them. The sample decks in the Decks directory must be run from their current directory when running from CLI. They reference their resources by backing up a directory then looking for the Images, Sounds, etc., directories. These directories must remain relative in this manner or the deck will not find its resources. If you move these decks you will likely need to edit these resource paths with CanDo. Features of CanDo Version 1.021: Bug fixes in TheInstaller Features of CanDo Version 1.022: New SerialManager. Call INOVAtronics to request new, complete documentation, or call the INOVAtronics BBS. New commands: DrawBorder X, Y, Width, Height, NONE|BOX|OUTLINE|DOUBLEOUTLINE|EMBOSSED|SHADOW [,Pen1] [,Pen2] The DrawBorder command draws a border at a given location, with a given width and height, of the designated style, using the two pens for highlight colors. RefreshObject ObjectName Redraws the given Object on the screen which needs to be updated. This can be used to force a list or memo object to refresh during a script. New functions: "string" = PathOf("PATH:File") Given a file name, this function will return the portion of the name designating the PATH. "string" = FileOf("PATH:File") Given a file name, this function will return the portion of the name designating the File, without the PATH. = FileSize("FileName") This function returns the size of a given file. "string" = PathAndFile("PATH:","File") Give a path name and a file name, this function returns a valid filename for the given file in the given path.