From patchwork Thu Dec 17 18:29:59 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nathan Sidwell X-Patchwork-Id: 1417893 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=8.43.85.97; helo=sourceware.org; envelope-from=gcc-patches-bounces@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=acm.org Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20161025 header.b=Pg55JB5E; dkim-atps=neutral Received: from sourceware.org (unknown [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4CxgXJ1xYrz9sVS for ; Fri, 18 Dec 2020 05:30:06 +1100 (AEDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id D185F3892441; Thu, 17 Dec 2020 18:30:04 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mail-qv1-xf2e.google.com (mail-qv1-xf2e.google.com [IPv6:2607:f8b0:4864:20::f2e]) by sourceware.org (Postfix) with ESMTPS id C1B8D3858031 for ; Thu, 17 Dec 2020 18:30:02 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C1B8D3858031 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=acm.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=nathanmsidwell@gmail.com Received: by mail-qv1-xf2e.google.com with SMTP id u16so13751150qvl.7 for ; Thu, 17 Dec 2020 10:30:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:to:from:subject:message-id:date:user-agent:mime-version :content-language; bh=jGSNPajPdAAXbcxp4PCRPC20MiFfQ+ED7rsEtzm5oKw=; b=Pg55JB5EC0M9sOd5TlpSU9wdMSnZA05NqRaAJzaEXK00GGboyA+kwjM/IbjKGgqeuT Ji8j8Cr7OctDstd+RkxeFCZpDl3sa+pEQ2glHY//0hdErMtcFn8J9L7mg4p+fx/wacDI Y0I4XHQzQO20NkHeugcuQg/8SHzIVdsRBGWM9Pyql8N7LV9TOHilZO7XCMQKSV8y9kED Y8NAOj8XBtWCt1GBmzONYMCXehUqv6Bai3GRNORldCMbEGV83KXJGHnESCGm3a4OoZhY qOLVm+kH4Z1gnvjpT3clI4/XQSHQoJRb04iqxXW8npRulfza6fHj2VM1N3lNS4BI+rA8 wb9w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:to:from:subject:message-id:date :user-agent:mime-version:content-language; bh=jGSNPajPdAAXbcxp4PCRPC20MiFfQ+ED7rsEtzm5oKw=; b=g1Urjs5fr4KxIlaaOBgcUGhOpPj+kfX7AefOe4IWAJUnLzn40pU89ucaRAUK/MMPX0 loaRdxo4AYh/e9FBMrgN+vF2i8Fd/64qgQfzgYaEZMnn0BfIonSKeqPgyiPnvFTaqkCi AhJfuIMJwRozFYSacKCzWYlCQjOdDl9aWTgMFRPTZVz/YWalgSVZttCDRrD9oWRW89cI D9w9fWTU3EzFSIk6BAxxu7OkQbITiC/4NO8vi1kx3Lgv0R22zSnzOzrmhMvUWV/qytPl NcxlwfGB1WxEfrh51erHa7hiN6BN//l16e2kFDUZwHRsU99GwQ8dyqlHp+/iCvFHvGQR n86w== X-Gm-Message-State: AOAM531B8yJBaaUgD9dGieq9YTmvZjsYAXxDAC57RnF0O45EPV4DU/wj qbKyBwKG+9LK1vSx5ugjC6o= X-Google-Smtp-Source: ABdhPJyE1XRWV+aG7HX2pwVX5wgx3mdeiDm7zjFxlMcWJT6JbdbrfXrcIAp3eJR8GzHkoDAk3hQ3Iw== X-Received: by 2002:a0c:dc11:: with SMTP id s17mr345365qvk.19.1608229802102; Thu, 17 Dec 2020 10:30:02 -0800 (PST) Received: from ?IPv6:2620:10d:c0a8:1102:e0c4:86e9:6418:b0da? ([2620:10d:c091:480::1:c154]) by smtp.googlemail.com with ESMTPSA id s21sm3766368qtn.13.2020.12.17.10.30.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 17 Dec 2020 10:30:00 -0800 (PST) To: GCC Patches From: Nathan Sidwell Subject: doc: Standard library header units Message-ID: Date: Thu, 17 Dec 2020 13:29:59 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.5.0 MIME-Version: 1.0 Content-Language: en-US X-Spam-Status: No, score=-10.9 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_EF, FREEMAIL_FORGED_FROMDOMAIN, FREEMAIL_FROM, GIT_PATCH_0, HEADER_FROM_DIFFERENT_DOMAINS, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces@gcc.gnu.org Sender: "Gcc-patches" 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 i/gcc/doc/invoke.texi w/gcc/doc/invoke.texi index 054b8371593..8766bcdfc18 100644 --- i/gcc/doc/invoke.texi +++ w/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