From d3e9b0e8e0ee822e02e3e89d4e890de4ed0ffcd4 Mon Sep 17 00:00:00 2001
From: Caroline Chao <caroline.chao@digia.com>
Date: Mon, 27 May 2013 11:31:18 +0200
Subject: [PATCH] Autotest: Move the README file to the tests/auto folder

So it is more visible. Add some tips if user needs to run
the autotests.

Change-Id: I86739a06b1cd62a061aec20fb640f7c66cfc557c
Reviewed-by: Liang Qi <liang.qi@digia.com>
---
 tests/auto/README.txt            | 38 ++++++++++++++++++++++++++++++++
 tests/auto/testplugin/README.txt | 11 ---------
 2 files changed, 38 insertions(+), 11 deletions(-)
 create mode 100644 tests/auto/README.txt
 delete mode 100644 tests/auto/testplugin/README.txt

diff --git a/tests/auto/README.txt b/tests/auto/README.txt
new file mode 100644
index 000000000..948242f08
--- /dev/null
+++ b/tests/auto/README.txt
@@ -0,0 +1,38 @@
+
+Here are some tips if you need to run the Qt Quick Controls auto tests.
+
+ - Testplugin
+
+Some autotests require the test plugin under testplugin/QtQuickControlsTests.
+
+The test plugin is not installed (i.e. to the qml folder), so
+in order for the tst_controls to find it, you can either:
+
+- Run make check in the controls folder. The plugin will be found
+at run time because IMPORTPATH is defined in the pro file.
+
+- In Qt Creator run settings or in the console, set QML2_IMPORT_PATH
+macro to the testplugin path. At run time QML2_IMPORT_PATH is used by
+by qmlscene to find imports required.
+i.e: export QML2_IMPORT_PATH=<path_qtquickcontrols_git_clone>/tests/auto/testplugin
+
+- Use the -import command-line option:
+$ cd build/qt5/qtquickcontrols/tests/auto/controls
+$ ./tst_controls -import ../testplugin
+
+ - Running specific tests:
+
+i) It is possible to run a single file using the -input option. For example:
+
+$ ./tst_controls -input data/test.qml
+
+$ ./tst_controls -input <full_path>/test.qml
+
+Specifying the full path to the qml test file is for example needed for shadow builds.
+
+
+ii) The -functions command-line option will return a list of the current tests functions.
+It is possible to run a single test function using the name of the test function as an argument. For example:
+
+tst_controls Test_Name::function1
+
diff --git a/tests/auto/testplugin/README.txt b/tests/auto/testplugin/README.txt
deleted file mode 100644
index c22837db4..000000000
--- a/tests/auto/testplugin/README.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-
-The test plugin is not installed (i.e. to the qml folder).
-In order for the tst_controls to find it, you can either:
-
-- Run make check in the controls folder. The plugin will be found
-at run time because IMPORTPATH is defined in the pro file.
-
-- In Qt Creator run settings or in the console, set QML2_IMPORT_PATH
-macro to the testplugin path. At run time QML2_IMPORT_PATH is used by
-by qmlscene to find imports required.
-i.e: export QML2_IMPORT_PATH=<path_qtquickcontrols_git_clone>/tests/auto/testplugin
-- 
GitLab