Peter Simons

simons@computer.org

&purpose;

The distribution contains Makefiles suited for compilation with the GNU C++ compiler. Be adviced, though, that you will need a fairly recent version in order to compile &librfc;, because the library makes use of many features of the ISO C++ standard that are not supported by older versions of g++. Nonetheless, it should be possible to translate &librfc; with other ISO C++ compilers, too; the library does not use any system specific functions with the exception of POSIX regular expressions, but these should be widely available -- at least on Unix platforms. So just take a look at the Makefiles: With only a few modifications you should get along.

Included in the distribution is a small test programm, test.cc, which you can compile by executing make test. When started, this program will read an arbitrary RFC822 address from standard input, then it will parse the address and print the separate addresses. In addition, the program performs a few parsing operations on addresses built into the binary. The program is not intended to serve any useful purpose, but you might want to look at the source code to get an impression of how this library may be used.

The directory documentation contains a complete user's manual for &librfc; -- most notably the files user-manual.html and user-manual.pdf. You should really take a look at them if you plan to use this code. :-)

The latest version of &librfc; is available from http://cryp.to/librfc822/.

&librfc; is copyrighted by Peter Simons <simons@computer.org>. Permission is granted to use this code under the terms described in the LICENSE file.