acinclude.m4 ([GLIBCXX_ENABLE_CLOCK_GETTIME]): Improve documentation.

2008-08-24  Paolo Carlini  <paolo.carlini@oracle.com>

	* acinclude.m4 ([GLIBCXX_ENABLE_CLOCK_GETTIME]): Improve documentation.
	* doc/xml/manual/configure.xml: Likewise.

From-SVN: r139533

libstdc++-v3/ChangeLog

+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

libstdc++-v3/acinclude.m4

@@ -1079,14 +1079,13 @@ dnl [time.clock] in the current C++0x working draft.
 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

libstdc++-v3/doc/xml/manual/configure.xml

@@ -320,16 +320,16 @@
  </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>