boostorg/regex
1
0
Fork 1
mirror of https://github.com/boostorg/regex.git synced 2025-07-15 21:32:18 +02:00
Code Issues Packages Projects Releases Wiki Activity

Updated installation notes.

Browse Source 
[SVN r26323]
This commit is contained in:
John Maddock
2004-11-27 11:20:37 +00:00
parent e2c97fbb13
commit 9079cc8201
2 changed files with 64 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
doc/Attic/install.html
View File

@ -132,25 +132,24 @@
Microsoft's Compiler:</P> Microsoft's Compiler:</P>
<UL> <UL>
<LI> <LI>
There have been some reports of compiler-optimization bugs affecting this There have been some reports of compiler-optimization bugs affecting this
library, (particularly with VC6 versions prior to service patch 5) the library, (particularly with VC6 versions prior to service patch 5) the
workaround is to build the library using /Oityb1 rather than /O2. That is to workaround is to build the library using /Oityb1 rather than /O2. That is to
use all optimization settings except /Oa. This problem is reported to affect use all optimization settings except /Oa. This problem is reported to affect
some standard library code as well (in fact I'm not sure if the problem is with some standard library code as well (in fact I'm not sure if the problem is with
the regex code or the underlying standard library), so it's probably worthwhile the regex code or the underlying standard library), so it's probably worthwhile
applying this workaround in normal practice in any case.</LI> applying this workaround in normal practice in any case.
<LI> <LI>
If you have replaced the C++ standard library that comes with VC6, then when If you have replaced the C++ standard library that comes with VC6, then when
you build the library you must ensure that the environment variables "INCLUDE" you build the library you must ensure that the environment variables "INCLUDE"
and "LIB" have been updated to reflect the include and library paths for the and "LIB" have been updated to reflect the include and library paths for the
new library - see vcvars32.bat (part of your Visual Studio installation) for new library - see vcvars32.bat (part of your Visual Studio installation) for
more details. more details.
</LI>
<LI> <LI>
If you are building with the full STLPort v4.x, then use the vc6-stlport.mak If you are building with the full STLPort v4.x, then use the vc6-stlport.mak
file provided and set the environment variable STLPORT_PATH to point to the file provided and set the environment variable STLPORT_PATH to point to the
location of your STLPort installation (Note that the full STLPort libraries location of your STLPort installation (Note that the full STLPort libraries
appear not to support single-thread static builds).</LI> appear not to support single-thread static builds).
<LI> <LI>
If you are building your application with /Zc:wchar_t then you will need to If you are building your application with /Zc:wchar_t then you will need to
modify the makefile to add /Zc:wchar_t before building the library. modify the makefile to add /Zc:wchar_t before building the library.
@ -158,22 +157,23 @@
</UL> </UL>
<P><B><A name="gcc"></A>GCC(2.95 and 3.x)</B> <P><B><A name="gcc"></A>GCC(2.95 and 3.x)</B>
</P> </P>
<P>You can build with gcc using the normal boost Jamfile in <P>The best way to&nbsp;build with gcc is using the <A href="../../../more/getting_started.html">
&lt;boost&gt;/libs/regex/build, alternatively there is a conservative makefile normal boost Jamfile in &lt;boost&gt;/libs/regex/build</A>, alternatively
for the g++ compiler. From the command prompt change to the there is a conservative makefile for the g++ compiler. From the command prompt
&lt;boost&gt;/libs/regex/build directory and type: change to the &lt;boost&gt;/libs/regex/build directory and type:
</P> </P>
<PRE>make -fgcc.mak </PRE> <PRE>make -fgcc.mak </PRE>
<P>At the end of the build process you should have a gcc sub-directory containing <P>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 release and debug versions of the library (libboost_regex-gcc-1_32.a and
libboost_regex_debug.a). When you build projects that use regex++, you will libboost_regex-gcc-d-1_32.a). When you build projects that use regex++, you
need to add the boost install directory to your list of include paths and add will need to add the boost install directory to your list of include paths and
&lt;boost&gt;/libs/regex/build/gcc/libboost_regex.a to your list of library add &lt;boost&gt;/libs/regex/build/gcc/libboost_regex-gcc-1_32.a to your list
files. of library files.
</P> </P>
<P>There is also a makefile to build the library as a shared library:</P> <P>There is also a makefile to build the library as a shared library:</P>
<PRE>make -fgcc-shared.mak</PRE> <PRE>make -fgcc-shared.mak</PRE>
<P>which will build libboost_regex.so and libboost_regex_debug.so.</P> <P>which will build&nbsp;libboost_regex-gcc-1_32.so and
libboost_regex-gcc-d-1_32.so.</P>
<P>Both of the these makefiles support the following environment variables:</P> <P>Both of the these makefiles support the following environment variables:</P>
<P>CXXFLAGS: extra compiler options - note that this applies to both the debug and <P>CXXFLAGS: extra compiler options - note that this applies to both the debug and
release builds.</P> release builds.</P>
@ -181,8 +181,8 @@
<P>LDFLAGS: additional linker options.</P> <P>LDFLAGS: additional linker options.</P>
<P>LIBS: additional library files.</P> <P>LIBS: additional library files.</P>
<P>For the more adventurous there is a configure script in <P>For the more adventurous there is a configure script in
&lt;boost&gt;/libs/config; see the <A href="../../config/config.htm">config library &lt;boost&gt;/libs/config; see the <A href="../../config/config.htm">config
documentation</A>.</P> library documentation</A>.</P>
<P><B><A name="sun"></A>Sun Workshop 6.1</B></P> <P><B><A name="sun"></A>Sun Workshop 6.1</B></P>
<P>There is a makefile for the sun (6.1) compiler (C++ version 3.12). From the <P>There is a makefile for the sun (6.1) compiler (C++ version 3.12). From the
command prompt change to the &lt;boost&gt;/libs/regex/build directory and type: command prompt change to the &lt;boost&gt;/libs/regex/build directory and type:
@ -212,8 +212,8 @@
) provided in &lt;boost-root&gt;/libs/regex/build - see that makefile for ) provided in &lt;boost-root&gt;/libs/regex/build - see that makefile for
details of environment variables that need to be set before use. details of environment variables that need to be set before use.
<P> <P>
Alternatively you can using the <A href="../../../tools/build/index.html">Jam based Alternatively you can using the <A href="../../../more/getting_started.html">Jam
build system</A>: cd into &lt;boost&gt;/libs/regex/build and run:<PRE>bjam -sTOOLS=mytoolset</PRE> based build system</A>: cd into &lt;boost&gt;/libs/regex/build and run:<PRE>bjam -sTOOLS=mytoolset</PRE>
<P> <P>
If you need to configure the library for your platform, then refer to the <A href="../../config/config.htm"> If you need to configure the library for your platform, then refer to the <A href="../../config/config.htm">
config library documentation</A> config library documentation</A>
@ -226,8 +226,7 @@
24 Oct 2003 24 Oct 2003
<!--webbot bot="Timestamp" endspan i-checksum="39359" --></p> <!--webbot bot="Timestamp" endspan i-checksum="39359" --></p>
<p><i><EFBFBD> Copyright John Maddock&nbsp;1998- <p><i><EFBFBD> Copyright John Maddock&nbsp;1998-
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan --> <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan --> 2003<!--webbot bot="Timestamp" endspan i-checksum="39359" --></i></p>
2003<!--webbot bot="Timestamp" endspan i-checksum="39359" --></i></p>
<P><I>Use, modification and distribution are subject to the Boost Software License, <P><I>Use, modification and distribution are subject to the Boost Software License,
Version 1.0. (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> Version 1.0. (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A>
or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)</I></P> or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)</I></P>

