Add short documentation for new custom plugins

I'm using the plugin_name.txt syntax suggested by the Vim documentation.
That may change in future as I study plugins written by experienced
authors like Tim Pope.

There will almost certainly be a lot more detail to add to each of
these.

1 files changed, 15 insertions, 0 deletions

diff --git a/vim/doc/flag_toggle.txt b/vim/doc/flag_toggle.txt
new file mode 100644
index 00000000..5f1b504a
--- /dev/null
+++ b/vim/doc/flag_toggle.txt
@@ -0,0 +1,15 @@
+*flag_toggle.txt*  Functions to toggle single-character flags in options
+
+Author:  Tom Ryder <tom@sanctum.geek.nz>
+License: Same terms as Vim itself (see |license|)
+
+This plugin provides functions flag_toggle#Toggle(option, flag) and
+flag_toggle#ToggleLocal(option, flag) to toggle the values of options like
+|'formatoptions'| or |'complete'| that have values comprised of
+single-character flags. The author originally designed it for toggling flags in
+|'formatoptions'| quickly.
+
+This plugin lives in Tom Ryder's "dotfiles" suite, and will eventually be spun
+off into a separate distribution as it solidifies and this documentation
+improves.
+