xca/INSTALL
Christian Hohnstädt 68273d0a30 Switch from autotools/qmake to cmake
Why?
 - QT will switch from qmake to cmake sooner or later.
 - autotools are good for unix-ish systems, cmake also for
   macOS and Xcode as well as Windows and VS-code
 - Cross compiling the windows-binaries on linux
   is not very helpful to attract windows-centric
   developers.

Also drop qmake's xca.pro
Generate man-page and sphinx sources of commandline arguments
during build by executing xca (xcadoc.cpp).
Generating Version-patchlevel and git hash is now also
OS independent.
2021-06-01 17:48:37 +02:00

96 lines
2.5 KiB
Plaintext

-------------------=[ XCA ]=---------------------
A graphical user interface to OpenSSL.
Requirements:
==============
for compilation, you need the following Libraries:
QT >= 5.0.0 from https://www.qt.io
OpenSSL >= 1.1.0 from https://www.openssl.org
C++11 compiler, e.g. GNU gcc >= 5
GNU make
INSTALL_DIR=/Users/chris/src/xca-dir/install \
cmake -DCMAKE_LIBRARY_PATH="$INSTALL_DIR"/lib \
-DCMAKE_INCLUDE_PATH="$INSTALL_DIR"/include \
-DCMAKE_PREFIX_PATH=/usr/local/Cellar/qt\@5/5.15.2/ \
-DCMAKE_BUILD_TYPE=Debug \
../xca
Installation:
=============
Configuration:
--------------
When cloning the git sources the autoconf configure
script must be assembled by calling
$ ./bootstrap
The officially published sources already come with
a configure script.
To build, just do the following steps:
$ ./configure; make -j6; make install
You can build in a different subdirectory:
- cd into the build directory and
- call configure by its full path.
For example, if you are in the freshly unpacked xca-1.1.0 directory:
$ mkdir Build && cd Build && ../configure && make -j10
To clean all built files: rm -rf Build
If you have a special setup, you can predefine the following
variables: CC, LD, STRIP, CFLAGS, prefix. e.g.:
$ CC="ccache gcc" STRIP=: CFLAGS="-Wall -g" prefix=/opt/xca ./configure
to have a cached build and to not strip xca when installing it.
XCA expects the translationfiles in /opt/xca/share/xca/
and installs itself to /opt/xca/bin/
configure allows to set the openssl and QT installation dir.
$ ./configure --help
shows all options. It writes all found settings to
"Local.mak" and "local.h"
Building:
-----------
The Makefiles do support parallel builds (-j)
targets:
all, xca : builds the app
install : installs the app
headers : UICs the headers in ui/ needed by other files.
clean : deletes all builded files
distclean: deletes also Local.mak
xca.exe : W32 executable (see INSTALL.w32)
snapshot : Creates a current snapshot from the local git repository
xca.app : Creates the MacOSX xca.app
xca.dmg : Creates the MacOSX Disk image
Installing:
------------
make DESTDIR=/my/virtual/root
provides /my/virtual/root/ as root-directory for installation
to be mounted by others as root or as installdir for
package builders.
Running/invoking:
=================
a detailed manual can be found in docs/
----------------------------------------------------------
if there are any questions regarding this software,
dont hesitate to contact me:
christian@hohnstaedt.de