diff --git a/docs/building.html b/docs/building.html index 3defa3621..f17bcb223 100644 --- a/docs/building.html +++ b/docs/building.html @@ -3,7 +3,7 @@ - + libtorrent manual @@ -64,6 +64,20 @@ You'll find instructions on how to do this #libtorrent IRC channel on irc.freenode.net.

Community contributed build tutorials can be found on the wiki.

+
+

Warning

+

A common mistake when building and linking against libtorrent is +to build with one set of configuration options (#defines) and +link against it using a different set of configuration options. Since +libtorrent has some code in header files, that code will not be +compatible with the built library if they see different configurations.

+

Always make sure that the same TORRENT_* macros are defined when you +link against libtorrent as when you build it.

+

Boost-build supports propagating configuration options to dependencies. +When building using the makefiles, this is handled by setting the +configuration options in the pkg-config file. Always use pkg-config +when linking against libtorrent.

+

building from svn

To build libtorrent from svn you need to check out the libtorrent sources from