Tclpro™ User's Guide
Total Page:16
File Type:pdf, Size:1020Kb
TclPro™ User’s Guide • • • • • • Scriptics Corporation Version 1.3 COPYRIGHT Copyright © 1998, 1999 Scriptics Corporation. 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 and recorded for any purpose other than the purchaser’s personal use, without the express written permission of the Scriptics Corporation. Scriptics Corporation 2593 Coast Avenue Second Floor Mountain View, CA 94043 U.S.A http://www.scriptics.com TRADEMARKS TclPro and Scriptics are trademarks of the Scriptics Corporation. Other products and company names not owned by the Scriptics Corporation 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. Contents • • • • • • Chapter 1 Introduction to TclPro . 1 Installing TclPro . 2 Installing TclPro from CD . 2 Installing TclPro from the Web . 2 Installing Adobe Acrobat Reader . 2 Entering TclPro License Information . 3 About the TclPro Documentation . 3 For More Information . 4 TclPro Technical Support. 4 Finding Information about Tcl/Tk on the Web. 4 Tcl/Tk Training. 5 Related Documentation . 5 Chapter 2 TclPro Interpreters and Extensions . 7 TclPro Interpreters . 7 Running the TclPro Interpreters on Unix . 7 Running the TclPro Interpreters on Windows . 8 Extensions Incorporated in TclPro . 8 [incr Tcl] . 9 Expect . 9 Extended Tcl (TclX). 10 Chapter 3 TclPro Debugger. 11 Overview of TclPro Debugger . 11 Supported Tcl Versions . 11 Starting TclPro Debugger. 12 The TclPro Debugger Main Window . 12 The Tool Bar . 14 • • • • i • • The Stack Display. 14 The Variable Display . 15 The Code Display . 16 The Result Display . 17 Managing Projects. 17 Creating a New Project . 17 Opening an Existing Project . 20 Saving a Project . 20 Closing a Project . 20 Changing Project Settings. 20 Changing Project Application Settings. 21 Changing Project Instrumentation Settings . 23 Changing Project Error Settings . 26 Setting Default Project Settings . 27 Opening a File . 29 Controlling your Application . 29 Running Code with TclPro Debugger. 29 Run to Cursor . 30 Stepping through Code . 30 Stepping In . 30 Stepping Out . 31 Stepping Over . 32 Stepping to Result. 32 Interrupting the Application . 33 Killing the Application . 33 Restarting the Application . 33 Quitting TclPro Debugger. 34 Using Breakpoints . 34 Line-based breakpoints . 34 Variable Breakpoints. 34 Manipulating Breakpoints. 35 Viewing Breakpoints in the Breakpoints Window . 35 Navigating Code . 37 Going to a Specified Line . 37 Using the Find Utility . 37 Finding Procedures . 38 Using the Window Menu . 39 Displaying Code and Data. 39 • • • ii • • • Watching Variables . 40 Displaying Data . 41 Manipulating Data. 42 Error Handling . 43 Parsing Error Handling. 44 Runtime Error Handling . 44 Setting Preferences . 45 Appearance Preferences . 45 Window Preferences. 47 Startup and Exit Preferences. 48 Browser Preferences . 49 About TclPro Instrumentation . 50 Debugging Remote, Embedded, and CGI Applications . 51 Modifying a Tcl Script for Remote Debugging . 51 Remote Debugging Procedures . 51 Creating a “Wrapper” Script for Remote Debugging . 53 Modifying an Existing Script for Remote Debugging . 53 Creating a Remote Debugging Project . ..