65
doc/install.html
View File

@ -132,25 +132,24 @@
Microsoft's Compiler:</P> Microsoft's Compiler:</P>
<UL> <UL>
<LI> <LI>
There have been some reports of compiler-optimization bugs affecting this There have been some reports of compiler-optimization bugs affecting this
library, (particularly with VC6 versions prior to service patch 5) the library, (particularly with VC6 versions prior to service patch 5) the
workaround is to build the library using /Oityb1 rather than /O2. That is to workaround is to build the library using /Oityb1 rather than /O2. That is to
use all optimization settings except /Oa. This problem is reported to affect use all optimization settings except /Oa. This problem is reported to affect
some standard library code as well (in fact I'm not sure if the problem is with some standard library code as well (in fact I'm not sure if the problem is with
the regex code or the underlying standard library), so it's probably worthwhile the regex code or the underlying standard library), so it's probably worthwhile
applying this workaround in normal practice in any case.</LI> applying this workaround in normal practice in any case.
<LI> <LI>
If you have replaced the C++ standard library that comes with VC6, then when If you have replaced the C++ standard library that comes with VC6, then when
you build the library you must ensure that the environment variables "INCLUDE" you build the library you must ensure that the environment variables "INCLUDE"
and "LIB" have been updated to reflect the include and library paths for the and "LIB" have been updated to reflect the include and library paths for the
new library - see vcvars32.bat (part of your Visual Studio installation) for new library - see vcvars32.bat (part of your Visual Studio installation) for
more details. more details.
</LI>
<LI> <LI>
If you are building with the full STLPort v4.x, then use the vc6-stlport.mak If you are building with the full STLPort v4.x, then use the vc6-stlport.mak
file provided and set the environment variable STLPORT_PATH to point to the file provided and set the environment variable STLPORT_PATH to point to the
location of your STLPort installation (Note that the full STLPort libraries location of your STLPort installation (Note that the full STLPort libraries
appear not to support single-thread static builds).</LI> appear not to support single-thread static builds).
<LI> <LI>
If you are building your application with /Zc:wchar_t then you will need to If you are building your application with /Zc:wchar_t then you will need to
modify the makefile to add /Zc:wchar_t before building the library. modify the makefile to add /Zc:wchar_t before building the library.
@ -158,22 +157,23 @@
</UL> </UL>
<P><B><A name="gcc"></A>GCC(2.95 and 3.x)</B> <P><B><A name="gcc"></A>GCC(2.95 and 3.x)</B>
</P> </P>
<P>You can build with gcc using the normal boost Jamfile in <P>The best way to&nbsp;build with gcc is using the <A href="../../../more/getting_started.html">
&lt;boost&gt;/libs/regex/build, alternatively there is a conservative makefile normal boost Jamfile in &lt;boost&gt;/libs/regex/build</A>, alternatively
for the g++ compiler. From the command prompt change to the there is a conservative makefile for the g++ compiler. From the command prompt
&lt;boost&gt;/libs/regex/build directory and type: change to the &lt;boost&gt;/libs/regex/build directory and type:
</P> </P>
<PRE>make -fgcc.mak </PRE> <PRE>make -fgcc.mak </PRE>
<P>At the end of the build process you should have a gcc sub-directory containing <P>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 release and debug versions of the library (libboost_regex-gcc-1_32.a and
libboost_regex_debug.a). When you build projects that use regex++, you will libboost_regex-gcc-d-1_32.a). When you build projects that use regex++, you
need to add the boost install directory to your list of include paths and add will need to add the boost install directory to your list of include paths and
&lt;boost&gt;/libs/regex/build/gcc/libboost_regex.a to your list of library add &lt;boost&gt;/libs/regex/build/gcc/libboost_regex-gcc-1_32.a to your list
files. of library files.
</P> </P>
<P>There is also a makefile to build the library as a shared library:</P> <P>There is also a makefile to build the library as a shared library:</P>
<PRE>make -fgcc-shared.mak</PRE> <PRE>make -fgcc-shared.mak</PRE>
<P>which will build libboost_regex.so and libboost_regex_debug.so.</P> <P>which will build&nbsp;libboost_regex-gcc-1_32.so and
libboost_regex-gcc-d-1_32.so.</P>
<P>Both of the these makefiles support the following environment variables:</P> <P>Both of the these makefiles support the following environment variables:</P>
<P>CXXFLAGS: extra compiler options - note that this applies to both the debug and <P>CXXFLAGS: extra compiler options - note that this applies to both the debug and
release builds.</P> release builds.</P>
@ -181,8 +181,8 @@
<P>LDFLAGS: additional linker options.</P> <P>LDFLAGS: additional linker options.</P>
<P>LIBS: additional library files.</P> <P>LIBS: additional library files.</P>
<P>For the more adventurous there is a configure script in <P>For the more adventurous there is a configure script in
&lt;boost&gt;/libs/config; see the <A href="../../config/config.htm">config library &lt;boost&gt;/libs/config; see the <A href="../../config/config.htm">config
documentation</A>.</P> library documentation</A>.</P>
<P><B><A name="sun"></A>Sun Workshop 6.1</B></P> <P><B><A name="sun"></A>Sun Workshop 6.1</B></P>
<P>There is a makefile for the sun (6.1) compiler (C++ version 3.12). From the <P>There is a makefile for the sun (6.1) compiler (C++ version 3.12). From the
command prompt change to the &lt;boost&gt;/libs/regex/build directory and type: command prompt change to the &lt;boost&gt;/libs/regex/build directory and type:
@ -212,8 +212,8 @@
) provided in &lt;boost-root&gt;/libs/regex/build - see that makefile for ) provided in &lt;boost-root&gt;/libs/regex/build - see that makefile for
details of environment variables that need to be set before use. details of environment variables that need to be set before use.
<P> <P>
Alternatively you can using the <A href="../../../tools/build/index.html">Jam based Alternatively you can using the <A href="../../../more/getting_started.html">Jam
build system</A>: cd into &lt;boost&gt;/libs/regex/build and run:<PRE>bjam -sTOOLS=mytoolset</PRE> based build system</A>: cd into &lt;boost&gt;/libs/regex/build and run:<PRE>bjam -sTOOLS=mytoolset</PRE>
<P> <P>
If you need to configure the library for your platform, then refer to the <A href="../../config/config.htm"> If you need to configure the library for your platform, then refer to the <A href="../../config/config.htm">
config library documentation</A> config library documentation</A>
@ -226,8 +226,7 @@
24 Oct 2003 24 Oct 2003
<!--webbot bot="Timestamp" endspan i-checksum="39359" --></p> <!--webbot bot="Timestamp" endspan i-checksum="39359" --></p>
<p><i><EFBFBD> Copyright John Maddock&nbsp;1998- <p><i><EFBFBD> Copyright John Maddock&nbsp;1998-
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan --> <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan --> 2003<!--webbot bot="Timestamp" endspan i-checksum="39359" --></i></p>
2003<!--webbot bot="Timestamp" endspan i-checksum="39359" --></i></p>
<P><I>Use, modification and distribution are subject to the Boost Software License, <P><I>Use, modification and distribution are subject to the Boost Software License,
Version 1.0. (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> Version 1.0. (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A>
or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)</I></P> or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)</I></P>