1 files changed, 62 insertions, 0 deletions

diff --git a/doc/better-text-objs.txt b/doc/better-text-objs.txt
new file mode 100644
index 0000000..7a83d25
--- /dev/null
+++ b/doc/better-text-objs.txt
@@ -0,0 +1,62 @@
+*better-text-objs.txt*  Provide additional text objects
+
+
+==============================================================================
+INTRODUCTION                                         *better-text-objs-intro*
+
+This is a collection of handy text objects I found online,
+written by romainl and habamax. I found these useful and
+decided to package them into a plugin.
+
+==============================================================================
+OVERVIEW                                          *better-text-objs-overview*
+
+Pair    |better-text-objs-pair|
+Line    |better-text-objs-line|
+Number  |better-text-objs-number|
+Buffer  |better-text-objs-buffer|
+Indent  |better-text-objs-indent|
+
+==============================================================================
+PAIR                                          *better-text-objs-pair*
+
+`i_ i. i: i, i; i| i/ i\ i* i+ i- i#`
+`a_ a. a: a, a; a| a/ a\ a* a+ a- a#`
+
+Text objects in and around any two matching pairs of characters on the same
+line.
+
+==============================================================================
+LINE                                          *better-text-objs-line*
+
+`il al`
+
+Text objects to represent in and around the current line.
+
+==============================================================================
+NUMBER                                          *better-text-objs-number*
+
+`in an`
+
+Text objects in and around a number (if present) under the cursor.
+
+==============================================================================
+BUFFER                                          *better-text-objs-number*
+
+`i% a%`
+
+Text objects representing the active buffer, `i%` excludes the first and last
+lines of the buffer, `a%` includes all lines of the buffer.
+
+==============================================================================
+INDENT                                         *better-text-objs-number*
+
+`ii ai`
+
+Text objects to represent the text at the same indent level, useful for indent
+based programming languages, such as Python or Haskell. `ii` includes only
+text at the same indent level, `ai` includes one line before and one line
+after the current indent level.
+
+------------------------------------------------------------------------------
+vim:tw=78:ts=8:ft=help:norl: