]> git.wincent.com - ferret.git/log
3 months agorefactor: use simpler async support check for Vim main master
Greg Hurrell [Thu, 8 Dec 2022 20:33:01 +0000 (21:33 +0100)] 
refactor: use simpler async support check for Vim

Closes: https://github.com/wincent/ferret/issues/86
9 months agofeat: add `g:FerretCommandNames`
Greg Hurrell [Sun, 12 Jun 2022 17:08:21 +0000 (19:08 +0200)] 
feat: add `g:FerretCommandNames`

Closes: https://github.com/wincent/ferret/issues/75
Note that as usual, I had headaches getting a working `docvim`
installation in order to update the docs.

In 35757c7c9364d940efd8a46877acde04193819c2, the problem was that the
remote site I was trying to update GHC from was suffering from 503
errors, and I was able to get things working on Arch Linux where I had a
working copy lying around.

Today, back on macOS, I tried a few things:

    rm -r ~/.cabal

but every variation of building I tried would fail with a Happy-related
error. As noted here:


> a pre-built Happy is required to build the full version of Happy

In the end, I got it working with:

    cabal build -f -bootstrap
    cabal install -f -bootstrap
    bin/docvim \
            -c ~/.config/nvim/pack/bundle/opt/ferret \
            ~/.config/nvim/pack/bundle/opt/ferret/README.md \

11 months agodocs: update HISTORY section
Greg Hurrell [Sun, 17 Apr 2022 21:23:21 +0000 (23:23 +0200)] 
docs: update HISTORY section

Done on my Arch Linux box with:

    docvim \
        -c ~/.config/nvim/pack/bundle/opt/ferret \
        ~/.config/nvim/pack/bundle/opt/ferret/README.md \

because, as noted in d8ebfb16262a5175fdd63c97085ebc3116221b8f, I have a
working copy of Docvim stashed away at `~/bin/docvim`.

I first tried to do this on my macOS machine, but seems all my
Stack/Haskell tooling got borked in the move to Monterrey. I did a `brew
reinstall ghc` and `brew reinstall stack` there, but `bin/build` dies
trying to download a version of GHC, as shown by these excerpts:

    host                 = "downloads.haskell.org"
    path                 = "/~ghc/7.10.3/ghc-7.10.3b-x86_64-apple-darwin.tar.bz2"

    503 Backend is unhealthy

So be it, jedi.

11 months agofix: don't E684 if quickfix listing is empty
Greg Hurrell [Sun, 17 Apr 2022 21:06:19 +0000 (23:06 +0200)] 
fix: don't E684 if quickfix listing is empty

As noted here:


if the listing is entirely empty and you try to delete something (eg.
with `dd`), we would cause Vim to complain thusly:

    E684: list index out of range: 0

11 months agofix: avoid Vimscript footgun
Greg Hurrell [Sun, 17 Apr 2022 21:03:56 +0000 (23:03 +0200)] 
fix: avoid Vimscript footgun

We can't do a truthiness check for a Vimscript dictionary. ie. if the
quickfix listing has items in it, the `filter()` call would die with:

    E728: Using a Dictionary as a Number

So, we can't just do `v:val`. We can't do `v:val != 0` either, because
Vim will say:

    E735: Can only compare Dictionary with Dictionary

A user-hostile programming language, if ever there was one (well,
AppleScript manages to be even more hostile, but still...)

11 months agofix: avoid E42 error when deleting last quickfix entry
Greg Hurrell [Sun, 17 Apr 2022 20:47:36 +0000 (22:47 +0200)] 
fix: avoid E42 error when deleting last quickfix entry

After deleting the last item in the quickfix listing using Ferret (eg.
with `dd`), we would try to go to the next entry, but given that there
is none, Vim would print:

    E42: No Errors

Repro steps from ticket:

1.  Put one item in quickfix list with:

        :call setqflist([{'text': 'aaa', 'type': 'w'}], 'a')

2.  Open the listing:


3.  Delete the entry with `dd`.

Closes: https://github.com/wincent/ferret/issues/83
13 months agofix: rg v13.0.0 hang when passing additional options that take arguments next
Greg Hurrell [Sat, 29 Jan 2022 22:57:42 +0000 (23:57 +0100)] 
fix: rg v13.0.0 hang when passing additional options that take arguments

Given a command like:

    :Ack TODO --type go

The logic would see:

- `TODO` and consider it a search term
- `--type` and consider it an option
- `go` and consider it a path

And so fail to append the necessary ".", causing `rg` to fail in Neovim
as described in:


One workaround is to explicitly add the ".":

    :Ack TODO --type go .

Another is to force Ferret to see `--type go` as a single option and
not an option-followed-by-a-path with:

    :Ack TODO --type=go

