From 5e45211a64149b3c659b90ff2de6fa982a5a93ed Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 4 May 2024 14:17:33 +0200 Subject: Adding upstream version 15.5. Signed-off-by: Daniel Baumann --- doc/src/sgml/html/regress-coverage.html | 43 +++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 doc/src/sgml/html/regress-coverage.html (limited to 'doc/src/sgml/html/regress-coverage.html') diff --git a/doc/src/sgml/html/regress-coverage.html b/doc/src/sgml/html/regress-coverage.html new file mode 100644 index 0000000..c89f070 --- /dev/null +++ b/doc/src/sgml/html/regress-coverage.html @@ -0,0 +1,43 @@ + +33.5. Test Coverage Examination

33.5. Test Coverage Examination

+ The PostgreSQL source code can be compiled with coverage testing + instrumentation, so that it becomes possible to examine which + parts of the code are covered by the regression tests or any other + test suite that is run with the code. This is currently supported + when compiling with GCC, and it requires the gcov + and lcov programs. +

+ A typical workflow looks like this: +

+./configure --enable-coverage ... OTHER OPTIONS ...
+make
+make check # or other test suite
+make coverage-html
+

+ Then point your HTML browser + to coverage/index.html. +

+ If you don't have lcov or prefer text output over an + HTML report, you can run +

+make coverage
+

+ instead of make coverage-html, which will + produce .gcov output files for each source file + relevant to the test. (make coverage and make + coverage-html will overwrite each other's files, so mixing them + might be confusing.) +

+ You can run several different tests before making the coverage report; + the execution counts will accumulate. If you want + to reset the execution counts between test runs, run: +

+make coverage-clean
+

+

+ You can run the make coverage-html or make + coverage command in a subdirectory if you want a coverage + report for only a portion of the code tree. +

+ Use make distclean to clean up when done. +

\ No newline at end of file -- cgit v1.2.3