.. _installing:

Installation guide
==================

libtio is either built as a static or shared library, and is made to be
interfaced with C programs. The method of installing or building depends on
the system you're using: pick the one that fits yours!

POSIX systems (manual build)
----------------------------

To configure, use ``./configure <options>``. Options are used as
``--<name>=<value>``. The following are some build options:

``--target=<target>``
	The target for which to produce the library (by default, native).

``--static``
	Produce a static library (by default, shared).

``--windows``
	Use the Windows versions of the final formats (dll instead of elf,
	lib instead of coff).

``--no-libusb``
	Do not use (and link against) libusb.

``--no-file``
	Do not use the standard I/O library (probably because there aren't any).

``--no-log``, ``--loglevel=<level>``:
	If we should include debugging content (but keep the interface), and if
	yes, what the default library log level. See :ref:`logging` for more
	information.

``--maintainer``
	Alias for ``--loglevel=info``, also introduces more compilation warnings.

Other options are packaging options (todo: add more info about them here).