code: function gen(srcfn, outputfn) {
      console.log("GEN: ", outputfn);
  
      // make the directory (doing nothing if it already exists) 
      mkdirp.sync( path.dirname( outputfn ) );
     
      // compile the doc file
      compile(srcfn, outputfn);
  }
docs: HELPERS