From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1643) id 54BED3857C4C; Fri, 28 Oct 2022 07:15:44 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 54BED3857C4C DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1666941357; bh=SBOvkyYg3iIPuAhANNvb8aYDeHvnYHydKvxGjPIhgq8=; h=From:To:Subject:Date:From; b=wA8yqAAWQgwQ06DyS5qc84WF12E39/a/Z8aHptui3dtW/3jUZ4n1OStG+NEYyG1e4 ar+Y2vPJ6ViE1LYXEZE/KhZS3VnAQpgHKrtjNORZ3IgQtodjPS7MiLaTeAr20Ikp6j 6Ap/+iTkRkUotPgdu7H3hUGkowhubKaDn2JrWKuk= MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Thomas Schwinge To: gcc-cvs@gcc.gnu.org Subject: [gcc r13-3537] Document 'distclean-stage[N]' X-Act-Checkin: gcc X-Git-Author: Thomas Schwinge X-Git-Refname: refs/heads/master X-Git-Oldrev: c6567d2ce983651e1e416daf047c7d7b39e0c9b9 X-Git-Newrev: 0c112651f665be9948086f25f99d4e88c94716bd Message-Id: <20221028071557.54BED3857C4C@sourceware.org> Date: Fri, 28 Oct 2022 07:15:44 +0000 (GMT) List-Id: https://gcc.gnu.org/g:0c112651f665be9948086f25f99d4e88c94716bd commit r13-3537-g0c112651f665be9948086f25f99d4e88c94716bd Author: Thomas Schwinge Date: Wed Oct 26 13:07:27 2022 +0200 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]'. Diff: --- 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},