Codewarrior Development Studio IDE 5.5 User's Guide
Total Page:16
File Type:pdf, Size:1020Kb
Freescale Semiconductor, Inc. CodeWarrior™ Development Studio IDE 5.5 User’s Guide Revised 20030610 For More Information: www.freescale.com Freescale Semiconductor, Inc. Metrowerks, the Metrowerks logo, and CodeWarrior are registered trademarks of Metrowerks Corp. in the US and/or other countries. All other tradenames and trademarks are the property of their respective owners. Copyright © Metrowerks Corporation. 2003. ALL RIGHTS RESERVED. The reproduction and use of this document and related materials are governed by a license agreement media, it may be printed for non-commercial personal use only, in accordance with the license agreement related to the product associated with the documentation. Consult that license agreement before use or reproduction of any portion of this document. If you do not have a copy of the license agreement, contact your Metrowerks repre- sentative or call 800-377-5416 (if outside the US call +1 512-997-4700). Subject to the foregoing non-commercial personal use, no portion of this documentation may be reproduced or transmitted in any form or by any means, electronic or mechanical, without prior written permission from Metrowerks. Metrowerks reserves the right to make changes to any product described or referred to in this document without further notice. Metrowerks makes no warranty, representation or guarantee regarding the merchantability or fitness of its prod- ucts for any particular purpose, nor does Metrowerks assume any liability arising out of the application or use of any product described herein and specifically disclaims any and all liability. Metrowerks software is not authorized for and has not been designed, tested, manufactured, or intended for use in developing applications where the fail- ure, malfunction, or any inaccuracy of the application carries a risk of death, serious bodily injury, or damage to tangible property, including, but not limited to, use in factory control systems, medical devices or facilities, nuclear facilities, aircraft or automobile navigation or communication, emergency systems, or other applica- tions with a similar degree of potential hazard. USE OF ALL SOFTWARE, DOCUMENTATION AND RELATED MATERIALS ARE SUBJECT TO THE METROWERKS END USER LICENSE AGREEMENT FOR SUCH PRODUCT. How to Contact Metrowerks Corporate Headquarters Metrowerks Corporation 7700 West Parmer Lane Austin, TX 78729 U.S.A. World Wide Web http://www.metrowerks.com Ordering & Technical Support Voice: (800) 377-5416 Fax: (512) 996-5300 For More Information: www.freescale.com Freescale Semiconductor, Inc. Table of Contents I Introduction 1 IDE User’s Guide Overview 15 Release Notes . 15 CodeWarriorU.com . 15 Documentation Structure . 16 Documentation Formats . 16 Documentation Types . 17 Manual Conventions . 17 Figure Conventions . 17 Keyboard Conventions . 18 Special note for Solaris users and Linux users. 18 2 CodeWarrior IDE Overview 19 Development Cycle . 19 CodeWarrior IDE Advantages . 21 IDE Tools Overview . 22 II Projects 3 Working with Projects 27 About Projects . 27 Project Manager . 27 Build Targets . 29 Managing Projects . 31 Advanced Projects . 38 Custom Project Stationery . 38 Subprojects . 39 IDE 5.5 User’s Guide 3 For More Information: www.freescale.com Freescale Semiconductor, Inc. Table of Contents Strategies . 40 4 Project Window 43 About the Project Window . 43 Project Window Pages . 45 Files Page . 45 Link Order Page . 47 Targets Page . 48 File, Group, Layout, and Target Management . 49 Build-Target Management . 53 5 Working with Files 59 Managing Files . 59 6 Dockable Windows 67 About Dockable Windows . 67 Working with Dockable Windows . 69 Dock Bars . 74 7 Workspaces 77 About Workspaces . 77 Using Workspaces. 77 8 Creating Console Applications 81 About Console Applications. 81 Creating Console Applications . 82 III Editor 9 The CodeWarrior Editor 87 Editor Window . 87 Editor Toolbar . 89 Interfaces Menu . 91 4 IDE 5.5 User’s Guide For More Information: www.freescale.com Freescale Semiconductor, Inc. Table of Contents Functions Menu . 91 Markers Menu . 91 Document Settings Menu. 92 Version Control System Menu . 92 Other Editor Window Components . 93 Path Caption . 93 File Modification Icon . 93 Breakpoints Column. 94 Text Editing Area . 94 Line and Column Indicator . 94 Pane Splitter Controls . 94 10 Editing Source Code 97 Text Manipulation. 97 Symbol Editing Shortcuts . 100 Punctuation Balancing . 101 Code Completion . 102 Code Completion Configuration . 103 Code Completion Window . 105 11 Navigating Source Code 111 Finding Interface Files, Functions, and Lines . 111 Finding Interface Files . 112 Locating Functions . 112 Going Back and Forward . 114 Using Markers . 115 Remove Markers Window . 115 Symbol Definitions . 117 Reference Templates (Macintosh) . 119 12 Finding and Replacing Text 121 Single-File Find . 121 Single-File Find and Replace . 124 Multiple-File Find and Replace . 127 IDE 5.5 User’s Guide 5 For More Information: www.freescale.com Freescale Semiconductor, Inc. Table of Contents In Folders . 129 In Projects. 131 In Symbolics. 133 In Files . 135 Search Results Window . 138 Text-Selection Find . 140 Regular-Expression Find . 142 Using the Find String in the Replace String. 144 Remembering Sub-expressions . 144 Comparing Files and Folders . 145 Comparison Setup . 145 File Comparison . 149 Folder Comparison . 152 IV Browser 13 Using the Browser 157 Browser Database . 157 Browser Data . 158 Browser Symbols . 160 Browser Contextual Menu . 160 14 Using Class Browser Windows 163 Class Browser window . 163 Classes pane . 169 Member Functions pane . 171 Data Members pane . 172 Source pane . 172 Status Area . 173 15 Using Other Browser Windows 175 Multiple-Class Hierarchy Window . 175 6 IDE 5.5 User’s Guide For More Information: www.freescale.com Freescale Semiconductor, Inc. Table of Contents Single-Class Hierarchy Window . 178 Browser Contents window . 179 Symbols window . 181 Symbols toolbar . 183 Symbols pane . 183 Source pane . 183 16 Using Browser Wizards 185 The New Class Wizard . 185 The New Member Function Wizard . 190 The New Data Member Wizard . 193 VDebugger 17 Working with the Debugger 199 About the CodeWarrior Debugger . 199 About Symbolics Files . 200 Thread Window. 200 Common Debugging Actions . 204 Symbol Hint . 207 Contextual Menus . 209 Multi-core Debugging . 210 18 Manipulating Program Execution 211 Breakpoints . 212 Breakpoints Window . 212 Working with Breakpoints . 215 Working with Breakpoint Templates . 220 Eventpoints . 223 Log Point . 224 Pause Point . ..