IDE Window: Codetools Defines Editor: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 2 | - | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 7 | - | ||
| 1 | + | > **Note:** These values are only used by the codetools, not by the compiler. To setup search paths use the [[IDE Window: Environment Options|Environment options]], [[IDE Window: Compiler Options|Compiler Options]], [[IDE Window: Package Editor|Package Editor]] and [[IDE Window: Project Inspector|Project Inspector]]. The IDE automatically creates codetools nodes for those values. | |
| 2 | + | > | |
| 3 | + | > This dialog is mainly for debugging, when codetools parse different than the compiler. Or to setup the Delphi sources in the Lazarus IDE. | |
| 8 | 4 | ||
| 9 | - | ||
| 10 | - | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 24 | - | ||
| 25 | - | ||
| 26 | - | ||
| 27 | - | ||
| 28 | - | ||
| 29 | - | ||
| 30 | - | ||
| 31 | - | ||
| 32 | - | ||
| 33 | - | ||
| 34 | - | ||
| 35 | - | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 5 | + |  | |
| 48 | 6 | ||
| 49 | 7 | ## Introduction | |
| 50 | 8 | ||
| 51 | - | ||
| 9 | + | The codetools provide functions to parse pascal sources - FreePascal, Delphi, Kylix. To find the pascal sources they need the search paths and to parse the IFDEFs they need the compiler flags. These values are defined by rules - the **define templates**. | |
| 52 | 10 | ||
| 53 | - | ||
| 11 | + | For every directory the codetools manage a set of values. That means every unit in a directory share the same values (paths and flags). That's why you should **only** put two projects/packages into one directory if they use the same settings. On the other hand this system allows to handle an arbitrary number of distinct sources at the same time. For example you can have Delphi and FreePascal sources. The Delphi sources will use the Delphi system.pas, while the FPC sources will use the FPC system.pp. Or you can have two different FPC versions. Or several FPC cross sources (For example for linux and windows). You do not need to restart the IDE or recompile anything for that. Note: The compiler of course can only handle one type of sources. | |
| 54 | 12 | ||
| 55 | - | ||
| 13 | + | This dialog allows to explore and edit the define templates. | |
| 56 | 14 | ||
| 57 | - | ||
| 15 | + | All values and variables can contain macros. A variable that was assigned an empty value '' is still defined. That means 'IFDEF variable' will still result in 'true'. To purge a variable use 'Undefine'. | |
| 58 | 16 | ||
| 59 | 17 | ## Tree - predefined nodes | |
| 60 | 18 | ||
| 61 | 19 | ### Free Pascal Compiler | |
| 62 | 20 | ||
| 63 | - | ||
| 21 | + | This node provides global definitions, provided by the currently used compiler set in the project's compiler options. They are updated if you change the compiler in the compiler options (e.g. IDE loads a project) or 'Rescan FPC source directory'. they are not automatically updated when you install another FPC while the IDE is running. They are auto generated and can not be changed. | |
| 64 | 22 | ||
| 65 | 23 | ### Free Pascal Sources | |
| 66 | 24 | ||
| 67 | - | ||
| 25 | + | This node provides definitions for the Free Pascal source directory, defined in the environment options. The nodes are auto created by some fix wired heuristics in the codetools (components/codetools/definetemplates.pas function CreateFPCSrcTemplate) and can not be changed in the dialog. They are updated when the FPC source directory is changed (e.g. in options or on IDE start) or the Target CPU or OS changes or by 'Rescan FPC source directory'. They are not updated, when files are changed on disk while the IDE is running. | |
| 68 | 26 | ||
| 69 | 27 | ### Lazarus Sources | |
| 70 | 28 | ||
| 71 | - | ||
| 29 | + | This node provides definitions for the Lazarus source directory, defined in the environment options. The nodes are auto created by some fix wired heuristics in the codetools (components/codetools/definetemplates.pas function CreateLazarusSrcTemplate) and can not be changed in the dialog. They are updated when the Lazarus source directory is changed (e.g. in options or on IDE start). They are not updated, when files are changed on disk while the IDE is running. | |
| 72 | 30 | ||
| 73 | 31 | ### Packages | |
| 74 | 32 | ||
| 75 | - | ||
| 33 | + | The IDE creates on node for each package. At the moment the nodes of the packages LCL, IDEIntf, SynEdit and Codetools are special packages and defined by the 'Lazarus Sources'. | |
| 76 | 34 | ||
| 77 | 35 | ## Node types | |
| 78 | 36 | ||
| 79 | - | ||
| 37 | + | The codetools parse the nodes from top to bottom. Some nodes like *Directory*, *IF*, *IFDEF*, ... control if their child nodes are parsed or not. | |
| 80 | 38 | ||
| 81 | - | ||
| 39 | + | The tree shows two icons for each node. The first is the node type (Block, IF, IFDEF, ...). The second icon shows a 'computer', if the node was auto created and can not be altered. | |
| 82 | 40 | ||
| 83 | 41 | ### Block | |
| 84 | 42 | ||
| 85 | - | ||
| 43 | + | This node type exists only to group nodes. | |
| 86 | 44 | ||
| 87 | 45 | ### Directory | |
| 88 | 46 | ||
| 89 | - | ||
| 47 | + | To create nodes only valid for a specific directory use this node type. The child nodes are only parsed for the directory specified in **Value**. **Define** and **Undefine** nodes will set/clear variables only for this directory, not for the sub directories. To set/clear variables for sub directories, create a child node of type **Directory** or use the **Define Recurse**, **Undefine Recurse**. | |
| 90 | 48 | ||
| 91 | 49 | ### Define | |
| 92 | 50 | ||
| 93 | - | ||
| 51 | + | Sets a flag/value for the current directory. Examples: | |
| 94 | 52 | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 53 | + | - Set Name to 'Def1'. Now IFDEF Def1 will be true and in source a {\$IFDEF Def1} will be parsed by the codetools. | |
| 54 | + | - Set Name to 'Def1' and Value to '123'. Same as above, but addionally IF Def1=123 gives true. | |
| 55 | + | - Set Name to 'Def1' and Value to '\$(Def1);bogus'. This will append ';bogus' to the value of Def1. | |
| 98 | 56 | ||
| 99 | 57 | ### Define Recurse | |
| 100 | 58 | ||
| 101 | - | ||
| 59 | + | Same as **Define**, but for the current directory and all sub directories. | |
| 102 | 60 | ||
| 103 | 61 | ### Undefine | |
| 104 | 62 | ||
| 105 | - | ||
| 63 | + | Purges a variable form the current set of definitions. | |
| 106 | 64 | ||
| 107 | 65 | ### Undefine Recurse | |
| 108 | 66 | ||
| 109 | - | ||
| 67 | + | Same as **Undefine**, but for the current directory and all sub directories. | |
| 110 | 68 | ||
| 111 | 69 | ### Undefine All | |
| 112 | 70 | ||
| 113 | - | ||
| 71 | + | Same as **Undefine Recurse**, but purges all variables. Useful for directories that build their own world. For example the FPC source. | |
| 114 | 72 | ||
| 115 | 73 | ### IfDef | |
| 116 | 74 | ||
| 117 | - | ||
| 75 | + | If the Variable is defined the child nodes are executed. | |
| 118 | 76 | ||
| 119 | 77 | ### IfNDef | |
| 120 | 78 | ||
| 121 | - | ||
| 79 | + | If the Variable is **not** defined the child nodes are executed. | |
| 122 | 80 | ||
| 123 | 81 | ### If | |
| 124 | 82 | ||
| 125 | - | ||
| 83 | + | Executes the expression in Value and if the result is '1' then the child nodes are executed. The syntax is the same as the compiler. For example 'defined(avariable)' returns '1' if the avariable is defined, otherwise '0'. Examples: | |
| 126 | 84 | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 85 | + | - Set 'Value' to 'defined(linux) and defined(i386)' | |
| 86 | + | - To check for a specific FPC version: 'VER2_0 or VER2_2'. The variables will be replaced by their values. Empty or not defined values result in '0'. | |
| 87 | + | - To compare the values of two variables use: '\$(#TargetOS)'='\$(#SrcOS)'. IMPORTANT: If you forget the apostrophes, the following will happen: First the macros will be replaced, which results in linux=unix, which is further replaced by the values of the variables: 1=1, which always results to true. | |
| 130 | 88 | ||
| 131 | 89 | ### ElseIf | |
| 132 | 90 | ||
| 133 | - | ||
| 91 | + | If all former If resulted in false, then the ElseIf or Else node is executed. The ElseIf is the same as an Else If. | |
| 134 | 92 | ||
| 135 | 93 | ### Else | |
| 136 | 94 | ||
| 137 | - | ||
| 95 | + | If all former If or ElseIf resulted false, then this node is executed. | |
| 138 | 96 | ||
| 139 | 97 | ## Menu | |
| 140 | 98 | ||
| 141 | 99 | ### Exit - Save and Exit | |
| 142 | 100 | ||
| 143 | - | ||
| 101 | + | Save changes and close dialog. | |
| 144 | 102 | ||
| 145 | 103 | ### Exit - Exit without Save | |
| 146 | 104 | ||
| 147 | - | ||
| 105 | + | Discard changes and close dialog. | |
| 148 | 106 | ||
| 149 | 107 | ### Edit - Move node up | |
| 150 | 108 | ||
| 151 | - | ||
| 109 | + | Move selected node in front of next upper sibling. | |
| 152 | 110 | ||
| 153 | 111 | ### Edit - Move node down | |
| 154 | 112 | ||
| 155 | - | ||
| 113 | + | Move selected node below next lower sibling. | |
| 156 | 114 | ||
| 157 | 115 | ### Edit - Move node one level up | |
| 158 | 116 | ||
| 159 | - | ||
| 117 | + | Move selected node to parent node. | |
| 160 | 118 | ||
| 161 | 119 | ### Edit - Move node one level down | |
| 162 | 120 | ||
| 163 | - | ||
| 121 | + | Make selected node a child of the previous sibling. | |
| 164 | 122 | ||
| 165 | 123 | ### Edit - Insert node below | |
| 166 | 124 | ||
| 167 | - | ||
| 125 | + | Create a new node and insert it below selected node. | |
| 168 | 126 | ||
| 169 | 127 | ### Edit - Insert node as child | |
| 170 | 128 | ||
| 171 | - | ||
| 129 | + | Create a new node and insert it as child of selected node. | |
| 172 | 130 | ||
| 173 | 131 | ### Edit - Delete node | |
| 174 | 132 | ||
| 175 | - | ||
| 133 | + | Delete selected node. | |
| 176 | 134 | ||
| 177 | 135 | ### Edit - Convert node | |
| 178 | 136 | ||
| 179 | - | ||
| 137 | + | Change type of selected node. | |
| 180 | 138 | ||
| 181 | 139 | ### Tools - Open Preview | |
| 182 | 140 | ||
| 183 | - | ||
| 141 | + | Open the [[IDE Window: Codetools Directory Values|Codetools Directory Values]]. | |
| 184 | 142 | ||
| 185 | 143 | ### Insert Template | |
| 186 | 144 | ||
| 187 | - | ||
| 145 | + | Create a new node from the templates and insert it below selected node. | |
| 188 | 146 | ||
| 189 | 147 | ## Treeview | |
| 190 | 148 | ||
| 191 | - | ||
| 149 | + | Select a node and view the details below. | |
| 192 | 150 | ||
| 193 | 151 | ## Selected node | |
| 194 | 152 | ||
| 195 | 153 | ### Name | |
| 196 | 154 | ||
| 197 | 155 | ### Description | |
| 198 | 156 | ||
| 199 | 157 | ### Value | |
| 200 | 158 | ||
| 201 | 159 | ### Value as Text | |
| 202 | 160 | ||
| 203 | - | ||
| 161 | + | Shows the value. | |
| 204 | 162 | ||
| 205 | 163 | ### Values as File Paths | |
| 206 | 164 | ||
| 207 | 165 | Splits the value for semicolons and shows each path on a separate line. | |
| 208 | 166 | ||
| 209 | 167 | --- | |
| 210 | - | ||
| 168 | + | *From the Free Pascal wiki, page "IDE Window: Codetools Defines Editor", as it stood on 2018-05-22 after a change by FTurtle, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |