X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=README;h=c946fe76002223e1a767b0fd6f0e7a3516f9ea1f;hb=3f808cc53e02136b1da753addffd5e17b055e979;hp=7b277c5e789c36ddfafb1ac52a168950a44e4c2c;hpb=df449d3e24e81b67c68b4f9751a0448796f9b2b7;p=platform%2Fcore%2Ftest%2Fsecurity-tests.git

diff --git a/README b/README
index 7b277c5..c946fe7 100644
--- a/README
+++ b/README
@@ -26,6 +26,10 @@ security-manager
 cynara
   cynara-test
 
+There are also inner-tests for testing complex security-tests framework
+mechanisms with binary:
+  security-tests-inner-test
+
 ==HOW TO RUN===================================================================
 
 Each test suite may be run with options:
@@ -114,6 +118,10 @@ tests-common
 --Assert macros----------------------------------------------------------------
 Used within test registering macros.
 
+First failed assertion throws test failed exception. If another assertions
+fail, information about fail conditions and backtrace is cumulated and
+presented together with already thrown exception message.
+
 dpl-test-framework
   test_runner.h
     RUNNER_ASSERT_MSG
@@ -140,13 +148,40 @@ dpl-test-framework
     RUNNER_PERF_TEST_END
           End time measurement.
 
+--Message macros---------------------------------------------------------------
+Used to print error messages during test run time.
+
+dpl-test-framework
+  test_runner.h
+    RUNNER_ERROR_MSG
+          Print error message using red color.
+
+--Defer macros-----------------------------------------------------------------
+Used to defer throwing TestException exceptions (TestFailed, TestIgnored)
+by catching them and rethrowing later. This mechanism can help in breaking
+test and passing test result from places where throwing exceptions
+is not allowed
+
+dpl-test-framework
+  test_runner.h
+    RUNNER_DEFER_TRYCATCH
+          Catches thrown TestException exceptions and stores them in TestRunner
+          structures for later use. This macro works only inside deffered scope
+          defined by RUNNER_DEFER_SCOPE, otherwise it won't catch exceptions
+    RUNNER_DEFER_SCOPE
+          Defines deferred scope. All RUNNER_DEFER_TRYCATCH macros used inside
+          the scope catch and save TestException exceptions. After scope is left
+          all saved exceptions take part in setting result of test. If there
+          is no any uncaught exception then additionally first of saved
+          exceptions is thrown.
+
 --Collectors-------------------------------------------------------------------
 Collectors are classes which collect test results. Each class does it differently.
 Collectors can be registered by --output parameter (see HOW TO RUN section) but
 there is also another collector created to write summary.
 
-tests-common
-  summary_collector.h
+dpl-test-framework
+  test_results_collector_summary.h
     SummaryCollector
           Collector writing tests summary. Call SummaryCollector::Register() to
           register it