@@ -60,7 +60,7 @@
@@ -159,272 +159,43 @@
<boost>\libs\regex\build directory.
- make -fbcb5.mak-
- The build process will build a variety of .lib and .dll files (the exact number - depends upon the version of Borland's tools you are using) the .lib and dll - files will be in a sub-directory called bcb4 or bcb5 depending upon the makefile - used. To install the libraries into your development system use: -
-make -fbcb5.mak install-
- library files will be copied to <BCROOT>/lib and the dll's to <BCROOT>/bin, where <BCROOT>
- corresponds to the install path of your Borland C++ tools.
-
- You may also remove temporary files created during the build process (excluding - lib and dll files) by using: -
-make -fbcb5.mak clean-
- Finally when you use Boost.Regex it is only necessary for you to add the <boost> root director to your list of include directories
- for that project. It is not necessary for you to manually add a .lib file to
- the project; the headers will automatically select the correct .lib file for
- your build mode and tell the linker to include it. There is one caveat however:
- the library can not tell the difference between VCL and non-VCL enabled builds
- when building a GUI application from the command line, if you build from the
- command line with the 5.5 command line tools then you must define the pre-processor
- symbol _NO_VCL in order to ensure that the correct link libraries are selected:
- the C++ Builder IDE normally sets this automatically. Hint, users of the 5.5
- command line tools may want to add a -D_NO_VCL to bcc32.cfg in order to set
- this option permanently.
-
- If you would prefer to do a dynamic link to the regex libraries when using - the dll runtime then define BOOST_REGEX_DYN_LINK (you must do this if you want - to use Boost.Regex in multiple dll's), otherwise Boost.Regex will be statically - linked by default. -
-- If you want to suppress automatic linking altogether (and supply your own custom - build of the lib) then define BOOST_REGEX_NO_LIB. -
-
- If you are building with C++ Builder 6, you will find that <boost/regex.hpp>
- can not be used in a pre-compiled header (the actual problem is in <locale> which gets included by <boost/regex.hpp>),
- if this causes problems for you, then try defining BOOST_NO_STD_LOCALE when
- building, this will disable some features throughout boost, but may save you
- a lot in compile times!
-
- You need version 6 or later of MSVC to build this library. If you are using - VC5 then you may want to look at one of the previous releases of this library. -
- Open up a command prompt, which has the necessary MSVC environment variables
- defined (for example by using the batch file Vcvars32.bat installed by the
- Visual Studio installation), and change to the <boost>\libs\regex\build directory.
+ The Regex library is "just a bunch of source files": nothing special
+ is required to build them.
- Select the correct makefile - vc6.mak for "vanilla" Visual C++ 6 - or vc6-stlport.mak if you are using STLPort. + You can either build the files under boost-path/libs/regex/src/*.cpp as a library, + or add them directly to your project. This is particularly useful if you need + to use specific compiler options not supported by the default Boost build.
- Invoke the makefile like this: + There are two #defines you should be aware of:
-nmake -fvc6.mak-
- You will now have a collection of lib and dll files in a "vc6" subdirectory, - to install these into your development system use: -
-nmake -fvc6.mak install-
- The lib files will be copied to your <VC6>\lib directory and the dll files to <VC6>\bin, where <VC6> is
- the root of your Visual C++ 6 installation.
-
- You can delete all the temporary files created during the build (excluding - lib and dll files) using: -
-nmake -fvc6.mak clean-
- If you want to build with ICU support, then you need to pass the path to your - ICU directory to the makefile, for example with: -
-nmake ICU_PATH=c:\open-source\icu -fvc71.mak install-
- Finally when you use Boost.Regex it is only necessary for you to add the <boost> root directory to your list of include
- directories for that project. It is not necessary for you to manually add a
- .lib file to the project; the headers will automatically select the correct
- .lib file for your build mode and tell the linker to include it.
-
- Note that if you want to dynamically link to the regex library when using the - dynamic C++ runtime, define BOOST_REGEX_DYN_LINK when building your project. -
-- If you want to add the source directly to your project then define BOOST_REGEX_NO_LIB - to disable automatic library selection. -
-- There are several important caveats to remember when using Boost.Regex with - Microsoft's Compiler: -
-
- You can build with gcc using the normal boost Jamfile in <boost>/libs/regex/build, alternatively
- there is a conservative makefile for the g++ compiler. From the command prompt
- change to the <boost>/libs/regex/build directory and type:
-
make -fgcc.mak-
- At the end of the build process you should have a gcc sub-directory containing - release and debug versions of the library (libboost_regex.a and libboost_regex_debug.a). - When you build projects that use regex++, you will need to add the boost install - directory to your list of include paths and add <boost>/libs/regex/build/gcc/libboost_regex.a - to your list of library files. -
-- There is also a makefile to build the library as a shared library: -
-make -fgcc-shared.mak-
- which will build libboost_regex.so and libboost_regex_debug.so. -
-- Both of the these makefiles support the following environment variables: -
-- ICU_PATH: tells the makefile to build with Unicode support, set to the path - where your ICU installation is located, for example with: make ICU_PATH=/usr/local - install -fgcc.mak -
-- CXXFLAGS: extra compiler options - note that this applies to both the debug - and release builds. -
-- INCLUDES: additional include directories. -
-- LDFLAGS: additional linker options. -
-- LIBS: additional library files. -
-
- For the more adventurous there is a configure script in <boost>/libs/config;
- see the config library documentation.
-
- There is a makefile for the sun (6.1) compiler (C++ version 3.12). From the
- command prompt change to the <boost>/libs/regex/build directory
- and type:
-
dmake -f sunpro.mak-
- At the end of the build process you should have a sunpro sub-directory containing
- single and multithread versions of the library (libboost_regex.a, libboost_regex.so,
- libboost_regex_mt.a and libboost_regex_mt.so). When you build projects that
- use Boost.Regex, you will need to add the boost install directory to your list
- of include paths and add <boost>/libs/regex/build/sunpro/ to
- your library search path.
-
- Both of the these makefiles support the following environment variables: -
-- CXXFLAGS: extra compiler options - note that this applies to both the single - and multithreaded builds. -
-- INCLUDES: additional include directories. -
-- LDFLAGS: additional linker options. -
-- LIBS: additional library files. -
-- LIBSUFFIX: a suffix to mangle the library name with (defaults to nothing). -
-- This makefile does not set any architecture specific options like -xarch=v9, - you can set these by defining the appropriate macros, for example: -
-dmake CXXFLAGS="-xarch=v9" LDFLAGS="-xarch=v9" LIBSUFFIX="_v9" -f sunpro.mak-
- will build v9 variants of the regex library named libboost_regex_v9.a etc. -
-
- There is a generic makefile (generic.mak ) provided in <boost-root>/libs/regex/build - see that makefile for details of
- environment variables that need to be set before use.
-
![[Important]](../../../../../doc/src/images/important.png) |
+Important | +
|---|---|
+ The makefiles that were supplied with Boost.Regex are now deprecated and + will be removed in the next release. + |
| - |