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