1Developer Notes 2=============== 3 4* The distributed `ares_build.h` in the official release tarballs is only 5 intended to be used on systems which can also not run the also distributed 6 `configure` or `CMake` scripts. It is generated as a copy of 7 `ares_build.h.dist` as can be seen in the code repository. 8 9* If you check out from git on a non-`configure` or `CMake` platform, you must run 10 the appropriate `buildconf*` script to set up `ares_build.h` and other local 11 files before being able to compile the library. There are pre-made makefiles 12 for a subset of such systems such as Watcom, NMake, and MinGW Makefiles. 13 14* On systems capable of running the `configure` or `CMake` scripts, the process 15 will overwrite the distributed `ares_build.h` file with one that is suitable 16 and specific to the library being configured and built, this new file is 17 generated from the `ares_build.h.in` and `ares_build.h.cmake` template files. 18 19* If you intend to distribute an already compiled c-ares library you **MUST** 20 also distribute along with it the generated `ares_build.h` which has been 21 used to compile it. Otherwise, the library will be of no use for the users of 22 the library that you have built. It is **your** responsibility to provide this 23 file. No one at the c-ares project can know how you have built the library. 24 The generated file includes platform and configuration dependent info, 25 and must not be modified by anyone. 26 27* We support both the AutoTools `configure` based build system as well as the 28 `CMake` build system. Any new code changes must work with both. 29 30* The files that get compiled and are present in the distribution are referenced 31 in the `Makefile.inc` in the current directory. This file gets included in 32 every build system supported by c-ares so that the list of files doesn't need 33 to be maintained per build system. Don't forget to reference new header files 34 otherwise they won't be included in the official release tarballs. 35 36* We cannot assume anything else but very basic C89 compiler features being 37 present. The lone exception is the requirement for 64bit integers which is 38 not a requirement for C89 compilers to support. Please do not use any extended 39 features released by later standards. 40 41* Newlines must remain unix-style for older compilers' sake. 42 43* Comments must be written in the old-style `/* unnested C-fashion */` 44 45* Try to keep line lengths below 80 columns and formatted as the existing code. 46 There is a `.clang-format` in the repository that can be used to run the 47 automated code formatter as such: `clang-format -i */*.c */*.h */*/*.c */*/*.h` 48