This commit attempts to avoid the need for such workarounds by teaching
Ferret about which commands go with arguments. The solution is by no
means perfect, as we are _not_ implementing a full options parser, but
in my brief testing it at least mitigates the worst symptom of the
problem; namely, the rather unpleasant and inscrutable error:

    Error detected while processing function ferret#private#ack[11]..ferret#private#nvim#search[1]..ferret#pri
    line    3:
    E474: Invalid argument

Closes: https://github.com/wincent/ferret/issues/82
19 months agodocs: format leader with backticks
Greg Hurrell [Fri, 6 Aug 2021 09:15:31 +0000 (11:15 +0200)] 
docs: format leader with backticks

This looks better in both Markdown on GitHub and in Vim's own 'help'
filetype syntax.

19 months agodocs: fix a minor typo in the docs
Greg Hurrell [Fri, 6 Aug 2021 09:01:55 +0000 (11:01 +0200)] 
docs: fix a minor typo in the docs

19 months agofeat: add `<Plug>(FerretBack)`, `<Plug>(FerretBlack)`, `<Plug>(FerretQuack)`
Greg Hurrell [Fri, 6 Aug 2021 08:31:20 +0000 (10:31 +0200)] 
feat: add `<Plug>(FerretBack)`, `<Plug>(FerretBlack)`, `<Plug>(FerretQuack)`

These aren't strictly needed because you can make your own mappings
without them, but the fact that they don't exist may cause confusion,
even for me, as seen in the related issue.

Side note: I'm hacking on a Rust rewrite of `docvim` on this machine
(the Arch Linux box), so I needed to switch back to the `haskell` branch
to be able to generate these updates. These are the commands I ran:

    $ bin/build
    $ bin/docvim -v \
               -c ~/.config/nvim/pack/bundle/opt/ferret \
               ~/.config/nvim/pack/bundle/opt/ferret/README.md \

To avoid the need to switch branches in the future, going to do this
ghastly hack now:

    $ cp ./.stack-work/install/x86_64-linux-tinfo6/6496d02f2348a6142a8c6ecb42e6438cffcd197b0d048b4873a88b88b39c503e/7.10.3/bin/docvim ~/bin/

Bit worried that might stop working in the future because it is not
statically linked and I'm not confident that I'll be able to build this
package again in the future:

    $ file ./.stack-work/install/x86_64-linux-tinfo6/6496d02f2348a6142a8c6ecb42e6438cffcd197b0d048b4873a88b88b39c503e/7.10.3/bin/docvim
    ./.stack-work/install/x86_64-linux-tinfo6/6496d02f2348a6142a8c6ecb42e6438cffcd197b0d048b4873a88b88b39c503e/7.10.3/bin/docvim: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, BuildID[sha1]=82e97c115cb0a6c4fac8eeab9a03a2e0e2325ed9, for GNU/Linux 4.4.0, stripped

There's also:

    $ file ./.stack-work/dist/x86_64-linux-tinfo6/Cabal-
    ./.stack-work/dist/x86_64-linux-tinfo6/Cabal- ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, BuildID[sha1]=82e97c115cb0a6c4fac8eeab9a03a2e0e2325ed9, for GNU/Linux 4.4.0, with debug_info, not stripped

(ie. same, with debug symbols)

`ldd` reports these link targets:

    $ ldd ./.stack-work/install/x86_64-linux-tinfo6/6496d02f2348a6142a8c6ecb42e6438cffcd197b0d048b4873a88b88b39c503e/7.10.3/bin/docvim

        linux-vdso.so.1 (0x00007ffe1d7fc000)
        librt.so.1 => /usr/lib/librt.so.1 (0x00007fa5ed433000)
        libutil.so.1 => /usr/lib/libutil.so.1 (0x00007fa5ed42c000)
        libdl.so.2 => /usr/lib/libdl.so.2 (0x00007fa5ed425000)
        libpthread.so.0 => /usr/lib/libpthread.so.0 (0x00007fa5ed404000)
        libgmp.so.10 => /usr/lib/libgmp.so.10 (0x00007fa5ed364000)
        libm.so.6 => /usr/lib/libm.so.6 (0x00007fa5ed220000)
        libc.so.6 => /usr/lib/libc.so.6 (0x00007fa5ed054000)
        /lib64/ld-linux-x86-64.so.2 => /usr/lib64/ld-linux-x86-64.so.2 (0x00007fa5ed460000)

Based on my reading of:


it's simply not worth going further down this path. All the proposed
solutions have unpleasant caveats, AFAICT.

Closes: https://github.com/wincent/ferret/issues/79
20 months agodocs: prepare HISTORY section for further development
Greg Hurrell [Fri, 9 Jul 2021 18:05:47 +0000 (20:05 +0200)] 
docs: prepare HISTORY section for further development

