Re: [PATCH 1/4] Makefile: move "Platform specific tweaks" above LIB_{H,OBJS}

[Jonathan Nieder <jrnieder@gmail.com>]

On Mon, Nov 15, 2010 at 08:07:08AM -0800, Junio C Hamano wrote:
> Jonathan Nieder <jrnieder@gmail.com> 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 <jrnieder@gmail.com>
>> ---
>> 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).