anchor.diff:   |     |- branch_2_top_dir
    |           | ...
   
  -assume that the file tree looks like this when not
  -rendering a git branch:
  -
   .When rendering documents not in a git branch
    dst_root_dir
    |- index.html
  
positive.code:  |     |   |- file2.adoc
   |     |- ...
  
  The parameters that is sent to the cgi script via the html form generated
  by giblish are:
  
    * searchphrase -> the text string to search for
    * ignorecase -> wether to ignore case or not
    * useregexp -> wether the searchphrase above is treated as a regexp or
      ordinary text
    * css -> the css file name to use when styling the search result page
    * topdir -> the absolute path to the root of the generated document tree
    * reltop -> <clarify this>
  
negative.code: 
  giblish is used to convert a source directory tree containing AsciiDoc files to
  a destination directory tree containing the corresponding html or pdf files
  and adds some handy tools for easier navigation of the resulting files.
  
  The added tools include:
  
   * An index page listing all rendered documents with clickable links
   * A (stripped-down but nonetheless useful) text-search of your (html) documents (requires
     that you view your docs via a web-server.
   * If the source directory tree is part of a git repository, giblish can generate
     separate html/pdf trees for branches and/or tags that match a user specified
     regexp (see examples below).
   * Document ids - Note: the implementation of this is giblish-specific and thus
     you need to render your adoc files using giblish to make this work as intended.
     You can use document ids to:
   ** Reference one doc in the source tree from another doc without depending on file
      names or relative paths. The referenced doc can thus be moved within the source
      tree or change its file name and the reference will still be valid.
   ** Validate doc id references during document rendering and thus be alerted to
      any invalid doc id references.
   ** 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.
  
  == Dependencies and credits
  
  