Root > Integral parts > Options > General page

General page

Previous pageReturn to chapter overviewNext page   

This is "General" page in EurekaLog project's options.


General page contains EurekaLog activation options. If you need to enable/disable EurekaLog in your application - you can do it here. The page will look different depending on EurekaLog being enabled for the project. By default, EurekaLog is not enabled for project. Additionally, it will look differently in external Settings Editor tool, as well as in older IDEs without support for profiles (build configurations).


When EurekaLog is not enabled (default) - the page looks like this:



General page for projects without EurekaLog


1. You can click on "Enable EurekaLog for this project" button to enable EurekaLog and perform a basic configuration. Dialog will ask you to select base settings:



General page when enabling EurekaLog



2. You should select application type which is closest to your project type. The application type defines a typical values for many EurekaLog options. You can change any individual option later.


Note: This option will also load all custom saved external configurations, which were saved to default folder on export (via "Export" button). See Working with configurations and Compiling your project with and without EurekaLog for more information. Custom configurations will be listed at the end of the list.


Custom configuration will be applied (e.g. copied). Any future changes in custom configuration will not affect configuration of your project. If you want to use custom configuration by reference - use external configuration (see below).


Once you click on "Apply Settings" - EurekaLog will be enabled and configured. The "General" page will change to:



General options for projects with EurekaLog active ("Profiles" tab), Delphi 2009+ only



General options for projects with EurekaLog active ("More" tab)



3. Now you can use "Reset" button to clear project from EurekaLog and its settings. The option tree will be enabled and you can change all EurekaLog options.


See also:




General options for projects with EurekaLog active ("Profiles" tab), Delphi 2009+ only


4. "Profiles" tab will appear only for Delphi 2009 and above. Only these IDEs has full support for build configurations (profiles). Use it to enable / disable EurekaLog in specific build configurations. By default, EurekaLog will be enabled for all profiles.



Enabling checkbox for any profile is essentially the same as defining EUREKALOG conditional symbol in the profile.
Settings are inherited, therefore enabling EurekaLog in base profile will enable it for every other profile. If you want EurekaLog be enabled only in (for example) "Debug" profile - you have to disable EurekaLog in "Base" profile first, then enable it in "Debug" profile.



1. If no checkbox is selected - EurekaLog will be disabled for the entire project, even though you have configured it.
2. Some IDE versions have bugs in OTA (OpenTools API), which prevents EurekaLog from adding/removing conditional define. If your options do not change when you make changes through EurekaLog's project options dialog - please, add or remove EUREKALOG conditional symbol manually.




General options for projects with EurekaLog active ("More" tab)


Advanced options ("More" tab) - use it for custom setups:


5. "Add EurekaLog's code" option includes EurekaLog's units in your application. Click on "Customize" button to select which units include in your application. You can uncheck this checkbox, if you don't want to include EurekaLog's code in current executable.



6. "Add module's options" option adds EurekaLog project options to your application. You set EurekaLog project options in this dialog. Including EurekaLog's options is necessary for EurekaLog to function. You can uncheck this checkbox, if you don't want to include EurekaLog's code in current executable.


Note: this option must be set if you check either "Add EurekaLog's code" or "Add debug information" options.



7. "Add debug information" option injects debug information in EurekaLog's format into your application. Debug information is necessary to build a human-readable call-stack and get textual descriptions of code's locations. You can uncheck this checkbox if you plan to use debug information in other format.



8. "Use external configuration" option allows you to use EurekaLog configuration in external .eof file instead of configuration inside project. Checking this option will disable all other options in this dialog. You also need to specify .eof file to use. You can use "..." button to select file and "Edit" button to edit settings in external file (the last action requires file association with .eof files). See also: using external configuration.



General page when using external configuration


Uncheck "Use external configuration" option to revert to default local storage.


Note: external configuration is used by reference. Changes in external configuration will be reflected immediately, there is no need to open EurekaLog's project options dialog.



9. "Debug output" option will enable detailed debug mode for output from EurekaLog command-line compiler. Detailed output will appear in IDE's Messages window ("Build" tab).


Use this option for diagnostic purposes. Disable for normal daily usage.



10. "Calculate stats" option will collect statistics about EurekaLog's work and your compiled application. You have to rebuild the project to collect statistics. Collected stats will appear in IDE's Messages window ("Build" tab). You can also view them at "Statistics" tab. Build stats are not saved when project is closed.


Note: enabling both "Calculate stats" and "Debug output" options will greatly increase amount of collected statistics.



11. "Before Compile" and "After Compile" options are read-only. It's for informational purposes only. These edit boxes show command-line to run to enable EurekaLog in your project (if you're compiling outside of IDE). Please, see Compiling your project with EurekaLog article for more information. Edit box will indicate "N\A" if there is no project opened.


These options are affected by "Use external configuration", "Debug output" and "Calculate stats" options.



You do not need to run these commands if you compile your project in IDE with EurekaLog IDE expert installed.
Dialog shows you command lines in "before/after"-style (see: Post-processing without (re)compilation). It does not show you a single command line to perform compile and post-processing in one go. That is because it lacks information to build such command line. Generally speaking, you should have a command line for dcc32, and you need to replace "dcc32" with "ecc32". See: EurekaLog post-process compilers.



See also:

Send feedback... Build date: 2021-02-14
Last edited: 2019-09-24
The documentation team uses the feedback submitted to improve the EurekaLog documentation. We do not use your e-mail address for any other purpose. We will remove your e-mail address from our system after the issue you are reporting has been resolved. While we are working to resolve this issue, we may send you an e-mail message to request more information about your feedback. After the issues have been addressed, we may send you an email message to let you know that your feedback has been addressed.

Permanent link to this article: