summaryrefslogtreecommitdiff
path: root/README.git
diff options
context:
space:
mode:
authorPaul Smith <psmith@gnu.org>2021-09-05 22:28:36 -0400
committerPaul Smith <psmith@gnu.org>2021-09-05 22:28:36 -0400
commitde48d6a4f71329a91d38b90510abd28110744ad9 (patch)
treea77d205c29225b6e67205c575c32233bea7080fe /README.git
parent55f06bdc3fe765c2fceaad56cfaaee00311e7bf0 (diff)
downloadmake-git-de48d6a4f71329a91d38b90510abd28110744ad9.tar.gz
* README.git: Add a section on ways to test.
Diffstat (limited to 'README.git')
-rw-r--r--README.git30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.git b/README.git
index 543fd357..e7bd6dd9 100644
--- a/README.git
+++ b/README.git
@@ -159,6 +159,36 @@ Next, rename the file README.W32.template to README.W32 and follow those
instructions.
+Debugging and Testing
+---------------------
+
+These instructions have been tested on GNU systems. I have no idea if they
+work on non-GNU systems (Windows, MacOS, etc.)
+
+* Alternate Configurations:
+ The maintMakefile has a rule for running configure with various different
+ options, with and without packages. Run:
+
+ make check-alt-config
+
+* Valgrind:
+ You can run all tests under valgrind by passing the -memcheck option:
+
+ (cd tests && ./run_make_tests -make ../make -memcheck)
+
+ Note, this is slow! Also some tests will fail because of invoking valgrind.
+
+* ASAN:
+ You can build with ASAN and run tests, like this:
+
+ make clean
+ make -j8 CFLAGS='-ggdb3 -fsanitizer=address' LDFLAGS='-ggdb3 -fsanitizer=address'
+ (cd tests && ./run_make_tests -make ../make)
+
+ Note that ASAN is reporting many more errors than valgrind. I don't know
+ which one is wrong: I haven't looked at them closely.
+
+
Creating a Package
------------------