hookapp 2.0.7 → 2.0.8

data/html/js/searcher.js

@@ -0,0 +1,229 @@
+Searcher = function(data) {
+  this.data = data;
+  this.handlers = [];
+}
+
+Searcher.prototype = new function() {
+  // search is performed in chunks of 1000 for non-blocking user input
+  var CHUNK_SIZE = 1000;
+  // do not try to find more than 100 results
+  var MAX_RESULTS = 100;
+  var huid = 1;
+  var suid = 1;
+  var runs = 0;
+
+  this.find = function(query) {
+    var queries = splitQuery(query);
+    var regexps = buildRegexps(queries);
+    var highlighters = buildHilighters(queries);
+    var state = { from: 0, pass: 0, limit: MAX_RESULTS, n: suid++};
+    var _this = this;
+
+    this.currentSuid = state.n;
+
+    if (!query) return;
+
+    var run = function() {
+      // stop current search thread if new search started
+      if (state.n != _this.currentSuid) return;
+
+      var results =
+        performSearch(_this.data, regexps, queries, highlighters, state);
+      var hasMore = (state.limit > 0 && state.pass < 4);
+
+      triggerResults.call(_this, results, !hasMore);
+      if (hasMore) {
+        setTimeout(run, 2);
+      }
+      runs++;
+    };
+    runs = 0;
+
+    // start search thread
+    run();
+  }
+
+  /*  ----- Events ------  */
+  this.ready = function(fn) {
+    fn.huid = huid;
+    this.handlers.push(fn);
+  }
+
+  /*  ----- Utilities ------  */
+  function splitQuery(query) {
+    return query.split(/(\s+|::?|\(\)?)/).filter(function(string) {
+      return string.match(/\S/);
+    });
+  }
+
+  function buildRegexps(queries) {
+    return queries.map(function(query) {
+      return new RegExp(query.replace(/(.)/g, '([$1])([^$1]*?)'), 'i');
+    });
+  }
+
+  function buildHilighters(queries) {
+    return queries.map(function(query) {
+      return query.split('').map(function(l, i) {
+        return '\u0001$' + (i*2+1) + '\u0002$' + (i*2+2);
+      }).join('');
+    });
+  }
+
+  // function longMatchRegexp(index, longIndex, regexps) {
+  //     for (var i = regexps.length - 1; i >= 0; i--){
+  //         if (!index.match(regexps[i]) && !longIndex.match(regexps[i])) return false;
+  //     };
+  //     return true;
+  // }
+
+
+  /*  ----- Mathchers ------  */
+
+  /*
+   * This record matches if the index starts with queries[0] and the record
+   * matches all of the regexps
+   */
+  function matchPassBeginning(index, longIndex, queries, regexps) {
+    if (index.indexOf(queries[0]) != 0) return false;
+    for (var i=1, l = regexps.length; i < l; i++) {
+      if (!index.match(regexps[i]) && !longIndex.match(regexps[i]))
+        return false;
+    };
+    return true;
+  }
+
+  /*
+   * This record matches if the longIndex starts with queries[0] and the
+   * longIndex matches all of the regexps
+   */
+  function matchPassLongIndex(index, longIndex, queries, regexps) {
+    if (longIndex.indexOf(queries[0]) != 0) return false;
+    for (var i=1, l = regexps.length; i < l; i++) {
+      if (!longIndex.match(regexps[i]))
+        return false;
+    };
+    return true;
+  }
+
+  /*
+   * This record matches if the index contains queries[0] and the record
+   * matches all of the regexps
+   */
+  function matchPassContains(index, longIndex, queries, regexps) {
+    if (index.indexOf(queries[0]) == -1) return false;
+    for (var i=1, l = regexps.length; i < l; i++) {
+      if (!index.match(regexps[i]) && !longIndex.match(regexps[i]))
+        return false;
+    };
+    return true;
+  }
+
+  /*
+   * This record matches if regexps[0] matches the index and the record
+   * matches all of the regexps
+   */
+  function matchPassRegexp(index, longIndex, queries, regexps) {
+    if (!index.match(regexps[0])) return false;
+    for (var i=1, l = regexps.length; i < l; i++) {
+      if (!index.match(regexps[i]) && !longIndex.match(regexps[i]))
+        return false;
+    };
+    return true;
+  }
+
+
+  /*  ----- Highlighters ------  */
+  function highlightRegexp(info, queries, regexps, highlighters) {
+    var result = createResult(info);
+    for (var i=0, l = regexps.length; i < l; i++) {
+      result.title = result.title.replace(regexps[i], highlighters[i]);
+      result.namespace = result.namespace.replace(regexps[i], highlighters[i]);
+    };
+    return result;
+  }
+
+  function hltSubstring(string, pos, length) {
+    return string.substring(0, pos) + '\u0001' + string.substring(pos, pos + length) + '\u0002' + string.substring(pos + length);
+  }
+
+  function highlightQuery(info, queries, regexps, highlighters) {
+    var result = createResult(info);
+    var pos = 0;
+    var lcTitle = result.title.toLowerCase();
+
+    pos = lcTitle.indexOf(queries[0]);
+    if (pos != -1) {
+      result.title = hltSubstring(result.title, pos, queries[0].length);
+    }
+
+    result.namespace = result.namespace.replace(regexps[0], highlighters[0]);
+    for (var i=1, l = regexps.length; i < l; i++) {
+      result.title = result.title.replace(regexps[i], highlighters[i]);
+      result.namespace = result.namespace.replace(regexps[i], highlighters[i]);
+    };
+    return result;
+  }
+
+  function createResult(info) {
+    var result = {};
+    result.title = info[0];
+    result.namespace = info[1];
+    result.path = info[2];
+    result.params = info[3];
+    result.snippet = info[4];
+    result.badge = info[6];
+    return result;
+  }
+
+  /*  ----- Searching ------  */
+  function performSearch(data, regexps, queries, highlighters, state) {
+    var searchIndex = data.searchIndex;
+    var longSearchIndex = data.longSearchIndex;
+    var info = data.info;
+    var result = [];
+    var i = state.from;
+    var l = searchIndex.length;
+    var togo = CHUNK_SIZE;
+    var matchFunc, hltFunc;
+
+    while (state.pass < 4 && state.limit > 0 && togo > 0) {
+      if (state.pass == 0) {
+        matchFunc = matchPassBeginning;
+        hltFunc = highlightQuery;
+      } else if (state.pass == 1) {
+        matchFunc = matchPassLongIndex;
+        hltFunc = highlightQuery;
+      } else if (state.pass == 2) {
+        matchFunc = matchPassContains;
+        hltFunc = highlightQuery;
+      } else if (state.pass == 3) {
+        matchFunc = matchPassRegexp;
+        hltFunc = highlightRegexp;
+      }
+
+      for (; togo > 0 && i < l && state.limit > 0; i++, togo--) {
+        if (info[i].n == state.n) continue;
+        if (matchFunc(searchIndex[i], longSearchIndex[i], queries, regexps)) {
+          info[i].n = state.n;
+          result.push(hltFunc(info[i], queries, regexps, highlighters));
+          state.limit--;
+        }
+      };
+      if (searchIndex.length <= i) {
+        state.pass++;
+        i = state.from = 0;
+      } else {
+        state.from = i;
+      }
+    }
+    return result;
+  }
+
+  function triggerResults(results, isLast) {
+    this.handlers.forEach(function(fn) {
+      fn.call(this, results, isLast)
+    });
+  }
+}
+

