Understand 5.0 User Guide and Reference Manual

1 user Guide and Reference ManualVersion 2018 Scientific Toolworks, N MainSt. George, UT 84770 Copyright 2018 Scientific Toolworks, Inc. All rights information in this document is subject to change without notice. Scientific Toolworks, Inc. makes no warranty of any kind regarding this material and assumes no responsibility for any errors that may appear in this RIGHTS: Use, duplication, or disclosure by the Government is subject to re-strictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Com-puter Software clause at DFAR (48 CFR). Contractor/Manufacturer is Scientific Toolworks, Inc.

2 , 53 N. Main, St. George, UT : Notwithstanding any other lease or license agreement that may pertain to or ac-company the delivery of this restricted computer software, the rights of the Government re-garding use, reproduction, and disclosure are as set forth in subparagraph (c)(1) and (2) of Commercial Computer Software-Restricted Rights clause at FAR Number: (2/18) Understand user Guide and Reference Manual3 ContentsChapter 1 IntroductionWhat is Understand ? .. 13 Languages Supported .. 14 For Those Who Don t Like to Read Manuals .. 15 Chapter 2 Parts and TerminologyUsing Understand Windows .. 17 Understand Terminology.

3 18 Parts .. 19 Starting Understand .. 20 Other Ways to Run Understand .. 21 Context Menus Are Everywhere .. 22 Quickly Find Things in Your Source .. 24 Entity Filter .. 24 Entity Locator .. 25 Instant Search .. 25 Find in Files .. 26 Favorites .. 26 Information Browser .. 27 Source Editor .. 28 Architecture Browser .. 29 Graphical Views .. 30 ASCII and HTML Reports .. 31 APIs for Custom Reporting .. 31 Chapter 3 Configuring Your ProjectAbout Understand Projects .. 33 The Understand Project Database .. 33 Creating a New Project .. 34 New Project Wizard .. 34 Project Configuration Dialog .. 39 Languages Category .. 41 Files Category.

4 43 Adding Directories .. 44 Adding Files .. 45 Removing Directories and Files .. 45 Setting Overrides .. 46 Scanning Watched Directories .. 47 Setting File Portability .. 48 File Types .. 49 File Options.. 50 Scheduled Activities .. 51 metrics .. 53 Contents4 Understand user Guide and Reference ManualMetrics > Selected Category .. 54 Reports .. 55 Reports > Output Category .. 55 Reports > Options Category.. 56 Reports > Selected Category .. 57 Visual Studio .. 58 CMake .. 60 Annotations .. 61 Ada Options .. 63 Ada > Macros Category .. 65 Assembly Options .. 67 Visual Basic Options .. 68 COBOL Options .. 69 COBOL > Copybooks Category.

5 70C++ (Fuzzy) Options.. 71C++ > Includes Category .. 73C++ > Includes > Auto Category .. 74C++ > Includes > Ignore Category .. 74C++ > Includes > Replacement Text .. 75C++ > Macros Category .. 75C++ > Macros > Undefines Category.. 77C++ (Strict) Options .. 78C++ (Strict) > Includes Category .. 80C++ (Strict) > Includes > Frameworks Category .. 81C++ (Strict) > Includes > Prefix Headers Category .. 82C++ (Strict) > Macros Category .. 82C# Options .. 83 Fortran Options .. 84 Fortran>Includes Category.. 86 Other Fortran Categories .. 86 Java Options .. 87 Java > Class Paths Category.. 88 Eclipse Plugin.. 88 JOVIAL Options.

6 89 Jovial > !Copy Category .. 90 Pascal Options .. 91 Pascal > Macros Category .. 92 Pascal > Standard Library Paths Category .. 92 Pascal > Search Paths Category .. 92PL/M Options .. 93PL/M>Includes Category .. 93 Python Options .. 94 Python > Imports Category .. 95 VHDL Options .. 95 Web Options .. 96 Setting General Preferences .. 98 General Category .. 99 ContentsUnderstand user Guide and Reference Manual5 user Interface Category .. 101 user Interface > Lists Category .. 102 user Interface > Alerts Category .. 103 user Interface > Windows Category .. 104 user Interface > Application Styles Category.. 106 Key Bindings Category.

7 107 Analyze Category .. 108 Portability Category .. 109 Dependency Category .. 110 Editor Category .. 111 Editor > Advanced Category .. 113 Editor > Macros Category .. 116 Editor > Styles Category .. 117 Editor > Navigation Category .. 118 Editor > External Editor Category.. 119 Graphs Category .. 120 Analyzing the Code.. 123 Improving the Analysis .. 124 Using the Missing Header Files Tool .. 125 Using the Undefined Macros Tool .. 127 Chapter 4 Exploring Your CodebasePLEASE RIGHT-CLICK .. 129 Various Windows .. 130 Entity Filter .. 131 Using the Filter Field .. 132 Customizing the Display.. 132 Root Filters.

8 133 Information Browser .. 133 Drilling Down a Relationship .. 134 Displaying More or Less Information .. 135 Searching the Information Browser .. 135 Syncing the Information Browser .. 136 Visiting Source Code .. 136 Visiting References .. 137 Viewing metrics .. 137 Saving and Printing Information Browser Text .. 138 Entity History .. 138 Project Browser .. 139 Exploring a Hierarchy .. 141 Dependency Browser .. 142 Favorites .. 144 Creating a Favorite Entity.. 144 Creating a Favorite View .. 145 Using a Favorites Group .. 145 Creating a Plain Text Favorite .. 147 Chapter 5 Searching Your SourceSearching: An Overview.

9 149 Contents6 Understand user Guide and Reference ManualInstant Search.. 150 Find in Files .. 152 Find Results .. 154 Replace in Files .. 155 Entity Locator .. 157 Resizing Columns .. 157 Long versus Short Names .. 157 Column Headers .. 158 Choosing Columns .. 158 Filtering the List .. 159 Finding Windows .. 162 Source Visiting History .. 163 View Menu Commands .. 163 Displaying Toolbars .. 164 Searching in a File .. 165 Find Next and Previous .. 165 Find & Replace.. 165 Contextual Information Sidebar .. 166 Chapter 6 Editing Your SourceSource Editor .. 168 Scope List .. 169 Status Icons .. 169 Status Line.

10 169 Selecting and Copying Text .. 170 Browse Mode .. 170 Context Menu .. 171 Hover Text .. 172 Saving Source Code .. 172 Refactoring Tools .. 173 Renaming Entities .. 174 Inlining Functions .. 175 Extracting Functions.. 176 Inline Temp .. 177 Extract Temp .. 178 Other Editing Features .. 179 Previewer .. 179 Bracket Matching .. 180 Folding and Hiding .. 180 Splitting the Editor Window .. 181 Commenting and Uncommenting.. 181 Changing Case .. 181 Indentation .. 182 Line Wrapping .. 182 Insert and Overtype Modes .. 182 Sorting Lines Alphabetically .. 182 Keyboard Commands .. 182 Recording, Playing, and Saving Macros.