From: Martin Liska Date: Mon, 11 May 2020 07:25:46 +0000 (+0200) Subject: Add caveat about parsing of .gcda and .gcno files. X-Git-Tag: misc/first-auto-changelog~362 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=10a9bf806cf180915c20f9971d33da8ff2d663c1;p=thirdparty%2Fgcc.git Add caveat about parsing of .gcda and .gcno files. PR gcov-profile/94928 * gcov-io.h: Add caveat about coverage format parsing and possible outdated documentation. --- diff --git a/gcc/ChangeLog b/gcc/ChangeLog index d23ebffc24b2..f4424c604d92 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,9 @@ +2020-05-11 Martin Liska + + PR gcov-profile/94928 + * gcov-io.h: Add caveat about coverage format parsing and + possible outdated documentation. + 2020-05-11 Xiong Hu Luo PR tree-optimization/83403 diff --git a/gcc/gcov-io.h b/gcc/gcov-io.h index d21a43c4c31c..ef888f3ff98b 100644 --- a/gcc/gcov-io.h +++ b/gcc/gcov-io.h @@ -25,7 +25,13 @@ see the files COPYING3 and COPYING.RUNTIME respectively. If not, see . */ -/* Coverage information is held in two files. A notes file, which is +/* CAVEAT: Coverage information files should not be parsed directly, + instead use `gcov --json-format`, which provides + machine-readable coverage information. + + Note that the following file format documentation might be outdated. + + Coverage information is held in two files. A notes file, which is generated by the compiler, and a data file, which is generated by the program under test. Both files use a similar structure. We do not attempt to make these files backwards compatible with previous