From f6a3e42ae7861a0889a41df14360485cabaeabe1 Mon Sep 17 00:00:00 2001 From: Arvid Norberg Date: Fri, 21 Mar 2008 05:59:34 +0000 Subject: [PATCH] added warning about the buggy strip option on Mac OS X to the build docs --- docs/building.html | 8 ++++++++ docs/building.rst | 8 ++++++++ 2 files changed, 16 insertions(+) diff --git a/docs/building.html b/docs/building.html index c4658a270..7f84b5ea9 100644 --- a/docs/building.html +++ b/docs/building.html @@ -166,6 +166,14 @@ as a shared library (DLL), since you will get separate heaps in the library and in the client application. It will result in crashes and possibly link errors.

+
+

Warning

+

With boost-build V2 (Milestone 11), the darwin toolset uses the -s linker +option to strip debug symbols. This option is buggy in Apple's GCC, and +will make the executable crash on startup. On Mac OS X, instead build +your release executables with the debug-symbols=on option, and +later strip your executable with strip.

+

The build targets are put in a directory called bin, and under it they are sorted in directories depending on the toolset and build variant used.

To build the examples, just change directory to the examples directory and diff --git a/docs/building.rst b/docs/building.rst index c5ffd1d23..5a05e8a62 100644 --- a/docs/building.rst +++ b/docs/building.rst @@ -180,6 +180,14 @@ the runtime, but on windows you can do both. Example:: and in the client application. It will result in crashes and possibly link errors. +.. warning:: + + With boost-build V2 (Milestone 11), the darwin toolset uses the ``-s`` linker + option to strip debug symbols. This option is buggy in Apple's GCC, and + will make the executable crash on startup. On Mac OS X, instead build + your release executables with the ``debug-symbols=on`` option, and + later strip your executable with ``strip``. + The build targets are put in a directory called bin, and under it they are sorted in directories depending on the toolset and build variant used.