Appendix H. --dump-build-graph Format

The --dump-build-graph option causes abuild to output XML data showing the internal build graph as described in Section 33.6, “Construction of the Build Graph”. The format of those files conforms to an XML DTD. Comments in the DTD describe how to interpret the elements and attributes. The DTD may be found in doc/build_graph.dtd in the abuild distribution. Its contents are included here for reference.

<!--  This DTD describes the format of the output of the files     -->
<!--  created by abuild dump-build-graph.  Inline comments         -->
<!--  explain the details.                                         -->

<!--  The version attribute is always "1".  We will only           -->
<!--  increment this if there is a change to the output such that  -->
<!--  previously valid data is either no longer valid or is valid  -->
<!--  but has different semantics.  Adding new attributes with     -->
<!--  default values, optional attributes, or optional elements    -->
<!--  will not cause the version number to be increased.  Code     -->
<!--  that reads this output should be prepared to accept and      -->
<!--  ignore unknown attributes or elements.  The item-name and    -->
<!--  item-platform attributes describe the name and platform of   -->
<!--  the item whose interface this is.                            -->
<!ELEMENT build-graph (item*)>
<!ATTLIST build-graph
  version         CDATA     #REQUIRED
>

<!--  One item element appears for each platform built for each    -->
<!--  item.  It corresponds to the item/platform pair.  The        -->
<!--  attributes are self-explanatory.                             -->
<!ELEMENT item (dep*)>
<!ATTLIST item
  name                  CDATA     #REQUIRED
  platform              CDATA     #REQUIRED
>

<!--  One dep element appears for each direct dependency of each   -->
<!--  item/platform pair.  The attributes are self-explanatory.    -->
<!ELEMENT dep EMPTY>
<!ATTLIST dep
  name                  CDATA     #REQUIRED
  platform              CDATA     #REQUIRED
>