Normally I would initialize this lazily when I make the next change, but
doing it eagerly this time because I just installed a pre-push hook for
this repo on this machine that will keep `main` and `master` in sync
whenever I push, and I want to see it working...

20 months agodocs: prepare 5.1 release notes 5.1
Greg Hurrell [Fri, 9 Jul 2021 17:58:09 +0000 (19:58 +0200)] 
docs: prepare 5.1 release notes

20 months agofix: make hacked rg output look nicer
Greg Hurrell [Fri, 9 Jul 2021 17:54:09 +0000 (19:54 +0200)] 
fix: make hacked rg output look nicer

As explained in the comment, if we add "." to the `rg` invocation in
order to work around the new behavior, we wind up with ugly results in
the quickfix listing:


instead of:


My first thought was to just transform these back whenever the hack is
in effect, but I figured I may as well do it any time the user passes
"." or "./" explicitly too (something that users who have run into the
new `rg` behavior may already have muscle memory for doing).

Now, I could apply this to the other search modes (eg. "async" Vim mode
and "vanilla" mode) for consistency, but the truth is I suspect almost
nobody is using those, and if they are, they are probably not in the
habit of appending "." to their searches (because there is not need to).

Related: https://github.com/wincent/ferret/issues/78

20 months agofix: work around breakage caused by rg v13.0.0
Greg Hurrell [Fri, 9 Jul 2021 16:31:48 +0000 (18:31 +0200)] 
fix: work around breakage caused by rg v13.0.0

v13.0.0 broke a number of tools in Neovim, but not in Vim, as described


