sb118: added documentation

4 files changed, 8 insertions, 0 deletions

diff --git a/test/inc/test/getargument.hxx b/test/inc/test/getargument.hxx
index 0c109861ccfc..1b4df29d2115 100644
--- a/test/inc/test/getargument.hxx
+++ b/test/inc/test/getargument.hxx
@@ -34,6 +34,8 @@ namespace rtl { class OUString; }
 
 namespace test {
 
+// Obtain the value of an argument tunneled in via an "arg-<name>" bootstrap
+// variable:
 OOO_DLLPUBLIC_TEST bool getArgument(
     rtl::OUString const & name, rtl::OUString * value);
 
diff --git a/test/inc/test/officeconnection.hxx b/test/inc/test/officeconnection.hxx
index 60de9e784921..99a319d51a7e 100644
--- a/test/inc/test/officeconnection.hxx
+++ b/test/inc/test/officeconnection.hxx
@@ -39,6 +39,8 @@ namespace com { namespace sun { namespace star { namespace lang {
 
 namespace test {
 
+// Start up and shut down an OOo instance (details about the OOo instance are
+// tunneled in via "arg-..." bootstrap variables):
 class OOO_DLLPUBLIC_TEST OfficeConnection: private boost::noncopyable {
 public:
     OfficeConnection();
diff --git a/test/inc/test/oustringostreaminserter.hxx b/test/inc/test/oustringostreaminserter.hxx
index 9c9ef527be7c..187b0ebd5f83 100644
--- a/test/inc/test/oustringostreaminserter.hxx
+++ b/test/inc/test/oustringostreaminserter.hxx
@@ -33,6 +33,8 @@
 #include "osl/thread.h"
 #include "rtl/ustring.hxx"
 
+// Include this header to support rtl::OUString in CPPUNIT_ASSERT macros.
+
 template< typename charT, typename traits > std::basic_ostream<charT, traits> &
 operator <<(
     std::basic_ostream<charT, traits> & stream, rtl::OUString const & string)
diff --git a/test/inc/test/toabsolutefileurl.hxx b/test/inc/test/toabsolutefileurl.hxx
index 602dc9d0b435..5828a050fb75 100644
--- a/test/inc/test/toabsolutefileurl.hxx
+++ b/test/inc/test/toabsolutefileurl.hxx
@@ -34,6 +34,8 @@ namespace rtl { class OUString; }
 
 namespace test {
 
+// Convert a pathname in system notation, potentially relative to the process's
+// current working directory, to an absolute file URL:
 OOO_DLLPUBLIC_TEST rtl::OUString toAbsoluteFileUrl(
     rtl::OUString const & relativePathname);