From: Nathan Sidwell <nathan@acm.org>
Date: Thu, 17 Dec 2020 18:28:18 +0000 (-0800)
Subject: doc: Standard library header units
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=b79ce6e1aa40172750b1b6906e2b0437d2fdfec8;p=gcc.git

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.
---

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index 054b8371593..8766bcdfc18 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