hookapp 2.0.7 → 2.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 477033a68381137c2a2c67a486896da5d1210fb8d261950beff09df64b0b6566
-  data.tar.gz: b3de73462923bc91c88c7ab58b3c8fc7195ffe19cb4d09bef2acd3d0e579e7d5
+  metadata.gz: 17971d6f699aa3ec68b8b4d9903b112858c04484747c15117cea24b90839a4c9
+  data.tar.gz: 3b4551d1d1553e4c70129341848584a1542bc4af7c00e2cacb1dd6bf540bf514
 SHA512:
-  metadata.gz: c64691a5a0ddc289590408efd13936e352962838f182ec905dfd8ac706197e6f5538d2cbe2a108b1a72f7ace459d90d36d1b789cf48bc7a6871391c871698a24
-  data.tar.gz: 3b91f789621f9cf091793ac75d9d44b61c09c2c07ae34fc4e84495ee670c2016c8583b71d00c067917f12aff77e603b389773a1cf4acb8a3a12bcd9cea2ac1bb
+  metadata.gz: ad634683684e623978d4b60ad22beea237e228ae9ff3dc999e50e0083e2eba59b192a9e928e26057082d23124e2714c7f41b68ebb0ab68320239611959c521b9
+  data.tar.gz: 336ee727add0a904bbf81a97e4327596e0936af32dd7bb66b6cf580ba9d35828212ee7c18a1ec8d87841c1edd7a20d1c30e24f8f2d7803bdcc8dd66986dd3f92

data/AUTHORS.md

@@ -0,0 +1,4 @@
+## Authors
+
+- Brett Terpstra <me@brettterpstra.com>
+- Josh Nichols <joshua.nichols@gmail.com>

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+#### 2.0.8
+
+- Bug fixes
+- New tests
+
 #### 2.0.3
 
 - Incorporate `fzf` for selecting and filtering hooks

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Brett Terpstra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -3,7 +3,8 @@
 CLI interface for Hook.app (macOS)
 
 > Hook.app is a productivity tool for macOS <https://hookproductivity.com/>.
-    This gem includes a `hook` binary that allows interaction with the features of Hook.app.
+
+This gem includes a `hook` binary that allows interaction with the features of Hook.app.
 
 *v2.0.7*
 
@@ -100,13 +101,13 @@ Display the program version
 
 ## Commands
 
-### `$ hook` <mark>`clip|cp`</mark> ` FILE_OR_URL`
+### `$ hook` <mark>`clip|cp`</mark> `FILE_OR_URL`
 
 *Copy Hook URL for file/url to clipboard*
 
 > Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
 > 
