Add support for codified VUs

The following is implemented in this change:

- Codified VU parsing
- Codified VU reformatting in source (reflow.py)
- Codified VU formatting for build either in code or english
- Codified VU type checking
- Codified VU customization for build with/without extensions/versions
  * Removes the need for ifdef
- Unit tests

Author: ShabbyX

Makefile

@@ -145,6 +145,7 @@ VERBOSE =
 # EXTRAATTRIBS sets additional attributes, if passed to make
 # ADOCMISCOPTS miscellaneous options controlling error behavior, etc.
 # ADOCEXTS asciidoctor extensions to load
+# ADOCPROCOPTS options for passes that process the spec and produce side effects (such as validusage)
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
@@ -221,10 +222,12 @@ ADOCMISCOPTS = --failure-level ERROR
 # Look in $(GENERATED) for explicitly required non-extension Ruby, such
 # as apimap.rb
 ADOCEXTS     = -I$(GENERATED) \
+	       -I$(CONFIGS)/helpers/ \
 	       -r $(CONFIGS)/spec-macros.rb \
 	       -r $(CONFIGS)/open_listing_block.rb \
 	       -r $(CONFIGS)/ifdef-mismatch.rb
-ADOCOPTS     = -d book $(ADOCMISCOPTS) $(ATTRIBOPTS) $(NOTEOPTS) $(VERBOSE) $(ADOCEXTS)
+ADOCPROCOPTS = -d book $(ADOCMISCOPTS) $(ATTRIBOPTS) $(NOTEOPTS) $(VERBOSE) $(ADOCEXTS)
+ADOCOPTS     = $(ADOCPROCOPTS) -r $(CONFIGS)/vu-formatter.rb
 
 # HTML target-specific Asciidoctor extensions and options
 ADOCHTMLEXTS = -r $(CONFIGS)/katex_replace.rb \
@@ -396,16 +399,17 @@ epub: $(EPUBDIR)/vkspec.epub $(SPECSRC) $(COMMONDOCS)
 $(EPUBDIR)/vkspec.epub: $(SPECSRC) $(COMMONDOCS)
 	$(QUIET)$(ASCIIDOC) -b epub3 $(ADOCOPTS) $(ADOCEPUBOPTS) -o $@ $(SPECSRC)
 
-validusage: $(VUDIR)/validusage.json $(SPECSRC) $(COMMONDOCS)
+.PHONY: validusage
+validusage: $(VUDIR)/validusage.json
 
 # validusage.json now includes a 'page' field with a relative path in
 # the spec module of docs.vulkan.org to the page containing each VUID.
 # Generating the maps from VUID anchors to Antora pages requires
 # building a regular HTML spec and preprocessing the spec source to the
 # Antora build directory.
-$(VUDIR)/validusage.json: $(SPECSRC) $(COMMONDOCS) $(PYXREFMAP) $(PYPAGEMAP)
+$(VUDIR)/validusage.json: $(SPECSRC) $(COMMONDOCS) $(PYXREFMAP) $(PYPAGEMAP) $(CONFIGS)/vu-to-json/extension.rb $(CONFIGS)/helpers/vu_helpers.rb
 	$(QUIET)$(MKDIR) $(VUDIR)
-	$(QUIET)$(ASCIIDOC) $(ADOCOPTS) $(ADOCVUOPTS) --trace \
+	$(QUIET)$(ASCIIDOC) $(ADOCPROCOPTS) $(ADOCVUOPTS) --trace \
 	    -a json_output=$@ -o $@ $(SPECSRC)
 	$(QUIET)$(PYTHON) $(SCRIPTS)/add_validusage_pages.py \
 	    -xrefmap $(PYXREFMAP) -pagemap $(PYPAGEMAP) -validusage $@