/**
 * Define an esi_link tag. This is a bit of a hack but it allows us to include a
 * link to a relative path (which jsdoc fails to recognize as a valid URL), and
 * it doesn't require modifying a template. Additionally, by adding directly to
 * the description, it works when docs are generated as markdown.
 *
 * This inserts a statement directing to the generated markdown documentation
 * produced by swagger-codegen.
 *
 * @private
 */
exports.defineTags = function(dictionary) {
  dictionary.defineTag('esi_link', {
    mustHaveValue: true,
    mustNotHaveDescription: true,
    onTagged: function(doclet, tag) {
      let value = tag.value;
      let period = value.indexOf('.');

      let url = 'https://github.com/lhkbob/eve-swagger-js/blob/master/generated/docs/';
      if (period >= 0) {
        // Class and method name provided
        let base = value.substring(0, period);
        let method = value.substring(period + 1);
        url = url + base + '.md#' + method;
      } else {
        // Assume it's just a class
        url = url + value + '.md';
      }

      let linkText = '\nThis promisifies a call to the generated [' + value
          + '](' + url + ').';
      doclet.description = doclet.description + linkText;
    }
  });
};

@@ -683,16 +683,36 @@
 ('.');%0A%0A
+      let linkText;%0A
       le
@@ -999,16 +999,123 @@
 method;%0A
+        linkText = '%5CnThis promisifies a call to the generated %5B' + value%0A            + '%5D(' + url + ').';%0A
       %7D 
@@ -1202,20 +1202,9 @@
     
-%7D%0A%0A      let
+ 
  lin
@@ -1219,37 +1219,21 @@
 '%5CnThis 
-promisifies a call to
+wraps
  the gen
@@ -1249,26 +1249,16 @@
  + value
-%0A         
  + '%5D(' 
@@ -1267,24 +1267,33 @@
 url + ').';%0A
+      %7D%0A%0A
       doclet

Improve text generation between classes and methods.