-> The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL),
+> The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL`,
 > or to paste into another app as a link. Use the -m flag to copy a full Markdown link.
 
 #### Options
@@ -121,15 +122,17 @@ Copy as Markdown
 
 * * * * * *
 
-### `$ hook` <mark>`clone`</mark> ` SOURCE TARGET`
+### `$ hook` <mark>`clone`</mark> `SOURCE TARGET`
 
 *Clone all hooks from one file or url onto another*
 
-> Copy all the files and urls that the first file is hooked to onto another file. Exactly two arguments (SOURCE, TARGET) required.
+> Copy all the files and urls that the first file is hooked to onto another file.
+> 
+> Exactly two arguments (SOURCE, TARGET) required.
 
 * * * * * *
 
-### `$ hook` <mark>`find|search`</mark> ` SEARCH_STRING`
+### `$ hook` <mark>`find|search`</mark> `[SEARCH_STRING]`
 
 *Search bookmarks*
 
@@ -139,7 +142,7 @@ Copy as Markdown
 
 #### Options
 
-##### `-o` | `--output_format` format
+##### `-o` | `--output_format` FORMAT
 
 Output format [(h)ooks, (p)aths, (m)arkdown, (v)erbose]
 
@@ -159,7 +162,7 @@ Separate results with NULL separator, only applies with "paths" output for singl
 
 * * * * * *
 
-### `$ hook` <mark>`from`</mark> ` APPLICATION_NAME`
+### `$ hook` <mark>`from`</mark> `APPLICATION_NAME`
 
 *Get a Hook URL for the frontmost window of an app*
 
@@ -180,7 +183,7 @@ Output as Markdown
 
 * * * * * *
 
-### `$ hook` <mark>`help`</mark> ` command`
+### `$ hook` <mark>`help`</mark> `command`
 
 *Shows a list of commands or help for one command*
 
@@ -194,7 +197,7 @@ List commands one per line, to assist with shell completion
 
 * * * * * *
 
-### `$ hook` <mark>`link|ln`</mark> ` SOURCE [SOURCE...] TARGET`
+### `$ hook` <mark>`link|ln`</mark> `SOURCE... TARGET`
 
 *Create bidirectional hooks between two or more files/urls*
 
@@ -218,7 +221,7 @@ Paste URL from clipboard
 
 * * * * * *
 
-### `$ hook` <mark>`list|ls`</mark> ` FILE_OR_URL [FILE_OR_URL...]`
+### `$ hook` <mark>`list|ls`</mark> `[FILE_OR_URL]...`
 
 *List hooks on a file or url*
 
@@ -228,7 +231,7 @@ Paste URL from clipboard
 
 #### Options
 
-##### `-o` | `--output_format` format
+##### `-o` | `--output_format` FORMAT
 
 Output format [(h)ooks, (p)aths, (m)arkdown, (v)erbose]
 
@@ -250,15 +253,17 @@ Generate a menu to select hook(s) for opening
 
 * * * * * *
 
-### `$ hook` <mark>`open|gui`</mark> ` FILE_OR_URL`
+### `$ hook` <mark>`open|gui`</mark> `FILE_OR_URL`
 
 *Open the specified file or url in Hook GUI*
 
-> Opens Hook.app on the specified file/URL for browsing and performing actions. Exactly one argument (File/URL) required.
+> Opens Hook.app on the specified file/URL for browsing and performing actions.
+> 
+> Exactly one argument (File/URL) required.
 
 * * * * * *
 
-### `$ hook` <mark>`percent`</mark> ` STRING`
+### `$ hook` <mark>`percent`</mark> `STRING`
 
 *Percent encode/decode a string*
 
@@ -266,17 +271,17 @@ Generate a menu to select hook(s) for opening
 
 #### Commands
 
-##### `$ hook` <mark>`decode`</mark> ` STRING`
+##### `$ hook` <mark>`percent decode`</mark> `STRING`
 
 *decode a percent-encoded string*
 
-##### `$ hook` <mark>`encode`</mark> ` STRING`
+##### `$ hook` <mark>`percent encode`</mark> `STRING`
 
 *percent encode a string*
 
 * * * * * *
 
-### `$ hook` <mark>`remove|rm`</mark> ` ITEM_1 ITEM_2`
+### `$ hook` <mark>`remove|rm`</mark> `FILE_OR_URL...`
 
 *Remove a hook between two files/urls*
 
@@ -296,7 +301,7 @@ Remove ALL links on files, requires confirmation
 
 * * * * * *
 
-### `$ hook` <mark>`scripts`</mark> ` SHELL`
+### `$ hook` <mark>`scripts`</mark> `SHELL`
 
 *Shell completion examples*
 
@@ -304,7 +309,7 @@ Remove ALL links on files, requires confirmation
 
 * * * * * *
 
-### `$ hook` <mark>`select`</mark> ` FILE_OR_URL`
+### `$ hook` <mark>`select`</mark> `FILE_OR_URL`
 
 *Select from hooks on a file/url and open in default application*
 
@@ -315,6 +320,11 @@ Remove ALL links on files, requires confirmation
 * * * * * *
 
 #### [Default Command] help
+## Authors
+
+- Brett Terpstra <me@brettterpstra.com>
+- Josh Nichols <joshua.nichols@gmail.com>
+
 ## Credits
 
 HookApp embeds [Fuzzy Finder](https://github.com/junegunn/fzf) under the [MIT License](https://github.com/junegunn/fzf/blob/master/LICENSE)
@@ -348,5 +358,5 @@ This software is licensed under the MIT License.
 	THE SOFTWARE.
 
 
-Documentation generated 2021-09-25 07:37
+Documentation generated 2021-09-26 07:50
 

data/bin/hook

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#!/usr/bin/env ruby -W1
 # frozen_string_literal: true
 
 require 'hook'
@@ -10,7 +10,8 @@ class App
 
   program_desc 'CLI interface for Hook.app (macOS)'
   program_long_desc 'Hook.app is a productivity tool for macOS <https://hookproductivity.com/>.
-    This gem includes a `hook` binary that allows interaction with the features of Hook.app.'
+
+This gem includes a `hook` binary that allows interaction with the features of Hook.app.'
   default_command 'help'
   autocomplete_commands = true
   synopsis_format(:terminal)
@@ -24,12 +25,10 @@ class App
   stdin = nil
 
   desc 'List hooks on a file or url'
-  long_desc %{
-Output a list of all hooks attached to given url(s) or file(s) in the specified format (default "paths").
-
-Run `hook list` with no file/url argument to list all bookmarks.}
+  long_desc %(Output a list of all hooks attached to given url(s) or file(s) in the specified format (default "paths").
 
-  arg_name 'FILE_OR_URL [FILE_OR_URL...]'
+Run `hook list` with no file/url argument to list all bookmarks.)
+  arg_name 'FILE_OR_URL', [:optional, :multiple]
   command %i[list ls] do |c|
     c.desc 'Generate a menu to select hook(s) for opening'
     c.long_desc 'This option is a shortcut to `hook select` and overrides any other arguments.'
@@ -44,20 +43,22 @@ Run `hook list` with no file/url argument to list all bookmarks.}
     valid_formats = %w[hooks paths markdown verbose]
     fmt_list = valid_formats.map { |fmt| fmt.sub(/^(.)(.*?)$/, '(\1)\2') }.join(', ')
     c.desc "Output format [#{fmt_list}]"
-    c.flag %i[o output_format], { arg_name: 'format', default_value: 'paths' }
+    c.arg_name 'FORMAT'
+    c.flag %i[o output_format], { arg_name: 'FORMAT', default_value: 'paths' }
 
     c.action do |_global_options, options, args|
       if options[:s]
-        return hookapp.open_linked(args[0])
-      end
-      valid_format = hookapp.validate_format(options[:o], valid_formats)
-      exit_now!("Invalid output format: \"#{options[:o]}\"", 6) unless valid_format
+        hookapp.open_linked(args[0])
+      else
+        valid_format = hookapp.validate_format(options[:o], valid_formats)
+        help_now!("Invalid output format: \"#{options[:o]}\"", 6) unless valid_format
 
-      result = hookapp.linked_bookmarks(args, { files_only: options[:f],
-                                               format: valid_format,
-                                               null_separator: options[:null] })
+        result = hookapp.linked_bookmarks(args, { files_only: options[:f],
+                                                 format: valid_format,
+                                                 null_separator: options[:null] })
 
-      puts result
+        puts result
+      end
     end
   end
 
@@ -65,25 +66,21 @@ Run `hook list` with no file/url argument to list all bookmarks.}
   # the full shell name as the extension, e.g. "hook_completion.bash".
   desc 'Shell completion examples'
   valid_shells = %w[bash zsh fish]
-  long_desc %{
-Output completion script example for the specified shell (#{valid_shells.join(', ')})
-  }
+  long_desc %(Output completion script example for the specified shell (#{valid_shells.join(', ')}))
   arg_name 'SHELL'
   command %i[scripts] do |c|
     c.action do |_global_options, _options, args|
       if args.length > 1
-        exit_now!("Invalid number of arguments, (expected 1)", 5)
+        help_now!('Invalid number of arguments, (expected 1)', 5)
       elsif args.nil? || args.empty?
-        exit_now!("Specify a shell (#{valid_shells.join(', ')})", 0)
+        help_now!("Specify a shell (#{valid_shells.join(', ')})", 0)
+      elsif valid_shells.include?(args[0])
+        base_dir = File.expand_path(File.join(File.dirname(__FILE__), '../lib/completion'))
+        completion = File.join(base_dir, "hook_completion.#{args[0]}")
+        script = IO.read(completion)
+        $stdout.puts script
       else
-        if valid_shells.include?(args[0])
-          base_dir = File.expand_path(File.join(File.dirname(__FILE__), '../lib/completion'))
-          completion = File.join(base_dir, "hook_completion.#{args[0]}")
-          script = IO.read(completion)
-          $stdout.puts script
-        else
-          exit_now!("Invalid shell name, must be one of #{valid_shells.join(', ')}", 1)
-        end
+        help_now!("Invalid shell name, must be one of #{valid_shells.join(', ')}", 1)
       end
     end
   end
@@ -91,11 +88,10 @@ Output completion script example for the specified shell (#{valid_shells.join(',
 
 
   desc 'Search bookmarks'
-  long_desc %{
-Search bookmark urls and names for a string and output in specified format (default "paths").
+  long_desc %(Search bookmark urls and names for a string and output in specified format (default "paths").
 
-Run `hook find` with no search argument to list all bookmarks.}
-  arg_name 'SEARCH_STRING'
+Run `hook find` with no search argument to list all bookmarks.)
+  arg_name 'SEARCH_STRING', :optional
   command %i[find search] do |c|
     c.desc 'Output only bookmarks with file paths (exclude e.g. emails)'
     c.switch %i[f files_only], { negatable: false, default_value: false }
@@ -107,7 +103,7 @@ Run `hook find` with no search argument to list all bookmarks.}
     fmt_list = valid_formats.map { |fmt| fmt.sub(/^(.)(.*?)$/, '(\1)\2') }.join(', ')
 
     c.desc "Output format [#{fmt_list}]"
-    c.flag %i[o output_format], { arg_name: 'format', default_value: 'paths' }
+    c.flag %i[o output_format], { arg_name: 'FORMAT', default_value: 'paths' }
 
     c.desc "Search only bookmark names"
     c.switch %i[n names_only], { negatable: false, default_value: false }
@@ -126,16 +122,15 @@ Run `hook find` with no search argument to list all bookmarks.}
   end
 
   desc 'Create bidirectional hooks between two or more files/urls'
-  long_desc %{
-If two files/urls are provided, links will be bi-directional.
+  long_desc 'If two files/urls are provided, links will be bi-directional.
 If three or more are provided, `link` defaults to creating bi-directional
 links between each file and the last file in the list. Use `-a` to create
 bi-directional links between every file in the list.
 
 If using `--paste`, the URL/hook link in the clipboard will be used as one argument,
 to be combined with one or more file/url arguments.
-  }
-  arg_name 'SOURCE [SOURCE...] TARGET'
+  '
+  arg_name 'SOURCE... TARGET'
   command %i[link ln] do |c|
     c.desc 'Link every listed file or url to every other'
     c.switch %i[a all],  { negatable: false, default_value: false }
@@ -161,12 +156,10 @@ to be combined with one or more file/url arguments.
   end
 
   desc 'Copy Hook URL for file/url to clipboard'
-  long_desc %{
-Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
+  long_desc %{Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
 
-The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL),
-or to paste into another app as a link. Use the -m flag to copy a full Markdown link.
-  }
+The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL`,
+or to paste into another app as a link. Use the -m flag to copy a full Markdown link.}
   arg_name 'FILE_OR_URL'
   command %i[clip cp] do |c|
     c.desc 'Copy as Markdown'
