trunk/branch integration: documentation

Foundation/include/Poco/Stopwatch.h

@@ -50,6 +50,11 @@ namespace Poco {
 class Foundation_API Stopwatch
 	/// A simple facility to measure time intervals
 	/// with microsecond resolution.
+	///
+	/// Note that Stopwatch is based on the Timestamp
+	/// class. Therefore, if during a Stopwatch run,
+	/// the system time is changed, the measured time
+	/// will not be correct.
 {
 public:
 	Stopwatch();