1                                  _   _ ____  _
2                              ___| | | |  _ \| |
3                             / __| | | | |_) | |
4                            | (__| |_| |  _ <| |___
5                             \___|\___/|_| \_\_____|
6
7This directory is for libcurl programming examples. They are meant to show
8some simple steps on how you can build your own application to take full
9advantage of libcurl.
10
11If you end up with other small but still useful example sources, please mail
12them for submission in future packages and on the web site.
13
14BUILDING
15
16The Makefile.example is an example makefile that could be used to build these
17examples. Just edit the file according to your system and requirements first.
18
19Most examples should build fine using a command line like this:
20
21  $ `curl-config --cc --cflags --libs` -o example example.c
22
23Some compilers don't like having the arguments in this order but instead
24want you do reorganize them like:
25
26  $ `curl-config --cc` -o example example.c `curl-config --cflags --libs`
27
28*PLEASE* do not use the curl.haxx.se site as a test target for your libcurl
29applications/experiments. Even if some of the examples use that site as a URL
30at some places, it doesn't mean that the URLs work or that we expect you to
31actually torture our web site with your tests!  Thanks.
32
33EXAMPLES
34
35Each example source code file is designed to be and work stand-alone and
36rather self-explanatory. The examples may at times lack the level of error
37checks you need in a real world, but that is then only for the sake of
38readability: to make the code smaller and easier to follow.
39