From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753262AbdFQPjK (ORCPT ); Sat, 17 Jun 2017 11:39:10 -0400 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:38627 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753191AbdFQP1E (ORCPT ); Sat, 17 Jun 2017 11:27:04 -0400 X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Shuah Khan , linux-kselftest@vger.kernel.org Subject: [PATCH v2 12/29] kselftest.rst: do some adjustments after ReST conversion Date: Sat, 17 Jun 2017 12:26:40 -0300 Message-Id: X-Mailer: git-send-email 2.9.4 In-Reply-To: <2932e5ece623ed990b6c3b80174df270278dc314.1497713210.git.mchehab@s-opensource.com> References: <2932e5ece623ed990b6c3b80174df270278dc314.1497713210.git.mchehab@s-opensource.com> MIME-Version: 1.0 In-Reply-To: <2932e5ece623ed990b6c3b80174df270278dc314.1497713210.git.mchehab@s-opensource.com> References: <2932e5ece623ed990b6c3b80174df270278dc314.1497713210.git.mchehab@s-opensource.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Do some minor adjustments after ReST conversion: - On most documents, we use prepend a "$ " before command line arguments; - Prefer to use :: on the preceding line; - Split a multi-paragraph description as such. Signed-off-by: Mauro Carvalho Chehab --- Documentation/dev-tools/kselftest.rst | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/Documentation/dev-tools/kselftest.rst b/Documentation/dev-tools/kselftest.rst index b3861500c42d..ebd03d11d2c2 100644 --- a/Documentation/dev-tools/kselftest.rst +++ b/Documentation/dev-tools/kselftest.rst @@ -19,15 +19,15 @@ Running the selftests (hotplug tests are run in limited mode) To build the tests:: - make -C tools/testing/selftests + $ make -C tools/testing/selftests To run the tests:: - make -C tools/testing/selftests run_tests + $ make -C tools/testing/selftests run_tests To build and run the tests with a single command, use:: - make kselftest + $ make kselftest Note that some tests will require root privileges. @@ -40,11 +40,11 @@ single test to run, or a list of tests to run. To run only tests targeted for a single subsystem:: - make -C tools/testing/selftests TARGETS=ptrace run_tests + $ make -C tools/testing/selftests TARGETS=ptrace run_tests You can specify multiple tests to build and run:: - make TARGETS="size timers" kselftest + $ make TARGETS="size timers" kselftest See the top-level tools/testing/selftests/Makefile for the list of all possible targets. @@ -55,11 +55,11 @@ Running the full range hotplug selftests To build the hotplug tests:: - make -C tools/testing/selftests hotplug + $ make -C tools/testing/selftests hotplug To run the hotplug tests:: - make -C tools/testing/selftests run_hotplug + $ make -C tools/testing/selftests run_hotplug Note that some tests will require root privileges. @@ -73,13 +73,13 @@ location. To install selftests in default location:: - cd tools/testing/selftests - ./kselftest_install.sh + $ cd tools/testing/selftests + $ ./kselftest_install.sh To install selftests in a user specified location:: - cd tools/testing/selftests - ./kselftest_install.sh install_dir + $ cd tools/testing/selftests + $ ./kselftest_install.sh install_dir Running installed selftests =========================== @@ -88,12 +88,10 @@ Kselftest install as well as the Kselftest tarball provide a script named "run_kselftest.sh" to run the tests. You can simply do the following to run the installed Kselftests. Please -note some tests will require root privileges. +note some tests will require root privileges:: -:: - - cd kselftest - ./run_kselftest.sh + $ cd kselftest + $ ./run_kselftest.sh Contributing new tests ====================== @@ -114,8 +112,10 @@ Contributing new tests (details) * Use TEST_GEN_XXX if such binaries or files are generated during compiling. + TEST_PROGS, TEST_GEN_PROGS mean it is the excutable tested by default. + TEST_PROGS_EXTENDED, TEST_GEN_PROGS_EXTENDED mean it is the executable which is not tested by default. TEST_FILES, TEST_GEN_FILES mean it is the file which is used by -- 2.9.4