From: Jonathan Nieder Date: Mon, 15 Nov 2010 16:11:22 GMT Subject: Re: [PATCH 1/4] Makefile: move "Platform specific tweaks" above LIB_{H,OBJS} Message-ID: <20101115161122.GB16385@burratino> In-Reply-To: <7v8w0umuz7.fsf@alter.siamese.dyndns.org> On Mon, Nov 15, 2010 at 08:07:08AM -0800, Junio C Hamano wrote: > Jonathan Nieder writes: >> Ævar Arnfjörð Bjarmason wrote: >>> That listing should be in a comment at the start of the >>> Makefile. Please submit a patch for that! >> >> How about this? An annoying piece of GNU makefile syntax makes this >> uglier than it needs to be (search for HACK for details). >> >> Signed-off-by: Jonathan Nieder >> --- >> diff --git a/Makefile b/Makefile >> index 1f1ce04..38edd65 100644 >> --- a/Makefile >> +++ b/Makefile >> @@ -1,6 +1,8 @@ >> # The default target of this Makefile is... >> all:: >> >> +outline:: ; @echo "Configuration." >> + >> # Define V=1 to have a more verbose compile. >> # >> # Define SHELL_PATH to a POSIX shell if your /bin/sh is broken. > > Hmm, I don't quite get what you are trying to do here. What good does the > output from "make outline" do to a potential/actual developer? You can > learn that there are sections for "Testing rules", but then what? You > will look for that string in the editor or pager. I dunno. I wrote it because Ævar asked for it (and to make visible where the trivial obstacles would lie in getting target-listing "make help" to work, which is more interesting to me).