code: function augmentSingleFile (fileWithContents) {
    const result = Object.assign({
      callsPartial: [],
      comments: []
    }, fileWithContents)
    const ast = Handlebars.parse(fileWithContents.contents)
    new PartialVisitor(partialCall => result.callsPartial.push(partialCall)).accept(ast)
    new ApiDocCommentVisitor(comment => result.comments.push(comment)).accept(ast)
    return result
  }
docs: Augments the 'fileWithContents' with several properties derived from the files contents:
  
  * **calls**: A list of one object `{name: 'abc'}` for each partial that is called from within the current
  template or partials.
  * **apidocComment**: The contents of first comment that contains the string `@apidoc`.
  
  
  @param {{path:string, contents: string}} fileWithContents an object containing the path to
  a file and its contents.
  @return {{path: string, contents: string, calls: string[], comment?:string}} the input object
  augmented by the partialnames called from this template or partial