折腾了：
【已解决】Mac中写Makefile或脚步实现自动化执行命令
后，想要make help输出用法。
一种是自己写echo或info，但是需要找个合适的例子去参考。
make help
Add a help target to a Makefile that will allow all targets to be self documenting
好像（才知道）可以自动生成help信息？
还有库：
Linux make command information and examples
# target: dir_info – For debug, to Dispay current directory/folder related info.
dir_info:
@echo MAKEFILE_LIST=$(MAKEFILE_LIST)
# target: help – Display callable targets.
help:
@egrep “^# target:” [Mm]akefile
效果：
➜ http_summary git:(master) ✗ make help
####################################################################################################
Author: crifan.com
Version: 20171207
Function: Auto use gitbook to generated files: website/pdf/epub/mobi. Run ‘make help’ to see usage
####################################################################################################
# target: dir_info – For debug, to Dispay current directory/folder related info.
# target: help – Display callable targets.
Add a help target to a Makefile that will allow all targets to be self documenting
【总结】
最后在Makefile的最后，加上：
<code>TARGET_MAX_CHAR_NUM=20 </code>
## Show help
help:
@echo ”
@echo ‘Usage:’
@echo ‘ make <target>’
@echo ”
@echo ‘Targets:’
@awk ‘/^[a-zA-Z\-\_0-9]+:/ { \
helpMessage = match(lastLine, /^## (.*)/); \
if (helpMessage) { \
helpCommand = substr($$1, 0, index($$1, “:”)-1); \
helpMessage = substr(lastLine, RSTART + 3, RLENGTH); \
printf ” %-$(TARGET_MAX_CHAR_NUM)s %s\n”, helpCommand, helpMessage; \
} \
} \
{ lastLine = $$0 }’ $(MAKEFILE_LIST)
其他地方的target，写成：
<code>## your target description your_target: xxxx </code>
即可自动生成help的信息。
相关的代码：
<code>
## Generate Mobi file
mobi: clean_mobi create_foler_mobi
gitbook mobi $(CURRENT_DIR_NOSLASH) $(MOBI_FULLNAME)
## Generate all files: website/pdf/epub/mobi
all: website pdf epub mobi
################################################################################
# Help
################################################################################
TARGET_MAX_CHAR_NUM=20
## Show help
help:
@echo ''
@echo 'Usage:'
@echo ' make <target>'
@echo ''
@echo 'Targets:'
@awk '/^[a-zA-Z\-\_0-9]+:/ { \
helpMessage = match(lastLine, /^## (.*)/); \
if (helpMessage) { \
helpCommand = substr($$1, 0, index($$1, ":")-1); \
helpMessage = substr(lastLine, RSTART + 3, RLENGTH); \
printf " %-$(TARGET_MAX_CHAR_NUM)s %s\n", helpCommand, helpMessage; \
} \
} \
{ lastLine = $$0 }' $(MAKEFILE_LIST)
</code>效果为：
<code>➜ http_summary git:(master) ✗ make help </code>
<span style="font-family: Monaco; font-size: 12px; color: rgb(51, 51, 51);"–<——————————————————————————
Author: crifan.com
Version: 20171207
Function: Auto use gitbook to generated files: website/pdf/epub/mobi
Run ‘make help’ to see usage
<span style="font-family: Monaco; font-size: 12px; color: rgb(51, 51, 51);"–<——————————————————————————
Usage:
make <target>
Targets:
debug_dir [Debug] Dispay current directory related info
create_foler_website Create folder for gitbook website
create_foler_pdf Create folder for pdf
create_foler_epub Create folder for epub
create_foler_mobi Create folder for mobi
create_foler_all Create folder for all target: website/pdf/epub/mobi
clean_website Clean generated gitbook website
clean_pdf Clean generated PDF file
clean_epub Clean generated ePub file
clean_mobi Clean generated Mobi file
clean_all Clean all generated files
website Generate gitbook website
pdf Generate PDF file
epub Generate ePub file
mobi Generate Mobi file
all Generate all files: website/pdf/epub/mobi
help Show help
转载请注明：在路上 » 【已解决】给makefile添加make help时输出帮助信息