1
0
mirror of git://sourceware.org/git/libabigail.git synced 2024-12-22 01:40:12 +00:00
libabigail/doc/manuals
Dodji Seketeli d2c88645e8 Support the "name_not_regexp" property in the [suppress_type] section
When writting a suppression specification in which the user wants to
keep a family of types (whose names set is specified by a regular
expression) and suppress/drop all other types, one needs to write
something like:

[suppress_type]
  name_regexp = (?!the-regexp-of-the-types-to-keep)

It would be nicer (like what is done for other properties that take
regular expressions as value in suppression specifications) to be able
to write:

[suppress_type]
  name_not_regexp = the-regexp-of-types-to-keep

This patch does just that.

It augments the abigail::suppr::type_suppression type to make it carry
the new 'name_not_regex' property.  It updates the suppression engine
to take the 'name_not_regex' property into account when interpreting
instances of abigail::suppr::type_suppression.  The parser for type
suppression directives is updated to recognize the new name_not_regexp
property.  The manual has been updated accordingly to describe the new
property.  New regression tests have been added.

	* doc/manuals/libabigail-concepts.rst: Update this to document the
	new name_not_regexp property of the suppress_type directive.
	* include/abg-suppression.h
	(type_suppression::{g,s}et_type_name_not_regex_str): Declare new accessors.
	* src/abg-suppression-priv.h
	(type_suppression::priv::{type_name_not_regex_str_,
	type_name_not_regex_}): Define new data members.
	(type_suppression::priv::{get_type_name_not_regex,
	set_type_name_not_regex, get_type_name_not_regex_str,
	set_type_name_not_regex_str}): Define new member functions.
	* src/abg-suppression.cc
	(type_suppression::get_type_name_regex_str): Fix comments.
	(type_suppression::{set_type_name_not_regex_str,
	get_type_name_not_regex_str}): Define new data members.
	(suppression_matches_type_name): Adapt to support the new
	type_name_not_regex property.
	(read_type_suppression): Support parsing the type_name_not_regexp
	property.
	* tests/data/test-diff-suppr/test42-negative-suppr-type-report-0.txt:
	New test reference output.
	* tests/data/test-diff-suppr/test42-negative-suppr-type-report-1.txt: Likewise.
	* tests/data/test-diff-suppr/test42-negative-suppr-type-suppr-1.txt:
	New test input.
	* tests/data/test-diff-suppr/test42-negative-suppr-type-suppr-2.txt: Likewise.
	* tests/data/test-diff-suppr/test42-negative-suppr-type-v0.{cc, o}: Likewise.
	* tests/data/test-diff-suppr/test42-negative-suppr-type-v1.{cc,
	o}: Likewise.
	* tests/data/Makefile.am: Add the test files above to source
	distribution.
	* tests/test-diff-suppr.cc (int_out_specs): Add the new tests to
	the harness.

Signed-off-by: Dodji Seketeli <dodji@redhat.com>
2019-09-30 14:56:52 +02:00
..
abicompat.rst Add several shortcuts to options for abicompat 2016-05-08 12:29:33 +02:00
abidiff.rst Add a --fail-no-debug-info to abidiff 2018-11-08 09:04:53 +01:00
abidw.rst Support having several debuginfo search dirs for a binary 2018-11-08 09:03:32 +01:00
abilint.rst Drop suppressed ABI artifacts from the IR 2016-09-21 18:35:08 +02:00
abipkgdiff.rst Represent sizes and offsets in bytes and hexadecimal values 2018-04-30 17:11:40 +02:00
conf.py Bug 19428 - New fedabipkgdiff utility 2016-05-13 00:42:36 +02:00
fedabipkgdiff.rst Add a --suppressions option to fedabipkgdiff 2017-10-16 14:45:32 +02:00
index.rst Update the manual for the suppression specification initial work 2014-10-15 22:32:56 +02:00
kmidiff.rst Some documentation fixes 2018-12-07 11:21:50 +01:00
libabigail-concepts.rst Support the "name_not_regexp" property in the [suppress_type] section 2019-09-30 14:56:52 +02:00
libabigail-overview.rst Fix some wording in the Libabigail overview manual page 2016-05-30 16:24:53 +02:00
libabigail-tools.rst Update & cleanup the tools manuals summary 2017-12-11 14:30:04 +01:00
Makefile.am Add documentation for the kmidiff tool 2017-07-03 17:45:45 +02:00