data/html/table_of_contents.html

@@ -0,0 +1,365 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta charset="UTF-8">
+
+<title>Table of Contents - hookapp</title>
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+  var index_rel_prefix = "./";
+</script>
+
+<script src="./js/navigation.js" defer></script>
+<script src="./js/search.js" defer></script>
+<script src="./js/search_index.js" defer></script>
+<script src="./js/searcher.js" defer></script>
+<script src="./js/darkfish.js" defer></script>
+
+<link href="./css/fonts.css" rel="stylesheet">
+<link href="./css/rdoc.css" rel="stylesheet">
+
+
+<body id="top" class="table-of-contents">
+<main role="main">
+<h1 class="class">Table of Contents - hookapp</h1>
+
+<h2 id="pages">Pages</h2>
+<ul>
+  <li class="file">
+    <a href="README_rdoc.html">README</a>
+
+    <ul>
+      <li><a href="README_rdoc.html#label-hookapp">hookapp</a>
+      <li><a href="README_rdoc.html#label-hook+-+CLI+interface+for+Hook.app+-28macOS-29">hook - CLI interface for Hook.app (macOS)</a>
+      <li><a href="README_rdoc.html#label-Global+Options">Global Options</a>
+      <li><a href="README_rdoc.html#label--help">–help</a>
+      <li><a href="README_rdoc.html#label--version">–version</a>
+      <li><a href="README_rdoc.html#label-Commands">Commands</a>
+      <li><a href="README_rdoc.html#label-Command-3A+clip-7Ccp++FILE_OR_URL">Command: <code>clip|cp  FILE_OR_URL</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-a-7C--app+APP_NAME">-a|–app APP_NAME</a>
+      <li><a href="README_rdoc.html#label-m-7C--markdown">-m|–markdown</a>
+      <li><a href="README_rdoc.html#label-Command-3A+clone++SOURCE+TARGET">Command: <code>clone  SOURCE TARGET</code></a>
+      <li><a href="README_rdoc.html#label-Command-3A+find-7Csearch++-5BSEARCH_STRING-5D">Command: <code>find|search  [SEARCH_STRING]</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-o-7C--output_format+FORMAT">-o|–output_format FORMAT</a>
+      <li><a href="README_rdoc.html#label-f-7C--files_only">-f|–files_only</a>
+      <li><a href="README_rdoc.html#label-n-7C--names_only">-n|–names_only</a>
+      <li><a href="README_rdoc.html#label--null">–null</a>
+      <li><a href="README_rdoc.html#label-Command-3A+from++APPLICATION_NAME">Command: <code>from  APPLICATION_NAME</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-c-7C--copy">-c|–copy</a>
+      <li><a href="README_rdoc.html#label-m-7C--markdown">-m|–markdown</a>
+      <li><a href="README_rdoc.html#label-Command-3A+help++command">Command: <code>help  command</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-c">-c</a>
+      <li><a href="README_rdoc.html#label-Command-3A+link-7Cln++SOURCE...+TARGET">Command: <code>link|ln  SOURCE... TARGET</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-a-7C--all">-a|–all</a>
+      <li><a href="README_rdoc.html#label-p-7C--paste">-p|–paste</a>
+      <li><a href="README_rdoc.html#label-Command-3A+list-7Cls++-5BFILE_OR_URL-5D...">Command: <code>list|ls  [FILE_OR_URL]...</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-o-7C--output_format+FORMAT">-o|–output_format FORMAT</a>
+      <li><a href="README_rdoc.html#label-f-7C--files_only">-f|–files_only</a>
+      <li><a href="README_rdoc.html#label--null">–null</a>
+      <li><a href="README_rdoc.html#label-s-7C--select">-<a href="no-">s|–</a>select</a>
+      <li><a href="README_rdoc.html#label-Command-3A+open-7Cgui++FILE_OR_URL">Command: <code>open|gui  FILE_OR_URL</code></a>
+      <li><a href="README_rdoc.html#label-Command-3A+percent++STRING">Command: <code>percent  STRING</code></a>
+      <li><a href="README_rdoc.html#label-Commands">Commands</a>
+      <li><a href="README_rdoc.html#label-Command-3A+decode++STRING">Command: <code>decode  STRING</code></a>
+      <li><a href="README_rdoc.html#label-Command-3A+encode++STRING">Command: <code>encode  STRING</code></a>
+      <li><a href="README_rdoc.html#label-Command-3A+remove-7Crm++FILE_OR_URL...">Command: <code>remove|rm  FILE_OR_URL...</code></a>
+      <li><a href="README_rdoc.html#label-Options">Options</a>
+      <li><a href="README_rdoc.html#label-a-7C--all">-a|–all</a>
+      <li><a href="README_rdoc.html#label-f-7C--force">-f|–force</a>
+      <li><a href="README_rdoc.html#label-Command-3A+scripts++SHELL">Command: <code>scripts  SHELL</code></a>
+      <li><a href="README_rdoc.html#label-Command-3A+select++FILE_OR_URL">Command: <code>select  FILE_OR_URL</code></a>
+    </ul>
+  </li>
+</ul>
+
+<h2 id="classes">Classes and Modules</h2>
+<ul>
+  <li class="class">
+    <a href="App.html">App</a>
+  </li>
+  <li class="module">
+    <a href="GLI.html">GLI</a>
+  </li>
+  <li class="module">
+    <a href="GLI/Commands.html">GLI::Commands</a>
+  </li>
+  <li class="module">
+    <a href="GLI/Commands/Doc.html">GLI::Commands::Doc</a>
+  </li>
+  <li class="class">
+    <a href="GLI/Commands/MarkdownDocumentListener.html">GLI::Commands::MarkdownDocumentListener</a>
+  </li>
+  <li class="module">
+    <a href="Hook.html">Hook</a>
+  </li>
+  <li class="class">
+    <a href="HookApp.html">HookApp</a>
+  </li>
+  <li class="class">
+    <a href="Hooker.html">Hooker</a>
+  </li>
+  <li class="class">
+    <a href="String.html">String</a>
+  </li>
+</ul>
+
+<h2 id="methods">Methods</h2>
+<ul>
+
+  <li class="method">
+    <a href="Hooker.html#method-c-new">::new</a>
+    &mdash;
+    <span class="container">Hooker</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-c-new">::new</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-all_bookmarks">#all_bookmarks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-beginning">#beginning</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-bookmark_for">#bookmark_for</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-bookmark_from_app">#bookmark_from_app</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="String.html#method-i-cap">#cap</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="String.html#method-i-cap-21">#cap!</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="String.html#method-i-clip">#clip</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-clip_bookmark">#clip_bookmark</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-clone_hooks">#clone_hooks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-command">#command</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-commands">#commands</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-copy_bookmark">#copy_bookmark</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-decode">#decode</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-default_command">#default_command</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-delete_all_hooks">#delete_all_hooks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-delete_hooks">#delete_hooks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-encode">#encode</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-end_command">#end_command</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-end_commands">#end_commands</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-end_options">#end_options</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-ending">#ending</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="String.html#method-i-escape_quotes">#escape_quotes</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-flag">#flag</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-format_regex">#format_regex</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-get_hooks">#get_hooks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-link_all">#link_all</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-link_files">#link_files</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-linked_bookmarks">#linked_bookmarks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="String.html#method-i-nil_if_missing">#nil_if_missing</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-open_gui">#open_gui</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-open_linked">#open_linked</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-options">#options</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-output_array">#output_array</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-program_desc">#program_desc</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-program_long_desc">#program_long_desc</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-search_bookmarks">#search_bookmarks</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-search_name">#search_name</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-search_path_or_address">#search_path_or_address</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-select_hook">#select_hook</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="String.html#method-i-split_hook">#split_hook</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="String.html#method-i-split_hooks">#split_hooks</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-switch">#switch</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+
+  <li class="method">
+    <a href="String.html#method-i-valid_hook">#valid_hook</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="String.html#method-i-valid_hook-21">#valid_hook!</a>
+    &mdash;
+    <span class="container">String</span>
+
+  <li class="method">
+    <a href="HookApp.html#method-i-validate_format">#validate_format</a>
+    &mdash;
+    <span class="container">HookApp</span>
+
+  <li class="method">
+    <a href="GLI/Commands/MarkdownDocumentListener.html#method-i-version">#version</a>
+    &mdash;
+    <span class="container">GLI::Commands::MarkdownDocumentListener</span>
+</ul>
+</main>
+
+
+<footer id="validator-badges" role="contentinfo">
+  <p><a href="https://validator.w3.org/check/referer">Validate</a>
+  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.3.2.
+  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
+</footer>
+

