Startlazarus: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
Title: startlazarus Startlazarus
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 1 | + | ## Overview | |
| 2 | + | ||
| 3 | + | Startlazarus is an application that works together with the IDE. Its primary task is to start the right IDE executable. Its secondary task is to restart the IDE. | |
| 4 | + | ||
| 5 | + | At the moment FPC cannot compile dynamic libraries with shared classes. That's why designtime packages are compiled statically into the IDE, which means every time you install/uninstall a package a new IDE executable must be compiled. | |
| 6 | + | ||
| 7 | + | Linux and macOS users compiling Lazarus from svn don't need startlazarus, but it does not hurt to use it. | |
| 8 | + | ||
| 9 | + | ## Under Windows | |
| 10 | + | ||
| 11 | + | Windows locks exe files while running the application. The IDE compiles a lazarus.new.exe. When the IDE restarts it starts startlazarus and quits itself. startlazarus then renames the old lazarus.exe to lazarus.old.exe and renames the new lazarus.new.exe to lazarus.exe. Then it starts lazarus.exe and quits itself. | |
| 12 | + | ||
| 13 | + | ## Searching the right executable | |
| 14 | + | ||
| 15 | + | When the Lazarus directory is write protected, as in Unix systems, the IDE builds its new executable into a sub folder of the primary config path, for example ~/.lazarus/bin/. You can see the primary config path in View / IDE internals / About IDE. | |
| 16 | + | ||
| 17 | + | Once you run startlazarus, it searches and starts the newest lazarus executable. Initially it starts the original from the installation directory. After Lazarus has rebuilt itself, startlazarus starts the newly built version. | |
| 18 | + | ||
| 19 | + | ## Restarting the IDE | |
| 20 | + | ||
| 21 | + | When the IDE restarts, it starts *startlazarus* and quits. startlazarus waits for the IDE to quit, searches for the new executable and starts it. Under Windows it renames the exe. | |
| 22 | + | ||
| 23 | + | ## Parameters | |
| 24 | + | ||
| 25 | + | --debug | |
| 26 | + | if given, startlazarus calls the IDE with "--debug-log=\<primaryconfigpath\>/debug.log". | |
| 27 | + | ||
| 28 | + | --lazarus-pid= | |
| 29 | + | passed by the IDE on restart. startlazarus waits for this process ID before starting a new IDE. | |
| 30 | + | ||
| 31 | + | --no-splash-screen or --nsc | |
| 32 | + | do not show splash screen | |
| 33 | + | ||
| 34 | + | --primary-config-path= or --pcp= | |
| 35 | + | [[pcp|primary config path]], passed to the IDE, since 0.9.31 used by startlazarus to find the new executable | |
| 36 | + | ||
| 37 | + | --secondary-config-path= or --scp= | |
| 38 | + | secondary config path, passed to the IDE, not used by startlazarus | |
| 39 | + | ||
| 40 | + | ## See also | |
| 41 | + | ||
| 42 | + | - [[Lazarus directory permissions on Linux and Unix]] | |
| 43 | + | ||
| 44 | + | --- | |
| 45 | + | *From the Free Pascal wiki, page "Startlazarus", as it stood on 2022-06-03 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).* |