Difference between revisions of "IDE Window: External Tool"
(Hide main form) |
|||
(9 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
{{IDE Window: External Tool}} | {{IDE Window: External Tool}} | ||
− | Note | + | {{Note|External tools are global, not project specific}} |
− | + | [[File:IDE Window - External Tool.png]] | |
+ | === Title === | ||
This name is is shown in the IDE menu. | This name is is shown in the IDE menu. | ||
− | = | + | === Program Filename === |
The full path to the tool. For example: | The full path to the tool. For example: | ||
/usr/bin/ppc386 | /usr/bin/ppc386 | ||
− | = Parameters = | + | === Parameters === |
− | |||
The command line parameters. For example: | The command line parameters. For example: | ||
-l test.pas | -l test.pas | ||
− | = Working Directory = | + | === Working Directory === |
− | |||
The directory, where to start the tool. All relative paths will be relative to this. | The directory, where to start the tool. All relative paths will be relative to this. | ||
− | = | + | === Options === |
− | |||
− | == | ||
+ | ==== Scan output for FPC messages ==== | ||
Parse the output for FPC messages and jump to errors. | Parse the output for FPC messages and jump to errors. | ||
− | == | + | ==== Show console ==== |
− | + | Only available on MS Windows. Creates a console. Default is false. Since 1.7. | |
− | == | + | ==== Hide window ==== |
+ | Only available on MS Windows. Do not show the application window. Default is true. Since 1.7. | ||
+ | ==== Scan output for make messages ==== | ||
Parse the output for make messages and jump to errors. | Parse the output for make messages and jump to errors. | ||
− | = Key = | + | === Key === |
− | |||
Define the shortcut for this tool. This is optional. | Define the shortcut for this tool. This is optional. | ||
− | = Macros = | + | === Macros === |
− | |||
You can use macros in the programfilename, the parameters and the working directory. | You can use macros in the programfilename, the parameters and the working directory. | ||
See [[IDE Macros in paths and filenames]]. | See [[IDE Macros in paths and filenames]]. | ||
− | = | + | === Examples === |
− | Add a function to checkout | + | |
+ | ==== Run cmd.exe ==== | ||
+ | Choose <Tools><Configure External Tools> from the lazarus main menu | ||
+ | and setup the following. | ||
+ | * Title: cmd.exe | ||
+ | * Program Filename: C:\windows\system32\cmd.exe | ||
+ | * Working Directory: $(ProjPath) | ||
+ | * Disable all scanners | ||
+ | * Show console: enable | ||
+ | * Hide window: disable | ||
+ | |||
+ | ==== Run Tortoisesvn to checkout or update your local svn repository ==== | ||
+ | Add a function to checkout svn sources from the repository. | ||
This example shows how to do this if you are on windows and have tortoisesvn installed. | This example shows how to do this if you are on windows and have tortoisesvn installed. | ||
First create a batch-file in the folder lazarus\tools. (e.g lazarus\tools\checkout_lazarus_win.bat) | First create a batch-file in the folder lazarus\tools. (e.g lazarus\tools\checkout_lazarus_win.bat) | ||
Line 62: | Line 72: | ||
''tortoiseproc /command:update /path:"..\"'' | ''tortoiseproc /command:update /path:"..\"'' | ||
+ | |||
+ | [[Category:IDE Window]] |
Latest revision as of 09:17, 9 May 2023
│
Deutsch (de) │
English (en) │
español (es) │
français (fr) │
português (pt) │
Title
This name is is shown in the IDE menu.
Program Filename
The full path to the tool. For example:
/usr/bin/ppc386
Parameters
The command line parameters. For example:
-l test.pas
Working Directory
The directory, where to start the tool. All relative paths will be relative to this.
Options
Scan output for FPC messages
Parse the output for FPC messages and jump to errors.
Show console
Only available on MS Windows. Creates a console. Default is false. Since 1.7.
Hide window
Only available on MS Windows. Do not show the application window. Default is true. Since 1.7.
Scan output for make messages
Parse the output for make messages and jump to errors.
Key
Define the shortcut for this tool. This is optional.
Macros
You can use macros in the programfilename, the parameters and the working directory.
See IDE Macros in paths and filenames.
Examples
Run cmd.exe
Choose <Tools><Configure External Tools> from the lazarus main menu and setup the following.
- Title: cmd.exe
- Program Filename: C:\windows\system32\cmd.exe
- Working Directory: $(ProjPath)
- Disable all scanners
- Show console: enable
- Hide window: disable
Run Tortoisesvn to checkout or update your local svn repository
Add a function to checkout svn sources from the repository. This example shows how to do this if you are on windows and have tortoisesvn installed. First create a batch-file in the folder lazarus\tools. (e.g lazarus\tools\checkout_lazarus_win.bat)
tortoiseproc /command:checkout /url:"http://svn.freepascal.org/svn/lazarus/trunk/" /path:"..\"
Then choose <Tools><Configure External Tools> from the lazarus main menu and setup the following.
- Title: Checkout Lazarus
- Program Filename: $LazarusDir()\tools\checkout_lazarus_win.bat
- Working Directory: $LazarusDir()\tools\
If you want to add an additional function to update the Lazarus sources from repository, then you can create another batch-file with the following content.
tortoiseproc /command:update /path:"..\"