Update compilation authored by Karel Slaný's avatar Karel Slaný
......@@ -12,16 +12,6 @@ Project depends on Qt5. ~~Minimal Qt version which the project is tested on is Q
> We recommend compiling [libisds](http://xpisar.wz.cz/libisds/) with the OpenSSL back-end option enabled to avoid [this problem](https://gitlab.labs.nic.cz/datovka/datovka/wikis/help#na-linuxov%C3%A9-distribuci-kterou-pou%C5%BE%C3%ADv%C3%A1m-p%C5%99ev%C3%A1%C5%BEn%C4%9B-debianubuntu-nejdou-stahovat-zpr%C3%A1vy) (#6). (Use `./configure --enable-openssl-backend` when configuring libisds sources.)
### Configuration Parameters
When running `qmake` several configuration parameters can be added to alter the installation or behaviour of the application. List of the parameters follows:
* `DISABLE_VERSION_CHECK_BY_DEFAULT=`**1** -- Alters the default behaviour which is new version notifications are displayed by default until manually disabled by the user. When this value is set then new version notifications are not displayed until manually enabled by the user.
* `DISABLE_VERSION_NOTIFICATION=`**1** -- (since datovka-4.10.2) New version notifications are disabled at compile time. They cannot be enabled by the user from the programme at runtime. Use it when you create Linux distribution package.
* `PORTABLE_APPLICATION=`**1** -- The application will store its configuration and all data in the application directory. Use this option only when creating a package for Windows.
* `PREFIX=`**"/usr"** -- Change the installation path on Linux/UNIX-like systems.
* `TEXT_FILES_INST_DIR=`**"/usr/share/datovka/"** -- Change the path to documents that should be also installed. Actual installation of these documents is not handled by the generated Makefile. This option is used for example in the Gentoo Ebuild files.
### Linux/UNIX
We don't currently use Autotools. The project directly relies on libisds, OpenSSL and Qt5 which should be installed in the system.
......@@ -175,16 +165,34 @@ make-win.bat
```
5. All built packages and installers can be found in the `packages` folder.
### Additional Configuration Options.
### Available Configuration Options
The command
``` shell
qmake DISABLE_VERSION_CHECK_BY_DEFAULT=1 datovka.pro
```
alters the default behaviour which is new version notifications are displayed by default until manually disabled by the user. When this value is set then new version notifications are not displayed until manually enabled by the user.
The option
``` shell
qmake DISABLE_VERSION_NOTIFICATION=1 datovka.pro
```
is available since datovka-4.10.2. New version notifications are disabled at compile time. They cannot be enabled by the user from the programme at runtime. Use it when you create Linux distribution package.
The command
``` shell
qmake PORTABLE_APPLICATION=1 datovka.pro
```
will configure the sources to build a portable version of Datovka. Portable application searches for the configuration directory in the directory where the executable is located. Also, some parts of the total functionality (e.g. database relocation) are disabled.
will configure the sources to build a portable version of Datovka. Portable application searches for the configuration directory in the directory where the executable is located. Also, some parts of the total functionality (e.g. database relocation) are disabled. The option makes really only sense when you compile a Windows target.
The command
``` shell
qmake DISABLE_VERSION_CHECK_BY_DEFAULT=1 datovka.pro
qmake PREFIX="/usr" datovka.pro
```
changes the installation path on Linux/UNIX-like systems.
The command
``` shell
TEXT_FILES_INST_DIR="/usr/share/datovka/" datovka.pro
```
disables automatic version checking by default. This function can be re-enabled by the user. Disabling update notifications can be especially useful when building Linux distribution packages. Distribution of binary packages across Linux distributions relies mostly on the package maintainers and can be lagged.
\ No newline at end of file
changes the path where to search for installed documents. Actual installation of these documents is not handled by the generated Makefile. This option is used for example in the Gentoo Ebuild files.
\ No newline at end of file