This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[doc, committed] clarify -fno-implicit-templates usage
- From: Sandra Loosemore <sandra at codesourcery dot com>
- To: "gcc-patches at gcc dot gnu dot org" <gcc-patches at gcc dot gnu dot org>
- Date: Sat, 17 Nov 2018 09:16:01 -0700
- Subject: [doc, committed] clarify -fno-implicit-templates usage
This patch is for PR 4025, one of the oldest documentation issues in
bugzilla. I think that since 2001 (GCC 3.0) expectations for C++
template handling have evolved so that users expect it to "just work"
without messing with options like this, but it's a trivial fix to the docs.
-Sandra
2018-11-17 Sandra Loosemore <sandra@codesourcery.com>
PR c++/4025
gcc/
* doc/invoke.texi (C++ Dialect Options): Clarify usage of
-fno-implicit-templates.
Index: gcc/doc/invoke.texi
===================================================================
--- gcc/doc/invoke.texi (revision 266233)
+++ gcc/doc/invoke.texi (working copy)
@@ -2574,6 +2574,9 @@ This option is implied by the strict ISO
@opindex fimplicit-templates
Never emit code for non-inline templates that are instantiated
implicitly (i.e.@: by use); only emit code for explicit instantiations.
+If you use this option, you must take care to structure your code to
+include all the necessary explicit instantiations to avoid getting
+undefined symbols at link time.
@xref{Template Instantiation}, for more information.
@item -fno-implicit-inline-templates