data/lib/hook/hookapp.rb

@@ -233,7 +233,8 @@ class HookApp
     raise "Error processing available hooks" if options.empty?
 
     args = ['--layout=reverse-list',
-            '--header="esc: cancel, tab: multi-select, return: open > "',
+            '--header="esc: cancel, tab: multi-select, ctrl-a: select all, return: open"',
+            '--bind ctrl-a:select-all',
             '--prompt="  Select hooks > "',
             '--multi',
             '--tabstop=4',
@@ -246,16 +247,12 @@ class HookApp
     fzf = File.join(File.dirname(__FILE__), '../helpers/fuzzyfilefinder')
 
     sel = `echo #{Shellwords.escape(options.join("\n"))} | '#{fzf}' #{args.join(' ')}`.chomp
-    res = sel.split(/\n/).map { |s|
+    res = sel.split(/\n/).map do |s|
       ps = s.split(/\t/)
       { name: ps[0], path: ps[1], url: ps[2] }
-    }
-
-    if res.size == 0
-      raise 'Cancelled (empty response)'
     end
 
-    res
+    res || []
   end
 
   # Open the Hook GUI for browsing/performing actions on a file or url
@@ -281,9 +278,11 @@ class HookApp
       warn "No hooks found for #{url}"
     else
       res = select_hook(marks)
-      res.each {|mark|
-        `open '#{mark[:url]}'`
-      }
+      unless res.empty?
+        res.each {|mark|
+          `open '#{mark[:url]}'`
+        }
+      end
     end
   end
 

data/lib/hook/markdown_document_listener.rb

@@ -15,6 +15,7 @@ module GLI
         @io = File.new('README.md', 'w')
         @nest = '#'
         @arg_name_formatter = GLI::Commands::HelpModules::ArgNameFormatter.new
+        @parent_command = []
       end
 
       def beginning
@@ -26,6 +27,12 @@ module GLI
           @io.puts IO.read('CREDITS.md')
           @io.puts
         end
+
+        if File.exist?('AUTHORS.md')
+          @io.puts IO.read('AUTHORS.md')
+          @io.puts
+        end
+
         if File.exist?('LICENSE.md')
           @io.puts IO.read('LICENSE.md')
           @io.puts
@@ -89,7 +96,7 @@ module GLI
           name = "[no-]#{name}" if name.to_s.length > 1
           aliases = aliases.map { |_|  _.to_s.length > 1 ? "[no-]#{_}" : _ }
         end
-        invocations = ([name] + aliases).map { |_| "`" + add_dashes(_) + "`" }.join('|')
+        invocations = ([name] + aliases).map { |_| "`" + add_dashes(_).strip + "`" }.join('|')
         @io.puts header("#{invocations}", 2)
         @io.puts
         @io.puts String(desc).strip
@@ -109,8 +116,10 @@ module GLI
 
       # Gives you a command in the current context and creates a new context of this command
       def command(name, aliases, desc, long_desc, arg_name, arg_options)
+        @parent_command.push ([name] + aliases).join('|')
         arg_name_fmt = @arg_name_formatter.format(arg_name, arg_options, [])
-        @io.puts header("`$ #{@exe}` <mark>`#{([name] + aliases).join('|')}`</mark> `#{arg_name_fmt}`", 1)
+        arg_name_fmt = " `#{arg_name_fmt.strip}`" if arg_name_fmt
+        @io.puts header("`$ #{@exe}` <mark>`#{@parent_command.join(' ')}`</mark>#{arg_name_fmt}", 1)
         @io.puts
         @io.puts "*#{String(desc).strip}*"
         @io.puts
@@ -121,6 +130,7 @@ module GLI
 
       # Ends a command, and "pops" you back up one context
       def end_command(_name)
+        @parent_command.pop
         decrement_nest
         @io.puts "* * * * * *\n\n" unless @nest.size > 2
       end