My reading of that is that changes to Neovim will/may be required,
because the `rg` author is right that rg's handling is "technically
correct" and I don't think he's going to change it. Luckily, we don't
have to take sides in that argument because there is a straightforward
enough workaround of always providing a path to search (ie. ".", only if
one isn't already provided by the user).


As I lamented here:


installing and building docvim on this machine (in order to include the
update to the "HISTORY" section in the docs) is a frickin' ordeal. It

1. 5.53s to clone the repo.
2. 3m56s to install GHC.
3. 3m24s to build the project.
4. 1.64s to run the built tool.

Which seems massively out-of-proportion for something that clocks in at
1,380 lines of Haskell according to `sloccount`. On the upside, this is
one of the few tasks I can throw at this Linux box that actually taxes
the machine. 😆


    git clone git@git.wincent.com:public/docvim.git

    cd docvim

    bin/docvim \
      -c ~/.vim/pack/bundle/opt/ferret \
      ~/.vim/pack/bundle/opt/ferret/README.md \

    # That did't work; need to build first, then retry:

    bin/docvim \
      -c ~/.vim/pack/bundle/opt/ferret \
      ~/.vim/pack/bundle/opt/ferret/README.md \

Closes: https://github.com/wincent/ferret/issues/78
20 months agodocs: document FerretAsyncStart ad FerretAsyncFinish
Greg Hurrell [Thu, 8 Jul 2021 19:14:59 +0000 (21:14 +0200)] 
docs: document FerretAsyncStart ad FerretAsyncFinish

These have existed since 79fab3c98872feee19bf57e81 ("Provide autocmd
hooks for async start/stop", May 11, 2016) but were never documented.

21 months agochore: switch from "master" to "main"
Greg Hurrell [Sat, 12 Jun 2021 17:06:42 +0000 (19:06 +0200)] 
chore: switch from "master" to "main"

2 years agoMerge branch 'pull/77'
Greg Hurrell [Tue, 8 Dec 2020 20:14:58 +0000 (21:14 +0100)] 
Merge branch 'pull/77'

Closes: https://github.com/wincent/ferret/pull/77
* pull/77:
  docs: update AUTHORS
  docs:fix typo in option documentation (FerrerLazyInit)

2 years agodocs: update AUTHORS
Greg Hurrell [Tue, 8 Dec 2020 20:13:45 +0000 (21:13 +0100)] 
docs: update AUTHORS

On a new machine now, so regenerated with:

    git clone https://github.com/wincent/docvim.git
    cd docvim
    pacman -S stack happy
    bin/docvim \
        -c ~/.vim/pack/bundle/opt/ferret \
        ~/.vim/pack/bundle/opt/ferret/README.md \

2 years agodocs:fix typo in option documentation (FerrerLazyInit)
Andrew Macpherson [Tue, 8 Dec 2020 18:02:20 +0000 (18:02 +0000)] 
docs:fix typo in option documentation (FerrerLazyInit)

2 years agofix: correct failure to detect pre-existing mapping to <Plug>(FerretLack)
Greg Hurrell [Fri, 15 May 2020 14:52:54 +0000 (16:52 +0200)] 
fix: correct failure to detect pre-existing mapping to <Plug>(FerretLack)

2 years agodocs: try to make the quoting examples even clearer
Greg Hurrell [Fri, 8 May 2020 14:00:45 +0000 (16:00 +0200)] 
docs: try to make the quoting examples even clearer

2 years agodocs: try to make quoting examples easier to read
Greg Hurrell [Fri, 8 May 2020 13:57:12 +0000 (15:57 +0200)] 
docs: try to make quoting examples easier to read

2 years agoMerge branch 'pull/71'
Greg Hurrell [Fri, 8 May 2020 13:51:14 +0000 (15:51 +0200)] 
Merge branch 'pull/71'

Closes: https://github.com/wincent/ferret/pull/71
* pull/71:
  docs: update AUTHORS section
  docs: small typo in ferret-quotes

2 years agodocs: update AUTHORS section
Greg Hurrell [Fri, 8 May 2020 13:49:20 +0000 (15:49 +0200)] 
docs: update AUTHORS section

2 years agodocs: small typo in ferret-quotes
fent [Fri, 8 May 2020 04:56:47 +0000 (00:56 -0400)] 
docs: small typo in ferret-quotes

3 years agofeat: make tab completion append trailing slashes to directories
Greg Hurrell [Sun, 9 Feb 2020 19:40:45 +0000 (20:40 +0100)] 
feat: make tab completion append trailing slashes to directories

This matches the behavior you would get if you typed:

    :e something<tab>

In a directory with a "something-here" subdirectory.

Closes: https://github.com/wincent/ferret/issues/69
3 years agoMerge branch 'pull/67'
Greg Hurrell [Fri, 27 Sep 2019 20:55:44 +0000 (22:55 +0200)] 
Merge branch 'pull/67'

Closes: https://github.com/wincent/ferret/pull/67
* pull/67:
  docs: update AUTHORS and HISTORY sections
  Use `normal!` instead of `normal`.

3 years agodocs: update AUTHORS and HISTORY sections
Greg Hurrell [Fri, 27 Sep 2019 20:55:26 +0000 (22:55 +0200)] 
docs: update AUTHORS and HISTORY sections

3 years agoUse `normal!` instead of `normal`.
Yoni Weill [Fri, 27 Sep 2019 06:17:20 +0000 (09:17 +0300)] 
Use `normal!` instead of `normal`.

This avoids remapping the commands by custom user mappings.

3 years agofeat: add g:FerretAckWordWord (#66)
Greg Hurrell [Mon, 23 Sep 2019 18:44:25 +0000 (20:44 +0200)] 
feat: add g:FerretAckWordWord (#66)

Closes: https://github.com/wincent/ferret/issues/66
3 years agodocs: correct "mnemonix" typo
Greg Hurrell [Tue, 13 Aug 2019 21:56:25 +0000 (23:56 +0200)] 
docs: correct "mnemonix" typo

3 years agodocs: generate image headers using in-development version of docvim
Greg Hurrell [Sat, 8 Jun 2019 08:28:45 +0000 (10:28 +0200)] 
docs: generate image headers using in-development version of docvim

3 years agofix: loosen regex that checks for appropriate :Acks argument
Greg Hurrell [Mon, 10 Jun 2019 08:12:30 +0000 (10:12 +0200)] 
fix: loosen regex that checks for appropriate :Acks argument

Recent changes introduced trailing whitespace here, which is causing the
regex not to match. It seems that neither leading nor trailing
whitespace can cause any harm though, so accept both.

3 years agochore: prepare for v5.0 release 5.0
Greg Hurrell [Fri, 7 Jun 2019 22:02:32 +0000 (00:02 +0200)] 
chore: prepare for v5.0 release

3 years agofix: make bindings work in location-list as well
Greg Hurrell [Fri, 7 Jun 2019 22:27:45 +0000 (00:27 +0200)] 
fix: make bindings work in location-list as well

3 years agofeat: Add :Largs and :Lacks
Greg Hurrell [Fri, 7 Jun 2019 22:01:40 +0000 (00:01 +0200)] 
feat: Add :Largs and :Lacks

3 years agofix: typo in option name
Greg Hurrell [Sun, 2 Jun 2019 22:53:58 +0000 (00:53 +0200)] 
fix: typo in option name

Related: https://github.com/wincent/ferret/issues/62

3 years agofeat: prefer `:cdo` over `:cfdo`
Greg Hurrell [Sun, 2 Jun 2019 22:48:52 +0000 (00:48 +0200)] 
feat: prefer `:cdo` over `:cfdo`

Closes: https://github.com/wincent/ferret/issues/62
3 years agofeat!: add g:FerretVeryMagic option
Greg Hurrell [Sun, 2 Jun 2019 14:35:47 +0000 (16:35 +0200)] 
feat!: add g:FerretVeryMagic option

BREAKING CHANGE: the `:Acks` command-line brought up by the
`<Plug>(FerretAcks)` mapping now includes `\v` by default to make
patterns "very magic".

This default can be overridden with the `g:FerretVeryMagic` option.

Closes: https://github.com/wincent/ferret/issues/61
3 years agodoc: update shortlinks
Greg Hurrell [Sat, 1 Jun 2019 22:53:45 +0000 (00:53 +0200)] 
doc: update shortlinks

4 years agoAvoid capturing bad 'scrolloff' value
Greg Hurrell [Mon, 11 Mar 2019 14:19:35 +0000 (15:19 +0100)] 
Avoid capturing bad 'scrolloff' value

I was finding that my 'scrolloff' was getting permanently set to zero in
the following scenario and perhaps in others:

1. Search for something; the quickfix window gets shown and we save the
   current 'scrolloff' value.
2. Move focus to the quickfix window, at which point we set 'scrolloff'
   to 0.
3. Initiate another search; when the new results show up, we save the
   current value of 'scrolloff' (0), overwriting the real value that we
   originally saved.

The simplest fix, then, seems to be this one: only capture the value
the first time we show the window. This means that if you update the
value and we later do a search, we won't capture the new value, but that
seems less likely to happen than the scenario which we're talking about
in this commit, which happens all the time.

4 years agoPrepare for 4.1 release 4.1
Greg Hurrell [Thu, 31 Jan 2019 21:57:04 +0000 (22:57 +0100)] 
Prepare for 4.1 release

4 years agoAvoid redundant updates to dictionary in ferret#private#qargs()
Greg Hurrell [Thu, 31 Jan 2019 21:54:59 +0000 (22:54 +0100)] 
Avoid redundant updates to dictionary in ferret#private#qargs()

4 years agoAdd :Quack and :Quack!
Greg Hurrell [Thu, 31 Jan 2019 21:51:32 +0000 (22:51 +0100)] 
Add :Quack and :Quack!

As described in the docs, these search like `:Ack`, but scoped to the
quickfix listing.

4 years agoFix option autocompletion
Greg Hurrell [Thu, 31 Jan 2019 21:49:14 +0000 (22:49 +0100)] 
Fix option autocompletion

Broken since dbf1b19e5da94116fbb479cfb739a.

4 years agoFix bad args passed to ferret#private#complete()
Greg Hurrell [Thu, 31 Jan 2019 21:37:32 +0000 (22:37 +0100)] 
Fix bad args passed to ferret#private#complete()

As far as I recall, I am supposed to be passing the command name in
here. I think this has been wrong since these lines were added, in

4 years agodoc: fix "asynchronoous" typo
Greg Hurrell [Tue, 15 Jan 2019 21:32:19 +0000 (22:32 +0100)] 
doc: fix "asynchronoous" typo

4 years agoPrepare for 4.0.2 release 4.0.2
Greg Hurrell [Fri, 11 Jan 2019 09:40:27 +0000 (10:40 +0100)] 
Prepare for 4.0.2 release

4 years agoMake use of `rg --no-config` conditional via feature detection
Greg Hurrell [Thu, 10 Jan 2019 22:23:51 +0000 (23:23 +0100)] 
Make use of `rg --no-config` conditional via feature detection



wherein it was reported that only rg version 0.8 and about supports the
`--no-config` switch.

4 years agoPrep for 4.0.1 release 4.0.1
Greg Hurrell [Tue, 8 Jan 2019 08:30:37 +0000 (09:30 +0100)] 
Prep for 4.0.1 release

4 years agoHandle repeated 'g' flags passed to :Acks
Greg Hurrell [Fri, 4 Jan 2019 09:03:02 +0000 (10:03 +0100)] 
Handle repeated 'g' flags passed to :Acks

This is amazingly edge casey, but the 'g' flag can be repeated, toggling
the effect each time. So:

  :Acks /foo/bar/gggg

Would actually have the effect of turning off global replacement. As
bf9bffbc21ad3 said:

    The docs for `:Acks` promise that:

    > Takes all of the files currently in the |quickfix| listing and
    > performs a substitution of all instances of {pattern} (a standard
    > Vim search |pattern|) by {replacement}.

So in order to be true to the promise of replacing "all instances" we
need to make sure that there is only a single 'g' flag.

4 years agoPrefer long form of commands (eg. :substitute over :s)
Greg Hurrell [Fri, 4 Jan 2019 08:55:13 +0000 (09:55 +0100)] 
Prefer long form of commands (eg. :substitute over :s)

Just as a matter of policy, I want script content to be unabbreviated.
User-inputted content can be as brief as you want.

4 years agoHandle 'gdefault'
Greg Hurrell [Fri, 4 Jan 2019 08:50:59 +0000 (09:50 +0100)] 
Handle 'gdefault'

The docs for `:Acks` promise that:

> Takes all of the files currently in the |quickfix| listing and performs a
> substitution of all instances of {pattern} (a standard Vim search |pattern|)
> by {replacement}.

So, that means that we should handle `'gdefault'` being set, which would
otherwise invert the meaning of the 'g' flag to `:substitute` and cause
only the first instance on each line to be replaced.

4 years agoPrepare for 4.0 release 4.0
Greg Hurrell [Tue, 25 Dec 2018 20:22:07 +0000 (21:22 +0100)] 
Prepare for 4.0 release

4 years agoAdd missing docs for g:FerretQFHandler
Greg Hurrell [Tue, 25 Dec 2018 17:56:42 +0000 (18:56 +0100)] 
Add missing docs for g:FerretQFHandler

Requires using latest tweaked docvim.

4 years agodoc: add missing documentation for old options and commands
Greg Hurrell [Tue, 25 Dec 2018 17:47:12 +0000 (18:47 +0100)] 
doc: add missing documentation for old options and commands

These have been around for a while, but never documented.

4 years agodoc: make function references into links
Greg Hurrell [Tue, 25 Dec 2018 17:36:52 +0000 (18:36 +0100)] 
doc: make function references into links

Using latest tweaked docvim build.

4 years agodoc: make links to options actually links
Greg Hurrell [Tue, 25 Dec 2018 17:17:10 +0000 (18:17 +0100)] 
doc: make links to options actually links

See: https://github.com/wincent/docvim/issues/40

Regenerated with tweaked docvim build.

4 years agodoc: improve readability of "Overrides" section
Greg Hurrell [Tue, 25 Dec 2018 16:49:37 +0000 (17:49 +0100)] 
doc: improve readability of "Overrides" section

By using headings.

4 years agodoc: remove excess trailing parens
Greg Hurrell [Tue, 25 Dec 2018 16:45:09 +0000 (17:45 +0100)] 
doc: remove excess trailing parens

4 years agoAvoid leading whitespace in default `ag` arguments list
Greg Hurrell [Tue, 25 Dec 2018 16:42:07 +0000 (17:42 +0100)] 
Avoid leading whitespace in default `ag` arguments list

4 years agoAdd g:FerretExecutableArguments and ferret#get_default_arguments()
Greg Hurrell [Tue, 25 Dec 2018 16:32:45 +0000 (17:32 +0100)] 
Add g:FerretExecutableArguments and ferret#get_default_arguments()

Closes: https://github.com/wincent/ferret/pull/46
Closes: https://github.com/wincent/ferret/pull/55
4 years agoAdd --no-config to default rg options
Greg Hurrell [Tue, 25 Dec 2018 16:02:27 +0000 (17:02 +0100)] 
Add --no-config to default rg options

As per:


we don't want a local `.ripgreprc` file to break Ferret.

4 years agoDon't repeat executable name in s:executables values
Greg Hurrell [Tue, 25 Dec 2018 16:00:58 +0000 (17:00 +0100)] 
Don't repeat executable name in s:executables values

In preparation for making it possible to override the options, let's not
mash the executable and the options together.

4 years agoMerge branch 'pull/58'
Greg Hurrell [Mon, 24 Dec 2018 18:02:14 +0000 (19:02 +0100)] 
Merge branch 'pull/58'

Closes: https://github.com/wincent/ferret/pull/58
* pull/58:
  Apply style fixes
  Use the list's 'size' property when available

4 years agoApply style fixes
Greg Hurrell [Mon, 24 Dec 2018 18:01:16 +0000 (19:01 +0100)] 
Apply style fixes

This file was using inconsistent spacing in `let` commands, so make it

4 years agoUse the list's 'size' property when available
Jon Parise [Thu, 20 Dec 2018 22:22:02 +0000 (14:22 -0800)] 
Use the list's 'size' property when available

It's more efficient to ask the list for its size than to fetch the full
list and pass it to len():


This property became available in patch 8.0.1112, so add a fallback to
the previous method when running on older versions.

4 years agoMerge branch 'pull/57'
Greg Hurrell [Thu, 20 Dec 2018 22:01:32 +0000 (23:01 +0100)] 
Merge branch 'pull/57'

Closes: https://github.com/wincent/ferret/pull/57
* pull/57:
  Apply style fixes for consistency
  doc: update AUTHORS and HISTORY
  Set the list's 'title' with last search string

4 years agoApply style fixes for consistency
Greg Hurrell [Thu, 20 Dec 2018 22:00:39 +0000 (23:00 +0100)] 
Apply style fixes for consistency

4 years agodoc: update AUTHORS and HISTORY
Greg Hurrell [Thu, 20 Dec 2018 22:00:18 +0000 (23:00 +0100)] 
doc: update AUTHORS and HISTORY

4 years agoSet the list's 'title' with last search string
Jon Parise [Thu, 20 Dec 2018 16:39:21 +0000 (08:39 -0800)] 
Set the list's 'title' with last search string

We create the list using e.g. `cexpr`, which implicitly names the list
after the command that created it. We can provide a more descriptive
title by setting the list's 'title' field (in vim 7.4.2200+) or setting
w:quickfix_title as a fallback (just for the quickfix list).

4 years agoAvoid 'press ENTER to continue' prompts
Greg Hurrell [Tue, 18 Dec 2018 10:37:31 +0000 (11:37 +0100)] 
Avoid 'press ENTER to continue' prompts

I had this hack in place to prevent the error message from getting blown
away before the user sees it, but it is annoying:

    No results for search pattern `foo`: press ENTER to continue

On Vim with 'lambda' and 'timers' support, we can show this instead:

    No results for search pattern `foo`

with no prompt. Strictly speaking, this could have been written without
a lambda expression, but it is tidier this way.

4 years agodoc: rebuild with tweaked docvim to make commands stand out
Greg Hurrell [Tue, 4 Dec 2018 14:01:40 +0000 (15:01 +0100)] 
doc: rebuild with tweaked docvim to make commands stand out

4 years agoRemove stray > from docs
Greg Hurrell [Thu, 18 Oct 2018 11:05:21 +0000 (13:05 +0200)] 
Remove stray > from docs

Closes: https://github.com/wincent/ferret/issues/53
4 years agodoc: Include a more complex example for `:Acks`
Greg Hurrell [Wed, 17 Oct 2018 10:45:27 +0000 (12:45 +0200)] 
doc: Include a more complex example for `:Acks`

Show that backslashes get passed through, match references work, and
that everything is passed along verbatim to Vim's `:substitute` command.

5 years agoPrepare for 3.0.3 release 3.0.3
Greg Hurrell [Fri, 23 Mar 2018 15:37:25 +0000 (08:37 -0700)] 
Prepare for 3.0.3 release

5 years agoFix for :Lack always opening results in Quickfix window in Neovim
Greg Hurrell [Fri, 23 Mar 2018 15:31:57 +0000 (08:31 -0700)] 
Fix for :Lack always opening results in Quickfix window in Neovim

Presumably a copy-pasta bug that happened while preparing 15db82f1.

Thanks to @regedarek for reporting, and @skingtn for noting the

Closes: https://github.com/wincent/ferret/issues/47
5 years agodoc: Escape "<leader>" etc in Markdown
Greg Hurrell [Fri, 5 Jan 2018 07:54:44 +0000 (23:54 -0800)] 
doc: Escape "<leader>" etc in Markdown

So the GitHub Markdown render won't eat them.

Requires docvim with fix for:


5 years agodoc: Fix false claim about mapping suppression
Greg Hurrell [Fri, 5 Jan 2018 07:18:30 +0000 (23:18 -0800)] 
doc: Fix false claim about mapping suppression

Done from my local docvim install (because I haven't bothered to install
it globally on this machine yet):

brew install stack
stack build
bin/docvim ~/code/ferret/doc/ferret.txt ~/code/ferret/README.md -c ~/code/ferret

Closes: https://github.com/wincent/ferret/issues/50
5 years agoPrepare for 3.0.2 release 3.0.2
Greg Hurrell [Thu, 26 Oct 2017 02:06:25 +0000 (19:06 -0700)] 
Prepare for 3.0.2 release

5 years agoFix :Back and :Black
Greg Hurrell [Thu, 26 Oct 2017 02:04:27 +0000 (19:04 -0700)] 
Fix :Back and :Black

Somehow I managed to break these and didn't test them at all...

Closes: https://github.com/wincent/ferret/issues/48
5 years agoPrep for 3.0.1 release 3.0.1
Greg Hurrell [Fri, 25 Aug 2017 00:28:20 +0000 (17:28 -0700)] 
Prep for 3.0.1 release

5 years agoFix failure to handle multiple escaped spaces
Greg Hurrell [Thu, 24 Aug 2017 19:12:17 +0000 (12:12 -0700)] 
Fix failure to handle multiple escaped spaces

Searching for:

    foo\ bar

Would work, but:

    foo\ bar\ baz

Would not, due to a missing "g" flag to `substitute()`.

Closes: https://github.com/wincent/ferret/issues/49
5 years agodoc: mention ripgrep earlier on in the README
Greg Hurrell [Tue, 13 Jun 2017 15:32:15 +0000 (08:32 -0700)] 
doc: mention ripgrep earlier on in the README

5 years agodoc: clarify when :Qargs is used
Greg Hurrell [Tue, 13 Jun 2017 15:28:45 +0000 (08:28 -0700)] 
doc: clarify when :Qargs is used

5 years agoPrepare for 3.0 release 3.0
Greg Hurrell [Tue, 13 Jun 2017 15:22:46 +0000 (08:22 -0700)] 
Prepare for 3.0 release

5 years agoAdd g:FerretAutojump
Greg Hurrell [Tue, 13 Jun 2017 04:09:39 +0000 (21:09 -0700)] 
Add g:FerretAutojump

This is a fairly invasive change, so I'll keep my finger poised above
the revert button. For more context, see:


Notable changes since I last explored this:

- Using `winnr()` to avoid blindly relying on `wincmd p`.
- Switched to `:copen` (from `:cwindow`) to get consistent focusing
- Slight change of `post()` callback ordering so that we can decide
  whether or not to open the listing at all; this allows us to avoid
  showing an empty listing with `:copen`.

5 years agoDrop support for vim-dispatch
Greg Hurrell [Fri, 9 Jun 2017 02:32:47 +0000 (19:32 -0700)] 
Drop support for vim-dispatch

Supporting it is just too painful given the degree of difference between
vim-dispatch and the other environments, especially considering how
vim-dispatch can run with one of any number of underlying strategies.

Given the prevalence of Vim 8 and Neovim nowadays (with async support),
the value is no longer compelling here. So let's just drop it in order
to move faster. Life is too short.

5 years agoImprove backslash handling
Greg Hurrell [Fri, 9 Jun 2017 02:03:49 +0000 (19:03 -0700)] 
Improve backslash handling

When searching *for* a backslash, our use of `<f-args>` was causing
confusion because of its special behavior with respect to backslashes.
According to `:h <f-args>`:

- Arguments get split on spaces.
- "\ " prevents a space from causing a split.
- "\\" gets replaced with "\".
- "\x" remains unmodified.

So that means searching for "foo\\bar" would turn into a search for
"foo\bar" (which means "foo, word-boundary, ar").

Fix this by replacing `<f-args>` with `<q-args>`, requiring us to do
argument splitting ourselves, using the nastiest regex ever. That one
was fun to write...

Closes: https://github.com/wincent/ferret/issues/41
5 years agoPrepare for 2.0 release 2.0
Greg Hurrell [Tue, 6 Jun 2017 14:58:23 +0000 (07:58 -0700)] 
Prepare for 2.0 release

5 years agodoc: mention Neovim higher up in the README
Greg Hurrell [Tue, 6 Jun 2017 14:44:09 +0000 (07:44 -0700)] 
doc: mention Neovim higher up in the README

5 years agoAdd Neovim support
Greg Hurrell [Tue, 6 Jun 2017 14:40:50 +0000 (07:40 -0700)] 
Add Neovim support

This is pretty alpha, only lightly tested at this point, and based
mostly on copy-pasta from the Vim 8 async implementation.

Nevertheless, closes: https://github.com/wincent/ferret/issues/44

5 years agodoc: update shortlink host
Greg Hurrell [Sun, 21 May 2017 20:50:29 +0000 (13:50 -0700)] 
doc: update shortlink host

5 years agoPrepare for 1.5 release 1.5
Greg Hurrell [Fri, 5 May 2017 01:26:15 +0000 (18:26 -0700)] 
Prepare for 1.5 release

5 years agodoc: add missing words in a sentence
Greg Hurrell [Fri, 5 May 2017 01:18:57 +0000 (18:18 -0700)] 
doc: add missing words in a sentence

Looks like a had a half-finished sentence in there that I

5 years agoAdd g:FerretMaxResults
Greg Hurrell [Thu, 4 May 2017 16:11:47 +0000 (09:11 -0700)] 
Add g:FerretMaxResults

Final(?) mitigation for the lockup and lag issues discussed in:


5 years agoSwitch a script-local variable to function-local
Greg Hurrell [Wed, 3 May 2017 17:23:13 +0000 (10:23 -0700)] 
Switch a script-local variable to function-local

5 years agodoc: Fix bad Unicode handling
Greg Hurrell [Wed, 3 May 2017 06:47:12 +0000 (23:47 -0700)] 
doc: Fix bad Unicode handling

Looks like I've found a bug in Docvim.

5 years agodoc: regen docs again
Greg Hurrell [Wed, 3 May 2017 06:43:46 +0000 (23:43 -0700)] 
doc: regen docs again

Somehow I didn't get a full update with the last commit. Blew away the
input files and repeated.

5 years agodoc: Fix Markdown under GitHub's new renderer
Greg Hurrell [Wed, 3 May 2017 06:37:30 +0000 (23:37 -0700)] 
doc: Fix Markdown under GitHub's new renderer

Run using the latest version of Docvim (commit 0335d8d) straight out of
the local Docvim repo with:

bin/get ferret
bin/put ferret