+2008-08-24 Paolo Carlini <paolo.carlini@oracle.com>
+
+ * acinclude.m4 ([GLIBCXX_ENABLE_CLOCK_GETTIME]): Improve documentation.
+ * doc/xml/manual/configure.xml: Likewise.
+
2008-08-23 Paolo Carlini <paolo.carlini@oracle.com>
* acinclude.m4 ([GLIBCXX_ENABLE_CLOCK_GETTIME]): Use [=KIND] in
dnl
dnl --enable-clock-gettime
dnl --enable-clock-gettime=yes
-dnl checks for the availability of monotonic or realtime clocks
-dnl in libc and libposix4
+dnl checks for the availability of monotonic and realtime clocks
+dnl in libc and libposix4 and in case links the latter
dnl --enable-clock-gettime=rt
-dnl searches librt too, and in case of success enables its linking
-dnl to libstdc++ as part of the build process. Note that this is
+dnl also searches (and, in case, links) librt. Note that this is
dnl not always desirable because, in glibc, for example, in turn it
-dnl triggers automatically the linking of libpthread too, which
-dnl activates locking, a large overhead for single-thread programs.
+dnl triggers the linking of libpthread too, which activates locking,
+dnl a large overhead for single-thread programs.
dnl --enable-clock-gettime=no
dnl --disable-clock-gettime
dnl disables the checks completely
</listitem></varlistentry>
<varlistentry><term><code>--enable-clock-gettime=OPTION</code></term>
- <listitem><para>Enables checks (link-type too) for the clock_gettime clocks,
- used in the implementation [time.clock] in the current C++0x draft.
+ <listitem><para>Enables link-type checks for the availability of the
+ clock_gettime clocks, used in [time.clock] of the current C++0x draft.
The choice OPTION=yes checks for the availability of the monotonic and
- realtime clocks in libc and libposix4. OPTION=rt searches librt too,
- and in case of success enables its linking to libstdc++ as part of the
- build process. Note that this is not always desirable because, in
- glibc, for example, in turn it triggers automatically the linking of
- libpthread too, which activates locking, a large overhead for
- single-thread programs. OPTION=no skips the tests completely. The
- default is OPTION=no.
+ realtime clocks in libc and libposix4. In case of need the latter is
+ also linked to libstdc++ as part of the build process. OPTION=rt
+ also searches (and, in case, links) librt. Note that the latter
+ is not always desirable because, in glibc, for example, in turn it
+ triggers the linking of libpthread too, which activates locking,
+ a large overhead for single-thread programs. OPTION=no skips the
+ tests completely. The default is OPTION=no.
</para>
</listitem></varlistentry>