From: Nicholas Nethercote Date: Mon, 3 Apr 2023 22:06:41 +0000 (+1000) Subject: Some tiny README fixes. X-Git-Tag: VALGRIND_3_21_0~73 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3d0d7a19248c9eea026528109e5f0870b86065ff;p=thirdparty%2Fvalgrind.git Some tiny README fixes. --- diff --git a/README b/README index ddbb85689d..4ac3ace5eb 100644 --- a/README +++ b/README @@ -1,4 +1,3 @@ - Release notes for Valgrind ~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are building a binary package of Valgrind for distribution, @@ -22,10 +21,9 @@ use Valgrind to build new tools. The Valgrind distribution currently includes six production-quality tools: a memory error detector, two thread error detectors, a cache and branch-prediction profiler, a call-graph generating cache and -branch-prediction profiler, and a heap profiler. It also includes -three experimental tools: a heap/stack/global array overrun detector, -a different kind of heap profiler, and a SimPoint basic block vector -generator. +branch-prediction profiler, and two heap profilers. It also includes +two experimental tools: a heap/stack/global array overrun detector, +and a SimPoint basic block vector generator. Valgrind is closely tied to details of the CPU, operating system and to a lesser extent, compiler and basic C libraries. This makes it difficult diff --git a/README_DEVELOPERS b/README_DEVELOPERS index 4ed21a561b..9c04763d47 100644 --- a/README_DEVELOPERS +++ b/README_DEVELOPERS @@ -3,6 +3,7 @@ Building and installing it To build/install from the GIT repository or from a distribution tarball, refer to the section with the same name in README. + Building and not installing it ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To run Valgrind without having to install it, run coregrind/valgrind @@ -91,12 +92,12 @@ to a try branch will be build by the buildbot at builder.sourceware.org https://builder.sourceware.org/buildbot/#/builders?tags=valgrind-try If you want to try a commit you can push to a special named try branch -(users//try-) as follows: +(users//try-) as follows: - git checkout -b frob + git checkout -b ...hack, hack, hack... OK, looks good to submit git commit -a -m "Awesome hack" - git push origin frob:users/username/try-frob + git push origin :users//try- When all builders have build your patch the buildbot will sent you (or actually the patch author) an email telling you if any builds failed and @@ -105,7 +106,8 @@ https://builder.sourceware.org/buildbot/#/builders?tags=valgrind-try Afterwards you can delete the branch again: - git push origin :users/username/try-frob + git push origin :users/username/try- + Debugging Valgrind with GDB ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -178,7 +180,7 @@ A different and possibly easier way is as follows: Self-hosting ~~~~~~~~~~~~ -This section explains : +This section explains: (A) How to configure Valgrind to run under Valgrind. Such a setup is called self hosting, or outer/inner setup. (B) How to run Valgrind regression tests in a 'self-hosting' mode, @@ -272,7 +274,7 @@ it contains the detected race conditions. The file tests/outer_inner.supp contains suppressions for the irrelevant or benign errors found in the inner. -An regression test running in the inner (e.g. memcheck/tests/badrw) will +A regression test running in the inner (e.g. memcheck/tests/badrw) will cause the inner to report an error, which is expected and checked as usual when running the regtests in an outer/inner setup. However, the outer will often also observe an error, e.g. a jump