1# -*- makefile -*- 2.PHONY: help 3CTAGS_PROG = $(CTAGS_NAME_EXECUTABLE) 4 5help: 6 @echo "Compilation targets:" 7 @echo "" 8 @echo "make - Build $(CTAGS_PROG)" 9 @echo "make V=1 - Build $(CTAGS_PROG) with verbose output" 10 @echo "make -f mk_mingw.mak - Build $(CTAGS_PROG) using MinGW" 11 @echo "make -f mk_mingw.mak V=1 - Build $(CTAGS_PROG) using MinGW with verbose output" 12 @echo "make -C docs html - Build HTML documents by Sphinx" 13 @echo "" 14 @echo "Testing targets:" 15 @echo "" 16 @echo "make units - Run parser unit test cases" 17 @echo "make tmain - Run ctags main functionality test cases" 18 @echo "make tlib - Run mini-geany test cases" 19 @echo "make man-test - Run testing examples in per-language man pages" 20 @echo "make check-genfile - Run testing generated files are committed" 21 @echo "make check - Run all tests above" 22 @echo "" 23 @echo "make fuzz - Verify that all parsers are able to properly process each available test unit" 24 @echo "make noise - Verify the behavior of parsers for broken input: a character injected or removed randomly" 25 @echo "make chop - Verify the behavior of parsers for broken input: randomly truncated from tail" 26 @echo "make slap - Verify the behavior of parsers for broken input: randomly truncated from head" 27 @echo "make roundtrip - Verify the behavior of readtags command" 28 @echo 29 @echo "Arguments that can be used in testing targets:" 30 @echo 31 @echo "V=1 - Verbose output" 32 @echo "VG=1 - Run test cases with Valgrind memory profiler" 33 @echo "LANGUAGES=<language>[,<language>] - Only run test cases of the selected languages" 34 @echo "CATEGORIES=<category> - Only run tests available under folder Units/<category>.r" 35 @echo "UNITS=<case>[,<case>] - Only run tests named Units/[category.r/]/<case>.d in units target" 36 @echo " Tmain/<case>.d in tmain target" 37 @echo "PMAP=<newlang>/<oldlang>[,...] - Make <newlang> parser pretend <oldlang> (units target only)" 38 @echo "" 39 @echo "Input validation target:" 40 @echo "" 41 @echo "make validate-input - Validate the input files themselves, not ctags" 42 @echo 43 @echo "Arguments that can be used in input validation target:" 44 @echo "VALIDATORS=<validator>,[<validator>] - Validate only input files expecting validated by VALIDATORs" 45