anchor.diff:   ** Let giblish generate a clickable graph of all document references (requires
       graphviz and the 'dot' tool).
   
  -NOTE: giblish shall be considered stable from a usage perspective, please report bugs to the issue tracker. It's API however, is to be considered alpha, meaning that future versions may break the current usage of cmd line flags, generated artifacts or other functionality.
  +NOTE: giblish shall be considered stable from a usage perspective, please report bugs to the issue tracker. It's API however, is to be considered alpha, meaning that future versions may break the current usage of cmd line flags, generated artifacts, styling or other functionality.
   
   == Dependencies and credits
   
  
positive.code: == Document ids and the reference graph
  
  NOTE: This is a non-standard extension of asciidoc. If you use this feature, you will
  need to generate your documents using giblish to make this work.
  
  giblish extends the cross reference concept in asciidoc with a _document id_ mechanism.
  To use this, you need to:
  
   . Add a `:docid:` entry in your document's header section.
   . Refer to a document using the syntax pass:[<<:docid:#DOC_ID#>>].
   . Run giblish with the -d switch when generating documents.
  
  
negative.code: 
  == Purpose
  
  To illustrate the use of doc id. You can refer to document one as <<:docid:D-001>>.
  This will display a clickable link with the doc id (D-001 in this case).
  
  You can basically follow the same syntax as the normal asciidoc cross-ref, such as:
  
   * <<:docid:D-002#purpose>> to refer to a specific section or anchor.
   * <<:docid:D-002#purpose,The purpose section>> to refer to a specific section and
     display a specific text for the link.
  ----
  
  The above reference will work even if either document changes location or file name as long
  as both documents are parsed by giblish in the same run.
  
  [[usage_examples]]
  == Usage Examples
  