libstrophe Documentation

To build and install libstrophe from a source control checkout, follow these steps:

1. Generate the configure script:

   ./bootstrap.sh

2. Configure and build the library:

   ./configure
   make

3. Install the library to your system (requires root/sudo):

   make install

By default, the library installs to /usr/local/. To specify a different installation directory, use the --prefix option during the configuration step.

To compile example files (such as bot.c) that use libstrophe, use gcc along with pkg-config to automatically include the necessary compiler flags and library links. This ensures that the correct include paths and library dependencies for libstrophe are provided to the compiler.

gcc -o bot bot.c `pkg-config --cflags --libs libstrophe`

The API documentation is written in Doxygen format. You can generate a local HTML version of the documentation using one of the following methods:

1. Run doxygen directly.
2. Run make docs (if your environment is configured correctly).

Once generated, open the documentation at docs/html/index.html.

To build the library for Android, run the provided build script and follow the on-screen instructions.

Requirements:

• expat sources
• android-ndk

./build-android.sh

To create a code coverage report, you must have gcov and lcov installed. Run the following commands:

./configure --enable-coverage
make coverage

The resulting report can be found at ./coverage/index.html.

libstrophe has several configurable dependencies. Use the following flags with ./configure to select your preferred implementations:

XML Parsers

• expat: The default parser.
• libxml2: Use --with-libxml2 to switch to libxml2.

TLS/SSL Providers (UNIX systems)

• openssl: The default provider.
• GnuTLS: Use --with-gnutls to switch to GnuTLS.