@@ -187,12 +180,10 @@ or to paste into another app as a link. Use the -m flag to copy a full Markdown
   end
 
   desc 'Get a Hook URL for the frontmost window of an app'
-  long_desc %{
-Specify an application by name (without '.app') to bring that app to the foreground and create a bookmark
+  long_desc %(Specify an application by name (without '.app') to bring that app to the foreground and create a bookmark
 for the active document, note, task, etc., returning a Hook URL.
 
-Use -m to get the response as Markdown, and/or -c to copy the result directly to the clipboard.
-  }
+Use -m to get the response as Markdown, and/or -c to copy the result directly to the clipboard.)
   arg_name 'APPLICATION_NAME'
   command %i[from] do |c|
     c.desc 'Output as Markdown'
@@ -209,12 +200,10 @@ Use -m to get the response as Markdown, and/or -c to copy the result directly to
   end
 
   desc 'Remove a hook between two files/urls'
-  long_desc %{
-Remove a hook between two files or URLs. If you use --all, all hooks on a given file will be removed.
+  long_desc %(Remove a hook between two files or URLs. If you use --all, all hooks on a given file will be removed.
 
-If --all isn't specified, exactly two arguments (Files/URLs) are required.
-  }
-  arg_name 'ITEM_1 ITEM_2'
+If --all isn't specified, exactly two arguments (Files/URLs) are required.)
+  arg_name 'FILE_OR_URL', :multiple
   command %i[remove rm] do |c|
     c.desc 'Remove ALL links on files, requires confirmation'
     c.switch %i[a all], { negatable: false, default_value: false }
@@ -227,9 +216,9 @@ If --all isn't specified, exactly two arguments (Files/URLs) are required.
   end
 
   desc 'Clone all hooks from one file or url onto another'
-  long_desc %{
-Copy all the files and urls that the first file is hooked to onto another file. Exactly two arguments (SOURCE, TARGET) required.
-  }
+  long_desc 'Copy all the files and urls that the first file is hooked to onto another file.
+
+Exactly two arguments (SOURCE, TARGET) required.'
   arg_name 'SOURCE TARGET'
   command %i[clone] do |c|
     c.action do |_global_options, _options, args|
@@ -241,35 +230,36 @@ Copy all the files and urls that the first file is hooked to onto another file.
   end
 
   desc 'Select from hooks on a file/url and open in default application'
-  long_desc %{
-If the target file/URL has hooked items, a menu will be provided. Selecting one or more files
+  long_desc %(If the target file/URL has hooked items, a menu will be provided. Selecting one or more files
 from this menu will open the item(s) using the default application assigned to the
-filetype by macOS. Allows multiple selections with tab key, and type-ahead fuzzy filtering of results.
-}
+filetype by macOS. Allows multiple selections with tab key, and type-ahead fuzzy filtering of results.)
   arg_name 'FILE_OR_URL'
   command %i[select] do |c|
     c.action do |_global_options, _options, args|
-      exit_now!("Wrong number of arguments. One file path or url required (#{args.length} given)", 5) if args.length != 1
+      help_now!("Wrong number of arguments. One file path or url required (#{args.length} given)", 5) if args.length != 1
 
       hookapp.open_linked(args[0])
     end
   end
 
   desc 'Open the specified file or url in Hook GUI'
-  long_desc %{
-Opens Hook.app on the specified file/URL for browsing and performing actions. Exactly one argument (File/URL) required.
-  }
+  long_desc 'Opens Hook.app on the specified file/URL for browsing and performing actions.
+
+Exactly one argument (File/URL) required.'
   arg_name 'FILE_OR_URL'
   command %i[open gui] do |c|
     c.action do |_global_options, _options, args|
-      exit_now!("Wrong number of arguments. One file path or url required (#{args.length} given)", 5) if args.length != 1
+      if args.length != 1
+        help_now!("Wrong number of arguments. One file path
+                or url required (#{args.length} given)", 5)
+      end
 
       hookapp.open_gui(args[0])
     end
   end
 
   desc 'Percent encode/decode a string'
-  long_desc %{Use encode or decode to apply Hook's url encoding to a string argument. Use '-' to read input from STDIN.}
+  long_desc %(Use encode or decode to apply Hook's url encoding to a string argument. Use '-' to read input from STDIN.)
   arg_name 'STRING'
   command :percent do |c|
     c.desc 'percent encode a string'
@@ -279,7 +269,7 @@ Opens Hook.app on the specified file/URL for browsing and performing actions. Ex
         if stdin
           string = stdin
         else
-          exit_now!('no string provided') unless args.size.positive?
+          help_now!('No string provided') unless args.size.positive?
 
           string = args.join(' ').strip
         end
@@ -295,7 +285,7 @@ Opens Hook.app on the specified file/URL for browsing and performing actions. Ex
         if stdin
           string = stdin
         else
-          exit_now! ('no string provided') unless args.size.positive?
+          help_now!('no string provided') unless args.size.positive?
 
           string = args.join(' ').strip
         end

data/hook.rdoc

@@ -1,7 +1,8 @@
 == hook - CLI interface for Hook.app (macOS)
 
 Hook.app is a productivity tool for macOS <https://hookproductivity.com/>.
-    This gem includes a `hook` binary that allows interaction with the features of Hook.app.
+
+This gem includes a `hook` binary that allows interaction with the features of Hook.app.
 
 v2.0.7
 
@@ -22,7 +23,7 @@ Copy Hook URL for file/url to clipboard
 
 Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
 
-The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL),
+The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL`,
 or to paste into another app as a link. Use the -m flag to copy a full Markdown link.
 ===== Options
 ===== -a|--app APP_NAME
@@ -40,15 +41,17 @@ Copy as Markdown
 ==== Command: <tt>clone  SOURCE TARGET</tt>
 Clone all hooks from one file or url onto another
 
-Copy all the files and urls that the first file is hooked to onto another file. Exactly two arguments (SOURCE, TARGET) required.
-==== Command: <tt>find|search  SEARCH_STRING</tt>
+Copy all the files and urls that the first file is hooked to onto another file.
+
+Exactly two arguments (SOURCE, TARGET) required.
+==== Command: <tt>find|search  [SEARCH_STRING]</tt>
 Search bookmarks
 
 Search bookmark urls and names for a string and output in specified format (default "paths").
 
 Run `hook find` with no search argument to list all bookmarks.
 ===== Options
-===== -o|--output_format format
+===== -o|--output_format FORMAT
 
 Output format [(h)ooks, (p)aths, (m)arkdown, (v)erbose]
 
@@ -98,7 +101,7 @@ List commands one per line, to assist with shell completion
 
 
 
-==== Command: <tt>link|ln  SOURCE [SOURCE...] TARGET</tt>
+==== Command: <tt>link|ln  SOURCE... TARGET</tt>
 Create bidirectional hooks between two or more files/urls
 
 If two files/urls are provided, links will be bi-directional.
@@ -119,14 +122,14 @@ Paste URL from clipboard
 
 
 
-==== Command: <tt>list|ls  FILE_OR_URL [FILE_OR_URL...]</tt>
+==== Command: <tt>list|ls  [FILE_OR_URL]...</tt>
 List hooks on a file or url
 
 Output a list of all hooks attached to given url(s) or file(s) in the specified format (default "paths").
 
 Run `hook list` with no file/url argument to list all bookmarks.
 ===== Options
-===== -o|--output_format format
+===== -o|--output_format FORMAT
 
 Output format [(h)ooks, (p)aths, (m)arkdown, (v)erbose]
 
@@ -151,7 +154,9 @@ This option is a shortcut to `hook select` and overrides any other arguments.
 ==== Command: <tt>open|gui  FILE_OR_URL</tt>
 Open the specified file or url in Hook GUI
 
-Opens Hook.app on the specified file/URL for browsing and performing actions. Exactly one argument (File/URL) required.
+Opens Hook.app on the specified file/URL for browsing and performing actions.
+
+Exactly one argument (File/URL) required.
 ==== Command: <tt>percent  STRING</tt>
 Percent encode/decode a string
 
@@ -165,7 +170,7 @@ decode a percent-encoded string
 percent encode a string
 
 
-==== Command: <tt>remove|rm  ITEM_1 ITEM_2</tt>
+==== Command: <tt>remove|rm  FILE_OR_URL...</tt>
 Remove a hook between two files/urls
 
 Remove a hook between two files or URLs. If you use --all, all hooks on a given file will be removed.