7
7
Include files for libcurl, external users.
9
9
They're all placed in the curl subdirectory here for better fit in any kind
10
of environment. You should include files from here using...
10
of environment. You must include files from here using...
12
12
#include <curl/curl.h>
17
17
NOTE FOR LIBCURL HACKERS
19
All the include files in this tree are written and intended to be installed on
20
a system that may serve multiple platforms and multiple applications, all
21
using libcurl (possibly even different libcurl installations using different
22
versions). Therefore, all header files in here must obey these rules:
24
* They cannot depend on or use configure-generated results from libcurl's or
25
curl's directories. Other applications may not run configure as (lib)curl
26
does, and using platform dependent info here may break other platforms.
19
The following notes apply to libcurl version 7.19.0 and later.
21
* The distributed curl/curlbuild.h file is only intended to be used on systems
22
which can not run the also distributed configure script.
24
* The distributed curlbuild.h file is generated as a copy of curlbuild.h.dist
25
when the libcurl source code distribution archive file is originally created.
27
* If you check out from CVS on a non-configure platform, you must run the
28
appropriate buildconf* script to set up curlbuild.h and other local files
29
before being able of compiling the library.
31
* On systems capable of running the configure script, the configure process
32
will overwrite the distributed include/curl/curlbuild.h file with one that
33
is suitable and specific to the library being configured and built, which
34
is generated from the include/curl/curlbuild.h.in template file.
36
* If you intend to distribute an already compiled libcurl library you _MUST_
37
also distribute along with it the generated curl/curlbuild.h which has been
38
used to compile it. Otherwise the library will be of no use for the users of
39
the library that you have built. It is _your_ responsability to provide this
40
file. No one at the cURL project can know how you have built the library.
42
* File curl/curlbuild.h includes platform and configuration dependant info,
43
and must not be modified by anyone. Configure script generates it for you.
28
45
* We cannot assume anything else but very basic compiler features being
29
46
present. While libcurl requires an ANSI C compiler to build, some of the