[PATCH/RFC] Makefile: add 'help' target for target summary

[PATCH/RFC] Makefile: add 'help' target for target summary

[Nguyễn Thái Ngọc Duy]

I find this "make help" very helpful (at work, on a different
project). With this I don't have to crawl through Makefile when I need
something but cannot remember what's the target name. It should also
help discover new targets.

We may also have "make vars" (or something like that) that shows list
of user-configurable variables, basically a conversion of the big
comment block near the makefile's top into a printable target.

I don't work with this Makefile much, so this is just an idea. Anyone
up to turn it to something actually useful?

Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
---
 Makefile |   14 ++++++++++++++
 1 files changed, 14 insertions(+), 0 deletions(-)

diff --git a/Makefile b/Makefile
index ed82320..abf6cf9 100644
--- a/Makefile
+++ b/Makefile
@@ -2603,3 +2603,17 @@ profile-all: profile-clean
 	$(MAKE) CFLAGS="$(PROFILE_GEN_CFLAGS)" all
 	$(MAKE) CFLAGS="$(PROFILE_GEN_CFLAGS)" -j1 test
 	$(MAKE) CFLAGS="$(PROFILE_USE_CFLAGS)" all
+
+.PHONY: help
+
+help:
+	@echo "test		Run the test suite"
+	@echo "coverage	Build git with coverage support"
+	@echo "cover_db	Generate coverage database from *.gcov"
+	@echo "cover_db_html	Generate coverage report"
+	@echo "profile-all	Build git with profiling support"
+	@echo "clean		Clean intermediate files"
+	@echo "distclean	Clean even more for dist packaging"
+	@echo "sparse		Run git with sparse"
+	@echo "cscope		Generate cscope symbol database"
+	@echo "check-docs	Check documentation"
-- 
1.7.8.36.g69ee2

Re: [PATCH/RFC] Makefile: add 'help' target for target summary

[Jakub Narebski]

乧畹ễ渠周á椠乧ọ挠䑵礠‼灣汯畤獀杭慩氮捯派⁷物瑥猺ഊഊ㸠䤠晩湤⁴桩猠≭慫攠桥汰∠癥特⁨敬灦畬
慴⁷潲欬渠愠摩晦敲敮琍ਾ⁰牯橥捴⤮⁗楴栠瑨楳⁉⁤潮❴⁨慶攠瑯⁣牡睬⁴桲潵杨⁍慫敦楬攠睨敮⁉敥損ਾ⁳潭整桩湧⁢畴⁣慮湯琠牥浥浢敲⁷桡琧猠瑨攠瑡牧整慭攮⁉琠獨潵汤⁡汳漍ਾ⁨敬瀠摩獣潶敲敷⁴慲来瑳⸍ਾ‍ਾ⁗攠浡礠慬獯⁨慶攠≭慫攠癡牳∠⡯爠獯浥瑨楮朠汩步⁴桡琩⁴桡琠獨潷猠汩獴ഊ㸠潦⁵獥爭捯湦楧畲慢汥⁶慲楡扬敳Ⱐ扡獩捡汬礠愠捯湶敲獩潮映瑨攠扩服ਾ⁣潭浥湴⁢汯捫敡爠瑨攠浡步晩汥❳⁴潰⁩湴漠愠灲楮瑡扬攠瑡牧整⸍ਾ‍ਾ⁉⁤潮❴⁷潲欠睩瑨⁴桩猠䵡步晩汥畣栬⁳漠瑨楳⁩猠橵獴⁡渠楤敡⸠䅮祯湥ഊ㸠異⁴漠瑵牮⁩琠瑯⁳潭整桩湧⁡捴畡汬礠畳敦畬㼍਍੓桯畬搠瑨楳⁢攠楮⁣潭浩琠浥獳慧攬爠楮⁣潭浥湴猠⡢敬潷•ⴭⵜ渢⤿ഊഊ乢⸠瑨敲攠睡猠慴敡獴湥⁡瑴敭灴⁴漠慤搠≭慫攠桥汰∠畳楮服੩渭䵡步晩汥 慮湯瑡瑩潮獟Ⱐ獯⁴桡琠≭慫攠桥汰∠睯畬摮❴⁧整⁢慤汹畴ഊ潦⁳祮挮⸮ഊഊ㸠卩杮敤ⵯ晦ⵢ示⁎杵秾＞앮⁔棾＀⁎柾＞쵣⁄畹‼灣汯畤獀杭慩氮捯派ഊ㸠ⴭⴍਾ†䵡步晩汥⁼†‱㐠⬫⬫⬫⬫⬫⬫⬫ഊ㸠‱⁦楬敳⁣桡湧敤Ⱐㄴ⁩湳敲瑩潮猨⬩Ⱐ〠摥汥瑩潮猨⴩ഊ㸠ഊ㸠摩晦‭ⵧ楴⁡⽍慫敦楬攠戯䵡步晩汥ഊ㸠楮摥砠敤㠲㌲〮⹡扦㙣昹‱〰㘴㐍ਾ‭ⴭ⁡⽍慫敦楬攍ਾ‫⬫⁢⽍慫敦楬攍ਾ⁀䀠ⴲ㘰㌬㌠⬲㘰㌬ㄷ⁀䀠灲潦楬攭慬氺⁰牯晩汥ⵣ汥慮ഊ㸠 ␨䵁䭅⤠䍆䱁䝓㴢␨偒但䥌䕟䝅也䍆䱁䝓⤢⁡汬ഊ㸠 ␨䵁䭅⤠䍆䱁䝓㴢␨偒但䥌䕟䝅也䍆䱁䝓⤢‭樱⁴敳琍ਾ†त⡍䅋䔩⁃䙌䅇匽∤⡐剏䙉䱅录卅彃䙌䅇匩∠慬氍ਾ‫ഊ㸠⬮偈低夺⁨敬瀍ਾ‫ഊ㸠⭨敬瀺ഊ㸠⬉䁥捨漠≴敳琉॒畮⁴桥⁴敳琠獵楴攢ഊ㸠⬉䁥捨漠≣潶敲慧攉䉵楬搠杩琠睩瑨⁣潶敲慧攠獵灰潲琢ഊ㸠⬉䁥捨漠≣潶敲彤戉䝥湥牡瑥⁣潶敲慧攠摡瑡扡獥⁦牯洠⨮杣潶∍ਾ‫ी散桯•捯癥牟摢彨瑭氉䝥湥牡瑥⁣潶敲慧攠牥灯牴∍ਾ‫ी散桯•灲潦楬攭慬氉䉵楬搠杩琠睩瑨⁰牯晩汩湧⁳異灯牴∍ਾ‫ी散桯•捬敡渉ृ汥慮⁩湴敲浥摩慴攠晩汥猢ഊ㸠⬉䁥捨漠≤楳瑣汥慮ृ汥慮⁥癥渠浯牥⁦潲⁤楳琠灡捫慧楮朢ഊ㸠⬉䁥捨漠≳灡牳攉॒畮⁧楴⁷楴栠獰慲獥∍ਾ‫ी散桯•捳捯灥उ䝥湥牡瑥⁣獣潰攠獹浢潬⁤慴慢慳攢ഊ㸠⬉䁥捨漠≣桥捫ⵤ潣猉䍨散欠摯捵浥湴慴楯渢ഊ㸠ⴭ‍ਾ‱⸷⸸⸳㘮朶㥥攲ഊ㸠ഊഊⴭ‍੊慫畢⁎慲ę扳歩ഊ