Eightfold fetch!

This release restores full functionality for Vim 8 users (while maintaining it for Vim 7) and tries to future proof vim-fetch, as far as such a gross hack can be future proofed.

Added:

• :Fetch command for manual switching when the user’s Vim version does not support autocommands

Changed:

• buffer switching function fetch#buffer() needs a buffer name argument
• decoupled spec matchers from the autocommands used; this opens the avenue for allowing users to extend specs
• gF command is available even in Vim versions without autocommands
• documentation improvements

Fixed:

• Vim 8: only the first file would be correctly processed when opened via a vim shell command
• Vim 8: the argument list would not be updated correctly when processing buffers
• E325 if a swap file is found while loading a file
• errors while loading the file would stop processing of other buffers on startup

Removed:
Nothing

Continue fetching!

Added:

Nothing.

Fixed:

The dreaded “Press ENTER or type command to continue” prompt would appear when fetching a buffer and shortmess-=oO was set (Issue #8 – thanks to @tscheffe for both reporting and finding the root cause of the issue).

Removed:

Nothing.

Fetching Visuals

Added:

Nothing.

Fixed:

Various gF functionality glitches:

• unable to retrieve line-wise visual selections (due to a Vim bug, but still…)
• wrong content for block-wise visual selections
• occasional retrieval failures due to faulty multi-byte character handling logic

Removed:

Nothing.

gFetch Edition

Added:

• gF support: vim-fetch will now look for trailing jump specifications it understands when using Vim’s gF command, either in normal or visual mode
• API support for the above (fetch#cfile() and fetch#visual())
• support for jump specifications looking for method definitions or keywords
• support for pytest style method jump specifications based on the above – many thanks to @blueyed for submitting the original PR kicking this off (#3)
• vim-stay integration

Changed:

• buffer switching is now handled by fetch#buffer() and is current buffer only
• User autocommand events are now only fired if there is a defined matching autocommand – this removes the need to unsilent commands in those events
• documentation improvements

Fixed:

• replacing the spurious spec’ed buffer by the correct one would ignore the ++opt and +cmd options to edit commands
• documentation glitches

Removed:

• API function fetch#setpos() – this should have been private all along, really

The Refined Fetch

Added:

• centre the target line in the window after jumping
• autocommand API for fetch events (BufFetchPosPre and BufFetchPosPost)
• API for retrieving the known specs (fetch#specs)
• API for setting the cursor position (fetch#setpos – mainly groundwork for future extensions)

Fixed:

• autocommands triggering on file names starting with a spec-like pattern
• possible issues when force editing the non-spec'ed file with !
• files on the arglist not argedited when Vim is compiled -listcmds
• some glitches in the README

Changed:

• fetch triggers on BufNewFile instead of WinEnterand TabEnter (besides triggering on BufWinEnteras always); this should reduce the number of autocommand events processed.

Removed:

Nothing

The Well Rounded Fetch

Added:

• b:fetch_lastpos variable for integration with other plugins / scripts
• fetch#edit returns a boolean value
• fetch#edit throws an exception on invalid spec names
• extended help docs

Fixed:

• quixotic Netrw directory buffer behaviour on directories whose name matches a spec
• other potential corner cases with special buffers
• plugin loading even when Vim was compiled without +autocmd
• plugin loading in versions of Vim it is not compatible with
• plugin potentially failing to load when &cpo was set to non-standard values
• outdated version number in code and help

Removed:

Nothing

Plan 9 from Outer Fetch

Added:

• handle Plan 9 style line jump specs (path/to/file.ext:#lnum) as per #2
• more granular autocommand event patterns
• troubleshooting section in help

Fixed:

• parens enclosed spec matching failing due to broken regex pattern
• failure to change arglist when the buffer name contains a command line file token (like #)

Removed:

Nothing

Documentation fixes

Added:

Nothing

Fixed:

• removed duplicate vim-fetch help tags (fixes #1)
• unified inconsistent vim-fetch-intro[duction] help tag
• corrected in-code documentation

Removed:

Nothing

Initial release

Please refer to the main repo page and the plugin help for details.