Annotation For Makefile

Origin for each line in Makefile from check-in b0e3b6588f:

55084356ba 2019-09-17    1: TCL_CONFIG_SH := /usr/lib64/tclConfig.sh
55084356ba 2019-09-17    2: CPPFLAGS      := -I. -DUSE_TCL_STUBS=1 -DXVFS_DEBUG $(shell . "${TCL_CONFIG_SH}" && echo "$${TCL_INCLUDE_SPEC}") $(XVFS_ADD_CPPFLAGS)
b0e3b6588f 2019-09-17    3: CFLAGS        := -fPIC -g3 -ggdb3 -Wall -Wextra $(XVFS_ADD_CFLAGS)
55084356ba 2019-09-17    4: LDFLAGS       := $(XVFS_ADD_LDFLAGS)
55084356ba 2019-09-17    5: LIBS          := $(shell . "${TCL_CONFIG_SH}" && echo "$${TCL_STUB_LIB_SPEC}")
55084356ba 2019-09-17    6: TCLSH         := tclsh
55084356ba 2019-09-17    7: LIB_SUFFIX    := $(shell . "${TCL_CONFIG_SH}"; echo "$${TCL_SHLIB_SUFFIX:-.so}")
e5b6962adf 2019-05-02    8: 
d09edad10f 2019-09-17    9: all: example-standalone$(LIB_SUFFIX) example-client$(LIB_SUFFIX) example-flexible$(LIB_SUFFIX) xvfs$(LIB_SUFFIX)
0a9369ff13 2019-05-02   10: 
e90770a5a7 2019-05-02   11: example.c: $(shell find example -type f) $(shell find lib -type f) xvfs.c.rvt xvfs-create Makefile
0a9369ff13 2019-05-02   12: 	./xvfs-create --directory example --name example > example.c.new
0a9369ff13 2019-05-02   13: 	mv example.c.new example.c
0a9369ff13 2019-05-02   14: 
d09edad10f 2019-09-17   15: example-standalone.o: example.c xvfs-core.h xvfs-core.c Makefile
d09edad10f 2019-09-17   16: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_STANDALONE $(CFLAGS) -o example-standalone.o -c example.c
511419642c 2019-09-16   17: 
d09edad10f 2019-09-17   18: example-standalone$(LIB_SUFFIX): example-standalone.o Makefile
d09edad10f 2019-09-17   19: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o example-standalone$(LIB_SUFFIX) example-standalone.o $(LIBS)
511419642c 2019-09-16   20: 
511419642c 2019-09-16   21: example-client.o: example.c xvfs-core.h Makefile
55084356ba 2019-09-17   22: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_CLIENT $(CFLAGS) -o example-client.o -c example.c
55084356ba 2019-09-17   23: 
55084356ba 2019-09-17   24: example-client$(LIB_SUFFIX): example-client.o Makefile
55084356ba 2019-09-17   25: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o example-client$(LIB_SUFFIX) example-client.o $(LIBS)
55084356ba 2019-09-17   26: 
55084356ba 2019-09-17   27: example-flexible.o: example.c xvfs-core.h Makefile
55084356ba 2019-09-17   28: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_FLEXIBLE $(CFLAGS) -o example-flexible.o -c example.c
a4f7828c1d 2019-09-17   29: 
55084356ba 2019-09-17   30: example-flexible$(LIB_SUFFIX): example-flexible.o Makefile
55084356ba 2019-09-17   31: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o example-flexible$(LIB_SUFFIX) example-flexible.o $(LIBS)
a4f7828c1d 2019-09-17   32: 
a4f7828c1d 2019-09-17   33: xvfs.o: xvfs-core.h xvfs-core.c Makefile
a4f7828c1d 2019-09-17   34: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_SERVER $(CFLAGS) -o xvfs.o -c xvfs-core.c
a4f7828c1d 2019-09-17   35: 
55084356ba 2019-09-17   36: xvfs$(LIB_SUFFIX): xvfs.o Makefile
55084356ba 2019-09-17   37: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o xvfs$(LIB_SUFFIX) xvfs.o $(LIBS)
d80c88cee0 2019-09-16   38: 
d80c88cee0 2019-09-16   39: # xvfs-create-standalone is a standalone (i.e., no external dependencies
d80c88cee0 2019-09-16   40: # like lib/minirivet, xvfs-core.c, etc) version of "xvfs-create"
511419642c 2019-09-16   41: xvfs-create-standalone: $(shell find lib -type f) xvfs-create xvfs-core.c xvfs-core.h xvfs.c.rvt Makefile
d80c88cee0 2019-09-16   42: 	rm -f xvfs-create-standalone.new xvfs-create-standalone
d80c88cee0 2019-09-16   43: 	./xvfs-create --dump-tcl --remove-debug > xvfs-create-standalone.new
d80c88cee0 2019-09-16   44: 	chmod +x xvfs-create-standalone.new
d80c88cee0 2019-09-16   45: 	mv xvfs-create-standalone.new xvfs-create-standalone
d80c88cee0 2019-09-16   46: 
b0e3b6588f 2019-09-17   47: benchmark: xvfs$(LIB_SUFFIX) example-flexible$(LIB_SUFFIX) Makefile
b0e3b6588f 2019-09-17   48: 	./benchmark.tcl
b0e3b6588f 2019-09-17   49: 
d09edad10f 2019-09-17   50: test: example-standalone$(LIB_SUFFIX) xvfs$(LIB_SUFFIX) example-client$(LIB_SUFFIX) example-flexible$(LIB_SUFFIX) Makefile
d80c88cee0 2019-09-16   51: 	rm -f __test__.tcl
55084356ba 2019-09-17   52: 	echo 'if {[catch { eval $$::env(XVFS_TEST_LOAD_COMMANDS); source //xvfs:/example/main.tcl }]} { puts stderr $$::errorInfo; exit 1 }; exit 0' > __test__.tcl
55084356ba 2019-09-17   53: 	@export XVFS_TEST_LOAD_COMMANDS; for XVFS_TEST_LOAD_COMMANDS in \
d09edad10f 2019-09-17   54: 		'load ./example-standalone$(LIB_SUFFIX) Xvfs_example' \
55084356ba 2019-09-17   55: 		'load -global ./xvfs$(LIB_SUFFIX); load ./example-client$(LIB_SUFFIX) Xvfs_example' \
55084356ba 2019-09-17   56: 		'load ./xvfs$(LIB_SUFFIX); load ./example-flexible$(LIB_SUFFIX) Xvfs_example' \
55084356ba 2019-09-17   57: 		'load ./example-flexible$(LIB_SUFFIX) Xvfs_example'; do \
55084356ba 2019-09-17   58: 			echo "[$${XVFS_TEST_LOAD_COMMANDS}] $(GDB) $(TCLSH) __test__.tcl $(TCL_TEST_ARGS)"; \
55084356ba 2019-09-17   59: 			$(GDB) $(TCLSH) __test__.tcl $(TCL_TEST_ARGS) || exit 1; \
55084356ba 2019-09-17   60: 	done
d80c88cee0 2019-09-16   61: 	rm -f __test__.tcl
77d5262842 2019-09-16   62: 
77d5262842 2019-09-16   63: coverage:
77d5262842 2019-09-16   64: 	$(MAKE) clean
d1ae68c7a1 2019-09-17   65: 	$(MAKE) XVFS_ADD_CFLAGS=-coverage XVFS_ADD_LDFLAGS=-coverage
10f67b2ced 2019-09-16   66: 	$(MAKE) test XVFS_TEST_EXIT_ON_FAILURE=0
77d5262842 2019-09-16   67: 	rm -f xvfs-test-coverage.info
77d5262842 2019-09-16   68: 	lcov --capture --directory . --output-file xvfs-test-coverage.info
77d5262842 2019-09-16   69: 	rm -rf xvfs-test-coverage
77d5262842 2019-09-16   70: 	mkdir xvfs-test-coverage
77d5262842 2019-09-16   71: 	genhtml xvfs-test-coverage.info --output-directory xvfs-test-coverage
77d5262842 2019-09-16   72: 	rm -f xvfs-test-coverage.info
0a9369ff13 2019-05-02   73: 
0a9369ff13 2019-05-02   74: clean:
d80c88cee0 2019-09-16   75: 	rm -f xvfs-create-standalone.new xvfs-create-standalone
aa32555a0a 2019-06-22   76: 	rm -f example.c example.c.new
d09edad10f 2019-09-17   77: 	rm -f example-standalone$(LIB_SUFFIX) example-standalone.o
55084356ba 2019-09-17   78: 	rm -f example-client.o example-client$(LIB_SUFFIX)
55084356ba 2019-09-17   79: 	rm -f example-flexible.o example-flexible$(LIB_SUFFIX)
55084356ba 2019-09-17   80: 	rm -f xvfs.o xvfs$(LIB_SUFFIX)
2f92a3a715 2019-09-17   81: 	rm -f example-standalone.gcda example-standalone.gcno
2f92a3a715 2019-09-17   82: 	rm -f example-client.gcda example-client.gcno
2f92a3a715 2019-09-17   83: 	rm -f example-flexible.gcda example-flexible.gcno
2f92a3a715 2019-09-17   84: 	rm -f xvfs.gcda xvfs.gcno
5583d77f1c 2019-09-14   85: 	rm -f __test__.tcl
77d5262842 2019-09-16   86: 	rm -f xvfs-test-coverage.info
77d5262842 2019-09-16   87: 	rm -rf xvfs-test-coverage
0a9369ff13 2019-05-02   88: 
0a9369ff13 2019-05-02   89: distclean: clean
0a9369ff13 2019-05-02   90: 
b0e3b6588f 2019-09-17   91: .PHONY: all clean distclean test coverage benchmark