Annotation For Makefile

Lines of Makefile from check-in a4f7828c1d that are changed by the sequence of edits moving toward check-in 55084356ba:

a4f7828c1d 2019-09-17    1: CPPFLAGS := -I. -DUSE_TCL_STUBS=1 -DXVFS_DEBUG $(XVFS_ADD_CPPFLAGS)
a4f7828c1d 2019-09-17    2: CFLAGS   := -fPIC -g3 -ggdb3 -Wall $(XVFS_ADD_CFLAGS)
a4f7828c1d 2019-09-17    3: LDFLAGS  := $(XVFS_ADD_LDFLAGS)
a4f7828c1d 2019-09-17    4: LIBS     := -ltclstub8.6
a4f7828c1d 2019-09-17    5: TCLSH    := tclsh
a4f7828c1d 2019-09-17    6: 
a4f7828c1d 2019-09-17    7: all: example.so example-client.so xvfs.so
                         8: 
                         9: example.c: $(shell find example -type f) $(shell find lib -type f) xvfs.c.rvt xvfs-create Makefile
                        10: 	./xvfs-create --directory example --name example > example.c.new
                        11: 	mv example.c.new example.c
                        12: 
                        13: example.o: example.c xvfs-core.h xvfs-core.c Makefile
                        14: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_FLEXIBLE $(CFLAGS) -o example.o -c example.c
                        15: 
a4f7828c1d 2019-09-17   16: example.so: example.o Makefile
a4f7828c1d 2019-09-17   17: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o example.so example.o $(LIBS)
                        18: 
                        19: example-client.o: example.c xvfs-core.h Makefile
a4f7828c1d 2019-09-17   20: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_FLEXIBLE $(CFLAGS) -o example-client.o -c example.c
a4f7828c1d 2019-09-17   21: 
a4f7828c1d 2019-09-17   22: example-client.so: example-client.o Makefile
a4f7828c1d 2019-09-17   23: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o example-client.so example-client.o $(LIBS)
                        24: 
                        25: xvfs.o: xvfs-core.h xvfs-core.c Makefile
                        26: 	$(CC) $(CPPFLAGS) -DXVFS_MODE_SERVER $(CFLAGS) -o xvfs.o -c xvfs-core.c
                        27: 
a4f7828c1d 2019-09-17   28: xvfs.so: xvfs.o Makefile
a4f7828c1d 2019-09-17   29: 	$(CC) $(CFLAGS) $(LDFLAGS) -shared -o xvfs.so xvfs.o $(LIBS)
                        30: 
                        31: # xvfs-create-standalone is a standalone (i.e., no external dependencies
                        32: # like lib/minirivet, xvfs-core.c, etc) version of "xvfs-create"
                        33: xvfs-create-standalone: $(shell find lib -type f) xvfs-create xvfs-core.c xvfs-core.h xvfs.c.rvt Makefile
                        34: 	rm -f xvfs-create-standalone.new xvfs-create-standalone
                        35: 	./xvfs-create --dump-tcl --remove-debug > xvfs-create-standalone.new
                        36: 	chmod +x xvfs-create-standalone.new
                        37: 	mv xvfs-create-standalone.new xvfs-create-standalone
                        38: 
a4f7828c1d 2019-09-17   39: test: example.so xvfs.so example-client.so Makefile
a4f7828c1d 2019-09-17   40: 	rm -f __test__.tcl
a4f7828c1d 2019-09-17   41: 	echo 'if {[catch { load ./example.so Xvfs_example; source //xvfs:/example/main.tcl }]} { puts stderr $$::errorInfo; exit 1 }; exit 0' > __test__.tcl
a4f7828c1d 2019-09-17   42: 	$(GDB) $(TCLSH) __test__.tcl $(TCL_TEST_ARGS)
                        43: 	rm -f __test__.tcl
a4f7828c1d 2019-09-17   44: 	echo 'if {[catch { load ./xvfs.so; load ./example-client.so Xvfs_example; source //xvfs:/example/main.tcl }]} { puts stderr $$::errorInfo; exit 1 }; exit 0' > __test__.tcl
a4f7828c1d 2019-09-17   45: 	$(GDB) $(TCLSH) __test__.tcl $(TCL_TEST_ARGS)
                        46: 	rm -f __test__.tcl
                        47: 
                        48: coverage:
                        49: 	$(MAKE) clean
a4f7828c1d 2019-09-17   50: 	$(MAKE) example.so XVFS_ADD_CFLAGS=-coverage XVFS_ADD_LDFLAGS=-coverage
                        51: 	$(MAKE) test XVFS_TEST_EXIT_ON_FAILURE=0
                        52: 	rm -f xvfs-test-coverage.info
                        53: 	lcov --capture --directory . --output-file xvfs-test-coverage.info
                        54: 	rm -rf xvfs-test-coverage
                        55: 	mkdir xvfs-test-coverage
                        56: 	genhtml xvfs-test-coverage.info --output-directory xvfs-test-coverage
                        57: 	rm -f xvfs-test-coverage.info
                        58: 
                        59: clean:
                        60: 	rm -f xvfs-create-standalone.new xvfs-create-standalone
                        61: 	rm -f example.c example.c.new
a4f7828c1d 2019-09-17   62: 	rm -f example.so example.o
a4f7828c1d 2019-09-17   63: 	rm -f example-client.o example-client.so
a4f7828c1d 2019-09-17   64: 	rm -f xvfs.o xvfs.so
                        65: 	rm -f example.gcda example.gcno
                        66: 	rm -f __test__.tcl
                        67: 	rm -f xvfs-test-coverage.info
                        68: 	rm -rf xvfs-test-coverage
                        69: 
                        70: distclean: clean
                        71: 
                        72: .PHONY: all clean distclean test coverage