Initial commit

2017-04-11 15:49:21 +02:00
commit ec80b339e2
2081 changed files with 968992 additions and 0 deletions
@@ -0,0 +1,81 @@
+Building on UNIX
+================
+
+The following build instructions are for the Linux/UNIX/Mac OS X
+operating systems as well as for Cygwin and MinGW on Windows.
+
+The standard autotools-based build system is used on these platforms. After
+unpacking the source code archive, change to the libodb package directory
+(referred to as libodb/ from now on) and run the configure script:
+
+./configure
+
+To see the available configuration options run configure with --help:
+
+./configure --help
+
+As an example, the following configure command only builds shared libraries,
+uses the specified C++ compiler, and compiles with optimization and without
+debug information:
+
+./configure --disable-static CXX=g++-4.5 CXXFLAGS=-O3
+
+Once configuration is complete, run make to build libodb:
+
+make
+
+Once the build is completed successfully, you can install the libodb headers
+and libraries using the install target (you may need to do this step as root
+depending on the installation directory):
+
+make install
+
+
+Building on Windows
+===================
+
+The following build instructions are for Windows using Microsoft Visual
+Studio. If you would like to build libodb with GCC either using Cygwin
+or MinGW, refer to the "Building on UNIX" section above.
+
+The standard Visual Studio project and solution files are used on this
+platform. To build libodb, unpack the source code archive and open the
+libodb-vc<N>.sln file located in the libodb package directory (referred
+to as libodb\ from now on). Here <N> is the version of Visual Studio that
+you are using. Once the solution is open, select the desired build
+configuration (Debug or Release) and platform (Win32 or x64) and build
+the solution.
+
+The resulting 32-bit DLLs and import libraries are placed into the
+libodb\bin\ and libodb\lib\ directories, respectively. Similarly, the
+64-bit DLLs and import libraries are placed into libodb\bin64\ and
+libodb\lib64\. The Release versions of the import libraries are named
+odb.lib and the Debug versions are named odb-d.lib.
+
+To configure Visual Studio to automatically locate the libodb headers,
+DLLs, and import libraries, add the following paths to your VC++
+Directories:
+
+Win32:
+
+  Include:    ...\libodb
+  Library:    ...\libodb\lib
+  Executable: ...\libodb\bin
+
+x64:
+
+  Include:    ...\libodb
+  Library:    ...\libodb\lib64
+  Executable: ...\libodb\bin64
+
+Note also that by default libodb uses the __declspec(thread) storage-class
+modifier for TLS support. This mechanism is known not to work correctly on
+Windows XP/Server 2003 and earlier versions of Windows if a DLL that uses
+this modifier is loaded dynamically. If you are planning to link libodb to a
+DLL that will be loaded dynamically (e.g., delay loading, COM DLL, explicit
+LoadLibrary() call, etc), then you will need to comment out the definition
+of the ODB_THREADS_TLS_DECLSPEC macro in the odb\details\config-vc.h file
+prior to building libodb. On the other hand, if you plan to link libodb
+directly to an executable or another DLL that will be linked directly to
+an executable or if you only need to support Windows Vista/Server 2008,
+then you don't need to make this change.