chore: move "master" → "main"

chore: prepare v1.1. release

chore: ignore "media" worktree

To facilitate use of:

    git worktree add media origin/media

or similar.

docs: add demo gif to README

docs: restore header image

Accidentally blown away in 4283529e4274b42f8831ee2895469b5d53ec6153.

Previously, I had injected it by hand, but now, docvim has support for
an `@image` tag, so this is the right way to do it.

Merge branch 'pull/11'

Closes: https://github.com/wincent/scalpel/pull/11
* pull/11:
  doc: update AUTHORS and HISTORY sections
  refactor: replace hard-coded "$" with "very magic" list
  Escape '$' when launching Scalpel

doc: update AUTHORS and HISTORY sections

refactor: replace hard-coded "$" with "very magic" list

As the PR duly notes, it's hard to imagine an obvious use case where
some "special" character other than "$" is part of a Vim "word", but if
we're going to do this, we might as well work for all possible
definitions of `'iskeyword'`.

I was originally thinking we should do this based on what is in
`'iskeyword'`, but we can just do a blanket rule and escape literally
everything that might have "very magic" significance. Note that in
preparing the list of characters to be escaped, we have to double escape
the following to produce a valid `:execute` string:

- '"' because the list itself is double-quoted.
- '\' because it is in the list and we need to preserve it.
- '|' because otherwise it will terminate the command.

Test plan:

Set a bizarre `'iskeyword'` like:

    :set iskeyword=@,34,39,41,47-57,92,_,124,192-255

ie. in additional to the typical 48-57,192-255 range, also add:

    34 = "
    39 = '
    41 = )
    47 = /
    92 = \
    124 = |

and then hit the mapping with the cursor over a "word" like this one:

    '"/\|')

(That example chosen simply because it appears in the source.)

Escape '$' when launching Scalpel

Prepare for v1.0.1 release

Prefer execute() when available to avoid potential nested :redir issues

Fix clowniness of commit c00f46b

Need to keep the "g" flag in the same place as before. Perhaps I
shouldn't be doing this so late:

    commit c00f46bd2c556b348ae2a256ef003c219574def0
    Author: Greg Hurrell <greg@hurrell.net>
    Date:   Thu Jan 3 02:14:46 2019 +0100

doc: prepare for 1.0 release

- Add links to screencasts.
- Add FAQ explaining why you'd want to use Scalpel.
- Update HISTORY.

Take into account 'gdefault' setting

If the user has 'gdefault' set (not the default), then the "g" flag
actually turns *off* global replacement instead of turning it on. So,
check for 'gdefault' in order to decide whether or not to pass the "g"
(we always want to do global replacements).

Reported here:

  https://twitter.com/briemens/status/1080554857998757888

My guess at problem here:

  https://twitter.com/wincent/status/1080616775681798144

Confirmed that it was here:

  https://twitter.com/briemens/status/1080618527218978816

Prepare for 0.5 release

Fix VISUAL mode in older Vim

Looks like the tokenizer in older Vim such as 7.4.629 barfs on list
sublist syntax involving variables with the `l:` qualifier. Provide it
some parens to help it avoid getting confused.

Closes: https://github.com/wincent/scalpel/issues/8

doc: prepare for 0.4 release

Fix problem with replacement sequences containing the number "1"

`\1` in a `[]` collection was equivalent to literal "1" instead of the
intended back-reference to the delimiter. This meant that `[^\1]` was
equivalent to `[^1]`, and when embedded in the larger expression meant
that a pattern like `/a2/a1/` was failing to match.

Closes: https://github.com/wincent/scalpel/issues/7

Prep for 0.3 release

Use getpos('.') instead of getcurpos() on old Vim

`getcurpos()` came in somewhere in the Vim 7.4 series.

Allow other pattern delimiters

Closes: https://github.com/wincent/scalpel/issues/5

Add empty .watchmanconfig

Allows a Watchman instance configured with `enforce_root_files` to watch
this directory even if `root_files` does not contain any of the files in
the directory. (Necessary to get around undesired corporate
`/etc/watchman.json` config.)

Prepare for 0.2 release

Suppress "N substitutions on N lines" messages

Cool. I really wanted to be able to do this, and I just found `'report'` in the
Vim help.

Freshen documentation

With the latest master branch of docvim.

doc: note how to generate docs for release

Add Vim help documentation generated by docvim

Add logo to README

Fix some wrapping

doc: Fix a typo in the README

Replace README with docvim-generated version

Update docs with info about visual mode operation

Be a good autocmd citizen

Hack around <cword> issue using CursorMoved autocmd

I'd rather not run code on every single cursor move event, but there is no other
way, and this is not much code.

Attempt fix for <cword> not being useful in VISUAL mode

Don't get too excited, as this doesn't actually work. I thought it would, but
`getcurpos` is always returning top/left in multi-line visual mode. Showing my
work here anyway. May have to revert it.

- VISUAL: works
- VISUAL BLOCK:
  - works if block spans only single line
  - returns top/left word otherwise
- VISUAL LINE: always returns top/left word, even when block spans only single
  line

In short, I think this behaves exactly like `<cword>` and with exactly the same
limitations.

Work in VISUAL mode

This mostly works pretty well. One gotcha is that `<cword>` expands to the first
word of the selection in VISUAL mode, not the word under the cursor. I think
this is technically because VIM actually does move the cursor to the top before
calling any function.

There may be a workaround, but it will be pretty involved, so I will save it for
another commit (IFF I can get it working).

Ignore release archives

Add README

Rename ScalpelSubstitute to Scalpel

Denest

Rename :Substitute to :Scalpel

Makes more sense, and is very unlikely to ever clash with another plug-in.

Add validation of command name

Add basic configuration

No sanity checking yet, so people can do crazy shit if they want.

Add standard plug-in boilerplate

Add LICENSE.md

Add license headers

Carry "a" flag around when looping back to top of buffer

In an utterly bizarre VimL gotcha, the `&` last flags argument has to go away at
the end because otherwise Vim will use the flags from inside the `if l:last ==#
'a'` loop body, even if the body wasn't evaluated. This is presumably because it
really is evaluated (everything is "eval"), except without side-effects, other
than clobbering the last-flags state, that is.

Amazing.

Drop empty trailing comment

Rename autoloaded functions to match directory structure

Import base from dotfiles

https://github.com/wincent/wincent/commit/4dda6f258834a9

Initial commit