IDE Window: Configure Build file: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: IDE Window: Configure Build file
| Old | New | Line | |
|---|---|---|---|
| 1 | + | Normally 'building' and 'running' menu items and shortcuts invokes building (running) the current project. | |
| 2 | + | ||
| 3 | + | With this dialog you can override this behaviour for each file. This is useful, if you created a small test program or a sub project. Then you can compile them without changing the project. These settings are stored with the project (.lpi file). They are not global settings. | |
| 4 | + | ||
| 5 | + | ## Build / Run File | |
| 6 | + | ||
| 7 | + | The IDE can build and run single files instead of the project. For example when pressing the *Run* button, the IDE checks if you enabled this feature for the current source file in the source editor. If yes, the IDE executes the Run File command instead. The information how to build or run a file is stored as IDE directives in the source file itself and can be setup via the dialog described on this page (Run / Configure Build+Run File). | |
| 8 | + | ||
| 9 | + | ### Options | |
| 10 | + | ||
| 11 | + | When this file is active in the source editor ... | |
| 12 | + | ||
| 13 | + | To override the behaviour for run and/or build by checking the appropriate checkbox. | |
| 14 | + | ||
| 15 | + | - On build project execute the Build File command instead | |
| 16 | + | - On run project execute the Run File command instead | |
| 17 | + | ||
| 18 | + | ### Build | |
| 19 | + | ||
| 20 | + | #### Working directory | |
| 21 | + | ||
| 22 | + | Before building, change to this directory. Relative paths in the build command will then be relative to this directory. | |
| 23 | + | ||
| 24 | + | #### Build Command | |
| 25 | + | ||
| 26 | + | Provide the command to call for building the file. The default is: | |
| 27 | + | ||
| 28 | + | ` $(CompPath) $(EdFile)` | |
| 29 | + | ||
| 30 | + | #### Scan for FPC messages | |
| 31 | + | ||
| 32 | + | Parse output for FPC errors and hints. The IDE will jump to errors. | |
| 33 | + | ||
| 34 | + | #### Scan for Make messages | |
| 35 | + | ||
| 36 | + | Parse output for 'Make' errors and hints. The IDE will jump to errors. | |
| 37 | + | ||
| 38 | + | #### Macros | |
| 39 | + | ||
| 40 | + | [[IDE Macros in paths and filenames]] | |
| 41 | + | ||
| 42 | + | ### Run | |
| 43 | + | ||
| 44 | + | #### Always build before run | |
| 45 | + | ||
| 46 | + | If checked, the Build File command is executed before running. | |
| 47 | + | ||
| 48 | + | #### Working directory | |
| 49 | + | ||
| 50 | + | Before running, change to this directory. Relative paths in the run command will then be relative to this directory. | |
| 51 | + | ||
| 52 | + | #### Run Command | |
| 53 | + | ||
| 54 | + | Provide the command to call to run file. The default is: | |
| 55 | + | ||
| 56 | + | ` $MakeExe($(EdFile))` | |
| 57 | + | ||
| 58 | + | #### Macros | |
| 59 | + | ||
| 60 | + | [[IDE Macros in paths and filenames]] | |
| 61 | + | ||
| 62 | + | ## IDE directives | |
| 63 | + | ||
| 64 | + | - **BuildCommand** | |
| 65 | + | - **BuildWorkingDir** | |
| 66 | + | - **BuildScan** | |
| 67 | + | - **RunCommand** | |
| 68 | + | - **RunWorkingDir** | |
| 69 | + | - **RunFlags** | |
| 70 | + | ||
| 71 | + | See [[IDE directives]]. | |
| 72 | + | ||
| 73 | + | --- | |
| 74 | + | *From the Free Pascal wiki, page "IDE Window: Configure Build file", as it stood on 2021-01-29 after a change by Trev, 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).* |