chore(doc-gen): fix AttachCommentTreeVisitor

In the case that there were more than one comment blocks preceding a block of code, the visitor was only attaching the first comment. Really what we should do is to attach the last comment before the code block.

Author: petebacondarwin

docs/dgeni-package/services/AttachCommentTreeVisitor.js

@@ -16,22 +16,27 @@ module.exports = function AttachCommentTreeVisitor(ParseTreeVisitor, log) {
 
  if (this.currentComment) log.silly('comment: ' +
  this.currentComment.range.start.line + ' - ' +
- this.currentComment.range.end.line);
+ this.currentComment.range.end.line + ' : ' +
+ this.currentComment.range.toString());
 
  ParseTreeVisitor.prototype.visit.call(this, tree);
  },
 
  // Really we ought to subclass ParseTreeVisitor but this is fiddly in ES5 so
  // it is easier to simply override the prototype's method on the instance
  visitAny: function(tree) {
- if (tree && tree.location && tree.location.start && this.currentComment) {
- if (this.currentComment.range.end.offset < tree.location.start.offset) {
- log.silly('tree: ' + tree.constructor.name + ' - ' + tree.location.start.line);
+ if (tree && tree.location && tree.location.start && this.currentComment &&
+ this.currentComment.range.end.offset < tree.location.start.offset) {
+ log.silly('tree: ' + tree.constructor.name + ' - ' + tree.location.start.line);
+ while (this.currentComment &&
+ this.currentComment.range.end.offset < tree.location.start.offset) {
+ log.silly('comment: ' + this.currentComment.range.start.line + ' - ' +
+ this.currentComment.range.end.line + ' : ' +
+ this.currentComment.range.toString());
  tree.commentBefore = this.currentComment;
  this.currentComment.treeAfter = tree;
  this.index++;
  this.currentComment = this.comments[this.index];
- if (this.currentComment) log.silly('comment: ' + this.currentComment.range.start.line + ' - ' + this.currentComment.range.end.line);
  }
  }
  return ParseTreeVisitor.prototype.visitAny.call(this, tree);