ac32b4b98c
Sometimes it's desirable to append local version naming to packages, and currently it can only be done using SUBVERS which is already set by default to the git commit ID and patch count since last known tag, making the addition a bit complicated. Let's just add a new EXTRAVERSION field that is empty by default, and systematically appended verbatim to the version string everywhere. This way it becomes trivial to append some local strings, such as: make TARGET=foo EXTRAVERSION=+$(quilt applied|wc -l) -> 2.3-dev5-5018aa-15+1 or : make TARGET=foo EXTRAVERSION=-$(date +%F) -> 2.3-dev5-5018aa-15-20200110 Let's be careful not to add double quotes (used as the string delimiter) nor spaces (which can confuse version parsers on the output). The extra version is also used to name a tarball. It's always pre-initialized to an empty string so that it's not accidently inherited from the environment. It's not reported in "make version" to avoid fooling tools (it would be pointless anyway). As a side effect it also becomes possible to force VERSION and SUBVERS to an empty string and use EXTRAVERSION alone to force a specific version (could possibly be useful when bisecting from patch queues outside of Git for example). |
||
|---|---|---|
| .github | ||
| contrib | ||
| doc | ||
| examples | ||
| include | ||
| reg-tests | ||
| scripts | ||
| src | ||
| tests | ||
| .cirrus.yml | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| BRANCHES | ||
| CHANGELOG | ||
| CONTRIBUTING | ||
| INSTALL | ||
| LICENSE | ||
| MAINTAINERS | ||
| Makefile | ||
| README | ||
| ROADMAP | ||
| SUBVERS | ||
| VERDATE | ||
| VERSION | ||
README
The HAProxy documentation has been split into a number of different files for ease of use. Please refer to the following files depending on what you're looking for : - INSTALL for instructions on how to build and install HAProxy - BRANCHES to understand the project's life cycle and what version to use - LICENSE for the project's license - CONTRIBUTING for the process to follow to submit contributions The more detailed documentation is located into the doc/ directory : - doc/intro.txt for a quick introduction on HAProxy - doc/configuration.txt for the configuration's reference manual - doc/lua.txt for the Lua's reference manual - doc/SPOE.txt for how to use the SPOE engine - doc/network-namespaces.txt for how to use network namespaces under Linux - doc/management.txt for the management guide - doc/regression-testing.txt for how to use the regression testing suite - doc/peers.txt for the peers protocol reference - doc/coding-style.txt for how to adopt HAProxy's coding style - doc/internals for developer-specific documentation (not all up to date)