adding a new unified C file build target

Makefile

@@ -28,6 +28,15 @@ dist/llvm-statepoint-tablegen.a: $(C_DEPS)
 # $< gives first prereq
 $(BUILD_ROOT)/%.o: $(SRC_ROOT)/%.c $(HEADERS)
 	$(CC) $(FLAGS) -c $< -o $@
+
+unified:
+	# roll together the headers. api.h needs to come first so we sort the headers.
+	cat $(sort $(HEADERS)) >> $(BUILD_ROOT)/statepoint.h
+	# make the C file
+	echo "#include \"statepoint.h\"" > $(BUILD_ROOT)/statepoint.c
+	sed -E -e "s:[[:space:]]*#include[[:space:]]+\"include/.+\":// include auto-removed:g" $(C_SRCS) >> $(BUILD_ROOT)/statepoint.c
+	# ensure that it compiles
+	$(CC) -c $(BUILD_ROOT)/statepoint.c -o $(BUILD_ROOT)/statepoint.o
 
 clean:
 	rm -f build/*

README.md

@@ -24,6 +24,11 @@ The currently supported [Stackmap Format](http://llvm.org/docs/StackMaps.html#st
 
 <a name="caveat">\*</a> *almost*... we rely on the [packed attribute](https://gcc.gnu.org/onlinedocs/gcc/Common-Type-Attributes.html#Common-Type-Attributes)
  supported by popular C compilers (*i.e.,* clang and gcc).
+
+#### including these utils in your project
+
+You can generate a single `.c` and corresponding `.h` file for inclusion in your own
+build system. To do this, run `make unified`, and the output code will be placed under `build/`.
 
 #### a fancier implementation
 

src/generate.c

@@ -1,4 +1,5 @@
 #include "include/stackmap.h"
+#include "include/api.h"
 #include "include/hash_table.h"
 
 bool isBasePointer(value_location_t* first, value_location_t* second) {

src/hash_table.c

@@ -1,5 +1,7 @@
+#include "include/api.h"
 #include "include/hash_table.h"
 
+
 /**
  * The hash function used to distribute keys uniformly across the table.
  * The implementation is one round of the xorshift64* algorithm.

src/include/hash_table.h

@@ -10,8 +10,6 @@
 #include <stdlib.h>
 #include <string.h>
 
-#include "api.h"
-
 /** Functions **/
 
 statepoint_table_t* new_table(float loadFactor, uint64_t expectedElms);