Annotation of /README

Hello,

libspopc is a thin pop3 client library written in C.
It internally uses sort of blocking sockets (15s timeout).
It exports a high-level API that does not expose
the socket to you, unless you want to use the
low-level API (but don't use both! they may conflict).

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details (COPYING.LIB).

- if you are under windows, import the files into you IDE,
and compile with the wsock32 library as linker options
the archive contains a functionnal dev-cpp project file.
You have to download openssl for win32 for SSL connections.

- if you want to disable SSL support, compile without
the #define USE_SSL and without -lcrypto -lssl in LDFLAGS
(see CFLAGS and LDFLAGS in Makefile)

- if you want to disable thread-safety, compile without
the #define _REENTRANT and without -lrt in LDFLAGS
(see CFLAGS and LDFLAGS in Makefile)

- manuals are in doc/ directory

- under Unices, type "make install" to install libspopc.a
and libsopoc.so in /usr/lib/ plus libspopc.h in /usr/include
(you must be root to do that)

To link your program with libspopc, just add
#include <libspopc.h> before your main function
and compile as:
cc -o program program.c -lspopc

enjoy ! questions/patches ? mail me <brouits@free.fr>

1	ben	1	Hello,
2
3			libspopc is a thin pop3 client library written in C.
4			It internally uses sort of blocking sockets (15s timeout).
5			It exports a high-level API that does not expose
6			the socket to you, unless you want to use the
7			low-level API (but don't use both! they may conflict).
8
9			This library is distributed in the hope that it will be useful,
10			but WITHOUT ANY WARRANTY; without even the implied warranty of
11			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12			Lesser General Public License for more details (COPYING.LIB).
13
14			- if you are under windows, import the files into you IDE,
15	ben	7	and compile with the wsock32 library as linker options
16	ben	11	the archive contains a functionnal dev-cpp project file.
17	ben	12	You have to download openssl for win32 for SSL connections.
18	ben	1
19			- if you want to disable SSL support, compile without
20			the #define USE_SSL and without -lcrypto -lssl in LDFLAGS
21			(see CFLAGS and LDFLAGS in Makefile)
22
23			- if you want to disable thread-safety, compile without
24			the #define _REENTRANT and without -lrt in LDFLAGS
25			(see CFLAGS and LDFLAGS in Makefile)
26
27			- manuals are in doc/ directory
28
29			- under Unices, type "make install" to install libspopc.a
30			and libsopoc.so in /usr/lib/ plus libspopc.h in /usr/include
31			(you must be root to do that)
32
33			To link your program with libspopc, just add
34			#include <libspopc.h> before your main function
35			and compile as:
36			cc -o program program.c -lspopc
37
38			enjoy ! questions/patches ? mail me <brouits@free.fr>
39