This project is managed with GNU Autotools (the magic behind "./configure && make all install"). It needs a unix-like shell command line which is native with all linux distributions, with MacOS, but not with Microsoft Windows.
For windows developpers, install either MinGW with MSYS2 or Cygwin. I recommend the first one because Cygwin needs runtime dependencies which needs to be packaged with the builds. Whatever the choice, I will not document here how to install the installations processes, please read the related install docs.
I assume that MacOS developers already have HomeBrew installed.
The project uses the Mercurial:https://www.mercurial-scm.org Version Control System and publish the reporitory on the internet. The first step is to download and install Mercurial.
apt-get install -y mercurial
yum install mercurial
brew install mercurial
A whole Cygwin or MinGW development environment is needed, thus I recommend to install a commandline mercurial client. And, given that Windows users prefer mouse over keyboard, TortoiseHg can be also installed to integrate Mercurial features in Windows file explorer.
apt-get install -y build-essential
xcode-select --install
Autotools generates files such as configure which are distributed with the sources to compile them. This project does not store generated files in the repository. Thus, starting from the repository means to have autotools installed, to generate all the files needed to compile the project.
apt-get install -y autoconf autogen libtool pkg-config
brew install autoconf autogen libtool pkg-config
apt-get install -y libssl-dev
brew install openssl@3
For the developers, libopt was already installed with autogen and is available system-wide. For the maintainers, to avoid the need for autogen, a copy of libopts in automatically distributed in the source package.
The mandatory libssl-dev and libssl libraries should already be installed previously to allow configure to be executed.
Optionaly, the check library can be installed to allow unittesting.
apt-get install -y check
brew install check
From here, all the development specific dependencies are installed, but the project also have build dependencies (libraries).
./configure
make astyle
make cppcheck
xdg-open cppcheck/index.html
make cppcheck-clean
Included by default in make all target
make html
make pdf
make -C doc clean
make all check
make clean
make DESTDIR=`pwd`/_inst install installcheck
make DESTDIR=`pwd`/_inst uninstall
make dist distcheck
make distclean
make linux-appimage
make linux-clean
make debian-deb
make debian-clean
apt-get install rpm
mkdir -p rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
make redhat-rpm
make redhat-clean
make windows-zip
make windows-exe
make windows-clean
make macos-zip
make macos-dmg
make macos-pkg
make macos-clean