From patchwork Wed Oct 26 12:10:24 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Thomas Schwinge X-Patchwork-Id: 11219 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp227280wru; Wed, 26 Oct 2022 05:11:09 -0700 (PDT) X-Google-Smtp-Source: AMsMyM7cfuv23uA6wLw+YMAuO2NYh2BDAAnW2zP/PeuazPOD+frEySxslmucX59j7V+zLZeQtyoL X-Received: by 2002:a17:907:272a:b0:791:994d:fb6a with SMTP id d10-20020a170907272a00b00791994dfb6amr37631954ejl.337.1666786269672; Wed, 26 Oct 2022 05:11:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666786269; cv=none; d=google.com; s=arc-20160816; b=uU//svjOOuPvKto2blkQSR0fB5qqHeXHX0UBqQrDo2Qx45fd0VonIn1kIZ+AYkbdd/ 1WP0Wu5RTFUzrN4y2FVRc73tJCmQOa4vCV2sxMnwnzq5E44Tdknemu/VFzj2TrZNfLt7 EMEttis2D5D2DORp87xNh+Qd5hi1ULKwofU7Rx1nHSo66CJol8Loe0TqBAgwdxNHR09w iFlHa3iEuPaQ8TQL7uaKzOKaxvzM+kIJopRTa37JsVRk4GkMorT7Ygp8M9cmqRT9CJKJ Ugqu5YAe2cStMNMPF6UoEym2OnNQhEacIday9iLarytgWSCvBSwP1vYve56i4exnqIKT d7dA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:mime-version:message-id:date :user-agent:subject:to:from:ironport-sdr:dmarc-filter:delivered-to; bh=kkUQZlEZRGsdu26y84bmuh/h/KV+1u+jrd4jMAhppro=; b=mkHpijzMFMSCgv4CGqZRRoXBWTwuIiuf83CY5dbS1Oi+TCAfVrE7dLAI5kszo6Eq8s QrtKeNwf48WVr5lMJrqH7O+f5WO3HDjK9rCxP4RoDsR97OZf7j4QVqFgyE9EvtVde8bj RSuIaKBnWIM7jvo9UzMSffOmFfNo8PVzVrlU47FbBHDXHROlKlALbMr1CMAtN455s33m 0tFmtceNS1Jal2BIohXZG1/R1NCHe4JkfjYBBOJLTo3cJmvxt4wXAPa4HvLFKewB5YC1 4EivDgwZgKN4trgnZjYx61wecYyiRCkXlFQ2xB2g1e7rjsR4WtBBoG0IVrF03fQOyRXD 7NKA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org" Received: from sourceware.org (server2.sourceware.org. [2620:52:3:1:0:246e:9693:128c]) by mx.google.com with ESMTPS id ae8-20020a17090725c800b0078e25345011si5273553ejc.926.2022.10.26.05.11.09 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 Oct 2022 05:11:09 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) client-ip=2620:52:3:1:0:246e:9693:128c; Authentication-Results: mx.google.com; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org" Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 5F5C8385AC2E for ; Wed, 26 Oct 2022 12:11:07 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from esa1.mentor.iphmx.com (esa1.mentor.iphmx.com [68.232.129.153]) by sourceware.org (Postfix) with ESMTPS id 28B1E385702D; Wed, 26 Oct 2022 12:10:38 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 28B1E385702D Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com X-IronPort-AV: E=Sophos;i="5.95,214,1661846400"; d="scan'208,223";a="88287492" Received: from orw-gwy-02-in.mentorg.com ([192.94.38.167]) by esa1.mentor.iphmx.com with ESMTP; 26 Oct 2022 04:10:35 -0800 IronPort-SDR: voPvhnt78UjuR9WMkUh7iOCqsuvhzFF4QMDA8ijN5U67GUyslpwz+jYDMYDJmYlKQz2UAYIiK0 3TFQbOOqdVyynkPxx23ZFWMq8SR/kZawk1z1p6U1lpxEj6JYfF7GGHB8xHeX8C8C9+GPKmjKy9 nrUc8VMtI+XyYVu+FVHitA8g5R++cyWx313dfA72FANkwrzAH5owC+emgdsyOtKoSX96kUVWZ1 W9kZcS3QLgFQBNqvzSkiVVa68s7S/pnM9esl00WNzF4oeQ8DQ4MbjQQgj4b33Nr4bFV/Di9nWt 8mM= From: Thomas Schwinge To: , Paolo Bonzini , "Nathanael Nerode" , Alexandre Oliva , "Ralf Wildenhues" Subject: Document 'distclean-stage[N]' User-Agent: Notmuch/0.29.3+94~g74c3f1b (https://notmuchmail.org) Emacs/27.1 (x86_64-pc-linux-gnu) Date: Wed, 26 Oct 2022 14:10:24 +0200 Message-ID: <87h6zq4wgf.fsf@euler.schwinge.homeip.net> MIME-Version: 1.0 X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: svr-ies-mbx-09.mgc.mentorg.com (139.181.222.9) To svr-ies-mbx-10.mgc.mentorg.com (139.181.222.10) X-Spam-Status: No, score=-11.9 required=5.0 tests=BAYES_00, GIT_PATCH_0, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, SPF_HELO_PASS, SPF_PASS, 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: , 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?1747752079193740366?= X-GMAIL-MSGID: =?utf-8?q?1747752079193740366?= Hi! OK to push the attached patch to "Document 'distclean-stage[N]'"? Grüße Thomas ----------------- Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955 From c20771b2fc13bdb24f3ad538c1806eeccbedfd3c Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Wed, 26 Oct 2022 13:07:27 +0200 Subject: [PATCH] Document 'distclean-stage[N]' Refer to 'Makefile.tpl': # Rules to wipe a stage and all the following ones, also used for cleanstrap [+ IF prev +]distclean-stage[+prev+]:: distclean-stage[+id+] [+ ENDIF prev +] .PHONY: distclean-stage[+id+] distclean-stage[+id+]:: @: $(MAKE); $(stage) @test "`cat stage_last`" != stage[+id+] || rm -f stage_last rm -rf stage[+id+]-* [+ IF compare-target +][+compare-target+] [+ ENDIF compare-target +] gcc/ * doc/makefile.texi (Makefile Targets): Document 'distclean-stage[N]'. --- gcc/doc/makefile.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/gcc/doc/makefile.texi b/gcc/doc/makefile.texi index fe0bbcd2ed1..5186c1cd9d5 100644 --- a/gcc/doc/makefile.texi +++ b/gcc/doc/makefile.texi @@ -135,6 +135,16 @@ Compares the results of stages 2 and 3. This ensures that the compiler is running properly, since it should produce the same object files regardless of how it itself was compiled. +@item distclean-stage@var{N} (@var{N} = 1@dots{}4, profile, feedback) +Wipe stage @var{N} and all the following ones. + +For example, +@samp{make distclean-stage3} wipes stage 3 and all the following ones, +so that another @command{make} then rebuilds them from scratch. +This can be useful if you're doing changes where +``bubbling'' the changes as described above is not sufficient, +but a full @command{make restrap} isn't necessary either. + @item profiledbootstrap Builds a compiler with profiling feedback information. In this case, the second and third stages are named @samp{profile} and @samp{feedback}, -- 2.35.1