mirror of
https://git.haproxy.org/git/haproxy.git/
synced 2026-02-10 03:41:24 +01:00
d499127148
__attribute__((deprecated)) is convenient to discourage from using something deprecated, but gcc >= 4.3 provides __attribute__((warning(x))) that allows to display a specific warning if something is used. This is particularly convenient to give indications when some API parts need to be adapted. Let's just define it as a macro that falls back to the older deprecated attribute when not available. It's supported on clang 14 as well but works differently and errors out when redefined (while the main purpose precisely is to add such a redefinition). Thus instead on clang we use deprecated(msg) which is OK. See https://github.com/llvm/llvm-project/issues/56519
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)