From patchwork Wed Apr 12 22:30:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 82689 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp635913vqo; Wed, 12 Apr 2023 15:31:24 -0700 (PDT) X-Google-Smtp-Source: AKy350b5L6zPURjnj356ZIPBIWzcUZdTHnD5pqQx7GvyWXq4pHJ/ZITsLVhNZ1T+G+8cA1SomZ3X X-Received: by 2002:a17:906:1585:b0:94a:7bde:29aa with SMTP id k5-20020a170906158500b0094a7bde29aamr292390ejd.33.1681338684680; Wed, 12 Apr 2023 15:31:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1681338684; cv=none; d=google.com; s=arc-20160816; b=joMObGL/y83S1pS53Yi+DlQKwlpgzD1tRHvVUrj5N8KMC34Wr/gEJgDP7q/OeuH54j sriWeaLyoLCEML5OmRA7Wfa5EHcezS3N/rh0QcREzlSpO1fsaI3hroQ5hYEh1OYr3zca BnHFZgbKmXRG7Zmcnqcmoyuf81KoEcSwRNSexdsdEJqR0DKm5nqyyGRgR0tA58eRfAjB oW0iDnBEvOmVdK2a3xDLfhOoHi4Pe9LW5vKSaH8IAfygPct3pRWMRD3yeyI0Db6xDWh0 vAAfdNGLmF5W+ZGLwHwNq78BgWnIZgl+Qnv5Oer/CsgkEVkzvkqmzCcWk3ZFURdMHDiX H4IQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:reply-to:from:list-subscribe:list-help:list-post :list-archive:list-unsubscribe:list-id:precedence :content-transfer-encoding:mime-version:message-id:date:subject:to :dmarc-filter:delivered-to:dkim-signature:dkim-filter; bh=s4yFD1G6J+HLOumuxjiAHVRbbYwZp4QX49DJK+l0/G4=; b=fquXIyQb3F6VvV4hUNIwMy0P78w1h/4Xl8YzB7vAsVXESZgCc6BXyFh3hIvOZgtDbS eIG9Z+MHf/2/YYW6JqyqQG4UesgVj+jUuRh+rzY6T49EFCqm2WutR4S8Jq38xCVY5hSc CDnWjWreHCKOB/JKBwEA3yDop6GoWVERqsyBUEQoHO1BUgjLeUAFGHlS8b3Zp04I/Bxd 2boRbRLhZ4GhWg+NprCCf2kbrpM/fItyvkYVYwUYqTssITcZk4LiAdObjkMPjhVhMyhF oh3Y1r63m5kINoV/aOZpLDrAK929MTZ0n9V9EpRv8U3yhcghWrvUOgKc+MBp9HqHaUg1 CgIw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=vWyxTlvS; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from sourceware.org (ip-8-43-85-97.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id ho20-20020a1709070e9400b0094a5a281168si3876926ejc.801.2023.04.12.15.31.24 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 12 Apr 2023 15:31:24 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) client-ip=8.43.85.97; Authentication-Results: mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=vWyxTlvS; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 351FD3856DC4 for ; Wed, 12 Apr 2023 22:30:56 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 351FD3856DC4 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1681338656; bh=s4yFD1G6J+HLOumuxjiAHVRbbYwZp4QX49DJK+l0/G4=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=vWyxTlvSQ7cnHn+gRvpLqZqljhGYZpIFJYH+47yolRXyAxE3rqVxQgSNMZuE59qcz SgImdjYyBlbbiYPjEOQUQ/3IhNqpfGPQuQLjANz82aN00HdG55oq4ykQxOLDjZtgYK 6dOVr3SWSJ37F28S7a4AFYqD/JBNM2JA3K7JrlSg= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTPS id B91D83858D33 for ; Wed, 12 Apr 2023 22:30:10 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org B91D83858D33 Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-512-gn5I4foFPz6gzFFCODmWpQ-1; Wed, 12 Apr 2023 18:30:09 -0400 X-MC-Unique: gn5I4foFPz6gzFFCODmWpQ-1 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id D45A2811E7C; Wed, 12 Apr 2023 22:30:08 +0000 (UTC) Received: from localhost (unknown [10.33.36.10]) by smtp.corp.redhat.com (Postfix) with ESMTP id 9F276141511D; Wed, 12 Apr 2023 22:30:08 +0000 (UTC) To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [committed] libstdc++: Document libstdc++exp.a library for -fcontracts Date: Wed, 12 Apr 2023 23:30:11 +0100 Message-Id: <20230412223011.207158-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.7 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-11.8 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_SHORT, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) 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: , X-Patchwork-Original-From: Jonathan Wakely via Gcc-patches From: Jonathan Wakely Reply-To: Jonathan Wakely Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org Sender: "Gcc-patches" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1763011392635540299?= X-GMAIL-MSGID: =?utf-8?q?1763011392635540299?= Pushed to trunk. -- >8 -- libstdc++-v3/ChangeLog: * doc/xml/manual/using.xml: Document libstdc++exp.a library. * doc/html/*: Regenerate. diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml index 7f011a6d931..3a507fc1671 100644 --- a/libstdc++-v3/doc/xml/manual/using.xml +++ b/libstdc++-v3/doc/xml/manual/using.xml @@ -108,6 +108,14 @@ + + -lstdc++exp + Linking to libstdc++exp + is required for use of the C++ Contracts extensions enabled by + -fcontracts. + + + -lstdc++_libbacktrace Until C++23 support is non-experimental, linking to @@ -1700,14 +1708,25 @@ A quick read of the relevant part of the GCC no shared library for it. To use the library you should include <experimental/filesystem> and link with . The library implementation - is incomplete on non-POSIX platforms, specifically Windows support is - rudimentary. + is incomplete on non-POSIX platforms, specifically Windows is only + partially supported. - Due to the experimental nature of the Filesystem library the usual + GCC 13 includes an implementation of the C++ Contracts library defined by + P1429R3. + Because this is an experimental extension, not part of the C++ standard, + it is implemented in a separate library, + libstdc++exp.a, and there is + no shared library for it. To use the library you should include + <experimental/contract> + and link with . + + + + Due to the experimental nature of these libraries the usual guarantees about ABI stability and backwards compatibility do not apply - to it. There is no guarantee that the components in any + to them. There is no guarantee that the components in any <experimental/xxx> header will remain compatible between different GCC releases.