From: Jonathan Wakely <jwakely@redhat.com>
Date: Wed, 15 Feb 2023 13:32:57 +0000 (+0000)
Subject: doc: Suggest fix for -Woverloaded-virtual warnings
X-Git-Tag: basepoints/gcc-14~1126
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d82490d531272f50202b663400cfa814335a11f2;p=thirdparty%2Fgcc.git

doc: Suggest fix for -Woverloaded-virtual warnings

Users are confused about what this warning means, so add a suggested
solution to the documentation.

gcc/ChangeLog:

	* doc/invoke.texi (C++ Dialect Options): Suggest adding a
	using-declaration to unhide functions.
---

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 0a43720f6143..6def1fd631ea 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -4282,6 +4282,10 @@ b->f();
 @noindent
 fails to compile.
 
+In cases where the different signatures are not an accident, the
+simplest solution is to add a using-declaration to the derived class
+to un-hide the base function, e.g. add @code{using A::f;} to @code{B}.
+
 The optional level suffix controls the behavior when all the
 declarations in the derived class override virtual functions in the
 base class, even if not all of the base functions are overridden: