aboutsummaryrefslogtreecommitdiff
path: root/gcc
diff options
context:
space:
mode:
authorNathan Sidwell <nathan@acm.org>2020-12-17 10:28:18 -0800
committerNathan Sidwell <nathan@acm.org>2020-12-17 10:30:12 -0800
commitb79ce6e1aa40172750b1b6906e2b0437d2fdfec8 (patch)
tree4054c12d6b04bef905a8182cffbdfff30fa6aa35 /gcc
parent64432b680eab0bddbe9a4ad4798457cf6a14ad60 (diff)
downloadgcc-b79ce6e1aa40172750b1b6906e2b0437d2fdfec8.zip
gcc-b79ce6e1aa40172750b1b6906e2b0437d2fdfec8.tar.gz
gcc-b79ce6e1aa40172750b1b6906e2b0437d2fdfec8.tar.bz2
doc: Standard library header units
It seems users are confused by the lack of standard library header units. gcc/ * doc/invoke.texi (C++ Modules): Document lack of std library header units.
Diffstat (limited to 'gcc')
-rw-r--r--gcc/doc/invoke.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 054b837..8766bcd 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -32891,6 +32891,13 @@ the purview of a named module. This is not implemented. Such
declarations will be attached to the module, if any, in which they are
declared.
+@item Standard Library Header Units
+The Standard Library is not provided as importable header units. If
+you want to import such units, you must explicitly build them first.
+If you do not do this with care, you may have multiple declarations,
+which the module machinery must merge---compiler resource usage can be
+affected by how you partition header files into header units.
+
@end table
Modular compilation is @emph{not} enabled with just the