Changeset 53 for php

Timestamp:

Jul 17, 2011, 2:56:35 PM (14 years ago)

Author:

cla

Message:

rdfint

• reworked text on RDF Testcases

File:

• php/trunk/doxygen/doc_page_option_unittest.php (modified) (2 diffs)

php/trunk/doxygen/doc_page_option_unittest.php

@@ -31 +31 @@
  * Under Windows operating systems,
  * \htmllinkext{http://ftp.gnu.org/gnu/make/,GNU make} needs to be installed on your system.
- * Just place \c make.exe into a diectory specified in your \c PATH environment variable.
+ * Just place \c make.exe into a directory specified in your \c PATH environment variable.
  *
  * The unittest \c rdfa_parse_sparql requires a locally installed \c SPARQL \c endpoint.
  * You may want to use the open source edition of \c Virtuoso for this. \n
  * Download from: \htmllinkext{http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VOSDownload} \n
- *
- * For usage under Windows operating systems, install as described at:
- * \htmllinkext{http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VOSUsageWindows}
+ * For usage under Windows operating systems, install \c Virtuoso as described at:
+ * \htmllinkext{http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VOSUsageWindows} \n
+ * and launch the test instcance.
  *
  * <!-- ========================================================================== -->
  * <hr>
  *
- * \section sec_unittest_lib Library specific unittests
+ * \section sec_unittest_all Implementation of unittests
  *
+ * The unittests are provided in subdirectories below the \c unittest directory,
+ * where the name of the subdirectory represents the name of the testcase. An exception
+ * to this rule are \c RDF \c Testcases, they are implemented by a testcase in a single subdirectory.
  *
- * Library specific unittests are provided in a subdirectory below the \c unittest directory.
- * The testcase is implemented in the file \c unittest.php
+ * The testcase is implemented in the file \c unittest.php within the tescase subdirectory.
  *
- * \section sec_unittest_w3c RDF Testcases specific unittests
+ * Execute \code make list \endcode in the \c unittest directory to determine the available
+ * testcases.
  *
- * \c RDF \c Testcases specific unittests are executed by a single testcase in the subdirectory
- * \c rdftestcases below the \c unittest directory.
+ * \subsection sec_unittest_all_lib Library specific unittests
  *
- * The generic testcase routine is implemented in the file \c unittest.php, the name of the testcase
- * has to be provided by the environment variable \c TESTCASE.
+ * Library specific unittests are each provided in a subdirectory below the \c unittest directory,
+ * where the name of the subdirectory represents the name of the testcase.
  *
- * \note Currently only very specific testcases of the \c RDF \c Testcases can be executed.
- * Execute \code make list \endcode in the \c unittest directory to determine the name of one
- * of the supported \c RDF \c Testcases.
+ * \subsection sec_unittest_all_w3c RDF Testcases specific unittests
  *
- * \par The unittest \c rdfa_parse_sparql requires a locally installed \c SPARQL \c endpoint.
- * Please see the \htmllink{index.html, Section Options on the main page}.
+ * \libname comes with support for selected testcases of the \c W3C \c RDF \c Testcases,
+ * see \htmllinkext{http://www.w3.org/TR/rdf-testcases/} for details. Supported are
+ * most of the so-called \c Positive \c parser \c tests.
+ *
+ * All of these unittests are executed by a single testcase
+ * in the subdirectory \c rdftestcases below the \c unittest directory.
+ * The name of the testcase is provided by the makefile, setting the name as vaule
+ * of the environment variable \c TESTCASE.
+ *
+ * \note Executing \c RDF \c Testcases in fact tests the underlying library used
+ * for parsing and serializing RDF data (currently ARC2). If a test fails, it is most likely
+ * the error of the underlying library and not of \libname.
+ *
  *
  * <!-- ========================================================================== -->
@@ -87 +98 @@
    rdf                 - execute all of selected RDF testcases of W3C
    rdf TESTCASE=<name> - execute specified RDF testcase
+   
+   For information on RDF Testcases see: http://www.w3.org/TR/rdf-testcases/
 \endverbatim
  *