From 069a8ae6afaa978eac09d5b92030431be051622e Mon Sep 17 00:00:00 2001 From: Reed Esau Date: Sun, 29 Dec 2013 02:22:38 -0700 Subject: [PATCH] ongoing --- doc/thematic.txt | 163 ----------------------------------------------- 1 file changed, 163 deletions(-) delete mode 100644 doc/thematic.txt diff --git a/doc/thematic.txt b/doc/thematic.txt deleted file mode 100644 index 4d0e0d1..0000000 --- a/doc/thematic.txt +++ /dev/null @@ -1,163 +0,0 @@ -*thematic.txt* Theme manager for VIM - -Author: Reed Esau -License: Same terms as Vim itself (see |license|) - -This plugin is only available if 'compatible' is not set. - -INTRODUCTION *thematic* *:thematic* - -thematic lets you quickly find, substitute, and abbreviate several variations -of a word at once. By default, three case variants (foo, Foo, and FOO) are -operated on by every command. - -Two commands are provided. :thematic is the most general interface. -:Subvert provides an alternative, more concise syntax for searching and -substituting. -> - :thematic [options] {abbreviation} {replacement} - :thematic -delete [options] {abbreviation} - - :thematic -search [options] {pattern} - :Subvert/{pattern}[/flags] - :thematic!-search [options] {pattern} - :Subvert?{pattern}[?flags] - - :thematic -search [options] {pattern} {grep-arguments} - :Subvert /{pattern}/[flags] {grep-options} - :thematic!-search [options] {pattern} {grep-arguments} - :Subvert!/{pattern}/[flags] {grep-options} - - :[range]thematic -substitute [options] {pattern} {replacement} - :[range]Subvert/{pattern}/{replacement}[/flags] -< - *:S* -In addition to the :Subvert command, a :S synonym is provided if not -already defined. This will be used in examples below. - -PATTERNS *thematic-patterns* - -Patterns can include brace pairs that contain comma separated alternatives: - - box{,es} => box, boxes, Box, Boxes, BOX, BOXES - -For commands with a replacement, corresponding brace pairs are used in both -halves. If the replacement should be identical to the pattern, an empty -brace pair may be used. If fewer replacements are given than were given in -the pattern, they are looped. That is, {a,b} on the replacement side is the -same as {a,b,a,b,a,b,...} repeated indefinitely. - -The following replaces several different misspellings of "necessary": -> - :%S/{,un}nec{ce,ces,e}sar{y,ily}/{}nec{es}sar{}/g -< -ABBREVIATING *thematic-abbrev* - -By default :thematic creates abbreviations, which replace words automatically -as you type. This is good for words you frequently misspell, or as -shortcuts for longer words. Since these are just Vim abbreviations, only -whole words will match. -> - :thematic anomol{y,ies} anomal{} - :thematic {,in}consistant{,ly} {}consistent{} - :thematic Tqbf The quick, brown fox jumps over the lazy dog -< -Accepts the following options: - - -buffer: buffer local - -cmdline: work in command line in addition to insert mode - -A good place to define abbreviations is "after/plugin/thematic.vim", -relative to ~\vimfiles on Windows and ~/.vim everywhere else. - -With a bang (:thematic!) the abbreviation is also appended to the file in -g:thematic_save_file. The default is "after/plugin/thematic.vim", relative -to the install directory. - -Abbreviations can be removed with :thematic -delete: -> - thematic -delete -buffer -cmdline anomol{y,ies} -< -SEARCHING *thematic-search* - -The -search command does a search in a manner similar to / key. -search. After searching, you can use |n| and |N| as you would with a normal -search. - -The following will search for box, Box, and BOX: -> - :thematic -search box -< -When given a single word to operate on, :Subvert defaults to doing a -search as well: -> - :S/box/ -< -This one searches for box, boxes, boxed, boxing, Box, Boxes, Boxed, Boxing, -BOX, BOXES, BOXED, and BOXING: -> - :S/box{,es,ed,ing}/ -< -The following syntaxes search in reverse. -> - :thematic! -search box - :S?box? -< -Flags can be given with the -flags= option to :thematic, or by appending them -after the separator to :Subvert. The flags trigger the following behaviors: - - I: Disable case variations (box, Box, BOX) - v: Match inside variable names (match my_box, myBox, but not mybox) - w: Match whole words (like surrounding with \< and \>) - -A |search-offset| may follow the flags. -> - :thematic -search -flags=avs+1 box - :S?box{,es,ed,ing}?we -< -GREPPING *thematic-grep* - -Grepping works similar to searching, and is invoked when additional options -are given. These options are passed directly to the :grep command. -> - :thematic -search box{,es} - :S /box{,es}/ * - :S /box/aw *.txt *.html -< -The slash delimiters must both be present if used with :Subvert. They may -both be omitted if no flags are used. - -Both an external grepprg and vimgrep (via grepprg=internal) are supported. -With an external grep, the "v" flag behaves less intelligently, due to the -lack of look ahead and look behind support in grep regexps. - -SUBSTITUTING *thematic-substitute* - -Giving a range switches :Subvert into substitute mode. This command will -change box -> bag, boxes -> bags, Box -> Bag, Boxes -> Bags, BOX -> BAG, -BOXES -> BAGS across the entire document: -> - :%thematic -substitute -flags=g box{,es} bag{,s} - :%S/box{,es}/bag{,s}/g -< -The "c", "e", "g", and "n" flags can be used from the substitute command -|:s_flags|, along with the "a", "I", "v", and "w" flags from searching. - -COERCION *thematic-coercion* *cr* - -thematic's case mutating algorithms can be applied to the word under the cursor -using the cr mapping (mnemonic: CoeRce) followed by one of the following -characters: - - c: camelCase - m: MixedCase - _: snake_case - s: snake_case - u: SNAKE_UPPERCASE - U: SNAKE_UPPERCASE - -: dash-case (not reversible) - -For example, cru on a lowercase word is a slightly easier to type equivalent -to gUiw. - - vim:tw=78:ts=8:ft=help:norl: