• • • • • • Ajuba Solutions Version 1.4 COPYRIGHT Copyright © 1998-2000 Ajuba Solutions Inc. All rights reserved. Information in this document is subject to change without notice. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means electronic or mechanical, including but not limited to photocopying or recording, for any purpose other than the purchaser’s personal use, without the express written permission of Ajuba Solutions Inc. Ajuba Solutions Inc. 2593 Coast Avenue Mountain View, CA 94043 U.S.A http://www.ajubasolutions.com TRADEMARKS TclPro and Ajuba Solutions are trademarks of Ajuba Solutions Inc. Other products and company names not owned by Ajuba Solutions Inc. that appear in this manual may be trademarks of their respective owners. ACKNOWLEDGEMENTS Michael McLennan is the primary developer of [incr Tcl] and [incr Tk]. Jim Ingham and Lee Bernhard handled the Macintosh and Windows ports of [incr Tcl] and [incr Tk]. Mark Ulferts is the primary developer of [incr Widgets], with other contributions from Sue Yockey, John Sigler, Bill Scott, Alfredo Jahn, Bret Schuhmacher, Tako Schotanus, and Kris Raney. Mark Diekhans and Karl Lehenbauer are the primary developers of Extended Tcl (TclX). Don Libes is the primary developer of Expect. TclPro Wrapper incorporates compression code from the Info-ZIP group. There are no extra charges or costs in TclPro due to the use of this code, and the original compression sources are freely available from http://www.cdrom.com/pub/infozip or ftp://ftp.cdrom.com/pub/infozip. NOTE: TclPro is packaged on this CD using Info-ZIP’s compression utility. The installation program uses UnZip to read zip files from the CD. Info-ZIP’s software (Zip, UnZip, and related utilities) is free and can be obtained as source code or executables from Internet WWW sites including http://www.cdrom.com/pub/infozip. • • • • • • Chapter 1 Introduction to TclPro . 1 About the TclPro Documentation . 2 For More Information . 3 TclPro Technical Support. 3 Finding Information about Tcl/Tk . 3 Tcl/Tk Training. 3 Related Documentation . 4 Chapter 2 Installing TclPro . 5 Installing TclPro from CD or the Web . 5 Installing TclPro from CD . 6 Installing TclPro from the Web . 6 Installing TclPro on Windows . 6 Installing TclPro on Unix . 7 Mounting the CD-ROM and Running the Installer . 8 Installing TclPro . 9 Installing Ajuba Solutions License Server . 11 Changing TclPro License Information . 12 Installing Adobe Acrobat Reader . 13 Unmounting the CD-ROM . 14 Chapter 3 TclPro Interpreters and Extensions . 15 TclPro Interpreters . 15 Running the TclPro Interpreters on Unix . 15 Running the TclPro Interpreters on Windows . 16 Extensions Incorporated in TclPro . 16 [incr Tcl] . 17 Expect . 17 • • • • i • • Extended Tcl (TclX) . 18 Chapter 4 TclPro Debugger . 19 Overview of TclPro Debugger . 19 Supported Tcl Versions. 19 Starting TclPro Debugger . 20 The TclPro Debugger Main Window . 20 The Tool Bar. 22 The Stack Display. 22 The Variable Display . 23 The Code Display . 24 The Result Display . 25 Setting Preferences . 25 Appearance Preferences . 25 Window Preferences . 26 Startup and Exit Preferences. 27 Other Preferences . 29 Managing Projects. 30 Creating a New Project . 30 Opening an Existing Project . 32 Saving a Project . 33 Closing a Project . 33 Changing Project Settings. 33 Changing Project Application Settings. 33 Changing Project Instrumentation Settings . 36 Changing Project Error Settings . 38 Setting Default Project Settings . 39 Opening a File . 40 Controlling your Application . 41 Running Code with TclPro Debugger. 41 Run to Cursor . 41 Stepping through Code . 42 Stepping In . 42 Stepping Out . 43 Stepping Over . 43 Stepping to Result. 44 Interrupting the Application . 44 Killing the Application . 45 • • • ii • • • Restarting the Application . 45 Quitting TclPro Debugger . 45 Using Breakpoints. 45 Line-based breakpoints. 45 Variable Breakpoints . 46 Manipulating Breakpoints . 46 Viewing Breakpoints in the Breakpoints Window . 46 Navigating Code . 48 Going to a Specified Line. 48 Using the Find Utility . 49 Finding Procedures . 49 Using the Window Menu . 51 Displaying Code and Data . 51 Watching Variables . 51 Displaying Data . 52 Manipulating Data. 54 Error Handling . ..