summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorHugues Hiegel <hugues.hiegel@qosmos.com>2013-04-25 16:58:15 +0200
committerHugues Hiegel <hugues.hiegel@qosmos.com>2013-04-25 16:59:48 +0200
commitaf47b3d8e6875f093502e45fbed918263e693331 (patch)
tree55fbd2357a4fe2a5e0cf2ef2cc4787a0a4b67b77 /doc
parent002782c54670a1f02b6f0cd62e23b2a1b3b9660f (diff)
[AnsiEsc] Ansi Escapes plugin
Diffstat (limited to 'doc')
-rw-r--r--doc/AnsiEsc.txt134
-rw-r--r--doc/tags76
2 files changed, 210 insertions, 0 deletions
diff --git a/doc/AnsiEsc.txt b/doc/AnsiEsc.txt
new file mode 100644
index 0000000..4fe361e
--- /dev/null
+++ b/doc/AnsiEsc.txt
@@ -0,0 +1,134 @@
+*AnsiEsc.txt* Ansi Escape Sequence Visualization Dec 13, 2010
+
+Author: Charles E. Campbell, Jr. <NdrOchip@ScampbellPfamily.AbizM>
+ (remove NOSPAM from Campbell's email first)
+Copyright: (c) 2004-2010 by Charles E. Campbell, Jr. *AnsiEsc-copyright*
+ The VIM LICENSE applies to AnsiEsc.vim and AnsiEsc.txt
+ (see |copyright|) except use "AnsiEsc" instead of "Vim".
+ No warranty, express or implied. Use At-Your-Own-Risk.
+
+==============================================================================
+1. Contents *AnsiEsc* *AnsiEsc-contents*
+ 1. Contents ...................................|AnsiEsc-contents|
+ 2. AnsiEsc Manual ...................................|AnsiEsc|
+ 3. AnsiEsc History ...................................|AnsiEsc-history|
+
+==============================================================================
+2. Manual *AnsiEsc-manual*
+
+ CONCEAL -- the best mode.
+ For this, your vim must have +conceal. A typical way to get the
+ conceal feature:
+
+ * cd ..wherever../vim72/
+ * wget http://vince.negri.googlepages.com/conceal-ownsyntax.diff
+ * patch -p0 < conceal-ownsyntax.diff
+ * make distclean
+ * configure --with-features=huge
+ * make
+ * make install
+
+ Normal: -- ansi escape sequences themselves are Ignore'd~
+ Ansi escape sequences have the expected effect on subsequent
+ text, but the ansi escape sequences themselves still take up
+ screen columns. The sequences are displayed using "Ignore"
+ highlighting; depending on your colorscheme, this should either
+ make the sequences blend into your background or be visually
+ suppressed. If the sequences aren't suppressed, you need to
+ improve your colorscheme!
+
+ USAGE~
+ :AnsiEsc -- toggles Ansi escape sequence highlighting
+ :AnsiEsc! -- rebuilds highlighting for new/removed three
+ or more element Ansi escape sequences.
+
+ RESULT~
+ Ansi escape sequences become concealed or ignored (depending
+ on whether your vim supports Negri's conceal mode), and their
+ effect on subsequent text is emulated with Vim's syntax
+ highlighting.
+
+ Syntax highlighting for one and two element codes are
+ hard-coded into AnsiEsc.vim. There are too many possibilities
+ for three or more element codes; these are supported by
+ examining the file for such sequences and only building syntax
+ highlighting rules for such sequences as are actually present
+ in the document.
+
+ EXAMPLE~
+
+ You'll want to use :AnsiEsc to see the following properly!
+ (using Vince Negri's conceal option or vim 7.3)
+
+ Color Escape Sequences
+ -   1   2   3   4   5   7 
+black black black black black black black
+red red red red red red red
+green green green green green green green
+yellow yellow yellow yellow yellow yellow yellow
+blue blue blue blue blue blue blue
+magenta magenta magenta magenta magenta magenta magenta
+cyan cyan cyan cyan cyan cyan cyan
+white white white white white white white
+
+Black B B B B B B B B
+Red R R R R R R R R
+Green G G G G G G G G
+Yellow Y Y Y Y Y Y Y Y
+Blue B B B B B B B B
+Magenta M M M M M M M M
+Cyan C C C C C C C C
+White W W W W W W W W
+
+ Here's the vim logo:
+
+ / \
+ / \
+ / \
+ / \
+ +----+ +----+ \
+ ++ ++ +- | \
+ /| | / / \
+X | | / /O \
+ \| | / /+-+ +-\//-+
+ | |/ / | | | v |
+ | / / | | | + +|
+ | / | |/| |\/||
+ +----\ +-+ +-+ ++
+ \ /
+ \ /
+
+
+==============================================================================
+3. AnsiEsc History *AnsiEsc-history* {{{1
+ v12 Jul 23, 2010 * changed conc to |'cole'| to correspond to vim 7.3's
+ change
+ Aug 10, 2010 * (Rainer M Schmid) changed conceallevel setting to
+ depend on whether the version is before vim 7.3;
+ for 7.3, also sets concealcursor
+ * Restores conc/cole/cocu settings when AnsiEsc is
+ toggled off.
+ Dec 13, 2010 * Included some additional sequences involving 0
+ v11 Apr 20, 2010 * AnsiEsc now supports enabling/disabling via a menu
+ * <esc>[K and <esc>[00m now supported (as
+ grep --color=always issues them)
+ v10 May 06, 2009 * Three or more codes in an ANSI escape sequence are
+ supported by building custom syntax and highlighting
+ commands.
+ May 20, 2009 * cecutil bugfix
+ v9 May 12, 2008 * Now in plugin + autoload format. Provides :AnsiEsc
+ command to toggle Ansi-escape sequence processing.
+ Jan 01, 2009 * Applies Ignore highlighting to extended Ansi escape
+ sequences support 256-colors.
+ Mar 18, 2009 * Includes "rapid blink" ansi escape sequences. Vim
+ doesn't have a blinking attribute, so such text uses
+ "standout" for vim and "undercurl" for gvim.
+ v8 Aug 16, 2006 * Uses undercurl, and so is only available for vim 7.0
+ v7 Dec 14, 2004 * Works better with vim2ansi output and Vince Negri's
+ conceal patch for vim 6.x.
+ v2 Nov 24, 2004 * This version didn't use Vince Negri's conceal patch
+ (used Ignore highlighting)
+
+==============================================================================
+Modelines: {{{1
+vim:tw=78:ts=8:ft=help:fdm=marker:
diff --git a/doc/tags b/doc/tags
new file mode 100644
index 0000000..db8d2f0
--- /dev/null
+++ b/doc/tags
@@ -0,0 +1,76 @@
+:CVSEdit vcscommand.txt /*:CVSEdit*
+:CVSEditors vcscommand.txt /*:CVSEditors*
+:CVSUnedit vcscommand.txt /*:CVSUnedit*
+:CVSWatch vcscommand.txt /*:CVSWatch*
+:CVSWatchAdd vcscommand.txt /*:CVSWatchAdd*
+:CVSWatchOff vcscommand.txt /*:CVSWatchOff*
+:CVSWatchOn vcscommand.txt /*:CVSWatchOn*
+:CVSWatchRemove vcscommand.txt /*:CVSWatchRemove*
+:CVSWatchers vcscommand.txt /*:CVSWatchers*
+:VCSAdd vcscommand.txt /*:VCSAdd*
+:VCSAnnotate vcscommand.txt /*:VCSAnnotate*
+:VCSBlame vcscommand.txt /*:VCSBlame*
+:VCSCommit vcscommand.txt /*:VCSCommit*
+:VCSDelete vcscommand.txt /*:VCSDelete*
+:VCSDiff vcscommand.txt /*:VCSDiff*
+:VCSGotoOriginal vcscommand.txt /*:VCSGotoOriginal*
+:VCSInfo vcscommand.txt /*:VCSInfo*
+:VCSLock vcscommand.txt /*:VCSLock*
+:VCSLog vcscommand.txt /*:VCSLog*
+:VCSRemove vcscommand.txt /*:VCSRemove*
+:VCSRevert vcscommand.txt /*:VCSRevert*
+:VCSReview vcscommand.txt /*:VCSReview*
+:VCSStatus vcscommand.txt /*:VCSStatus*
+:VCSUnlock vcscommand.txt /*:VCSUnlock*
+:VCSUpdate vcscommand.txt /*:VCSUpdate*
+:VCSVimDiff vcscommand.txt /*:VCSVimDiff*
+AnsiEsc AnsiEsc.txt /*AnsiEsc*
+AnsiEsc-contents AnsiEsc.txt /*AnsiEsc-contents*
+AnsiEsc-copyright AnsiEsc.txt /*AnsiEsc-copyright*
+AnsiEsc-history AnsiEsc.txt /*AnsiEsc-history*
+AnsiEsc-manual AnsiEsc.txt /*AnsiEsc-manual*
+AnsiEsc.txt AnsiEsc.txt /*AnsiEsc.txt*
+VCSCommandCVSDiffOpt vcscommand.txt /*VCSCommandCVSDiffOpt*
+VCSCommandCVSExec vcscommand.txt /*VCSCommandCVSExec*
+VCSCommandCommitOnWrite vcscommand.txt /*VCSCommandCommitOnWrite*
+VCSCommandDeleteOnHide vcscommand.txt /*VCSCommandDeleteOnHide*
+VCSCommandDiffSplit vcscommand.txt /*VCSCommandDiffSplit*
+VCSCommandDisableExtensionMappings vcscommand.txt /*VCSCommandDisableExtensionMappings*
+VCSCommandDisableMappings vcscommand.txt /*VCSCommandDisableMappings*
+VCSCommandEdit vcscommand.txt /*VCSCommandEdit*
+VCSCommandEnableBufferSetup vcscommand.txt /*VCSCommandEnableBufferSetup*
+VCSCommandResultBufferNameExtension vcscommand.txt /*VCSCommandResultBufferNameExtension*
+VCSCommandResultBufferNameFunction vcscommand.txt /*VCSCommandResultBufferNameFunction*
+VCSCommandSVKExec vcscommand.txt /*VCSCommandSVKExec*
+VCSCommandSVNDiffExt vcscommand.txt /*VCSCommandSVNDiffExt*
+VCSCommandSVNDiffOpt vcscommand.txt /*VCSCommandSVNDiffOpt*
+VCSCommandSVNExec vcscommand.txt /*VCSCommandSVNExec*
+VCSCommandSplit vcscommand.txt /*VCSCommandSplit*
+b:VCSCommandCommand vcscommand.txt /*b:VCSCommandCommand*
+b:VCSCommandOriginalBuffer vcscommand.txt /*b:VCSCommandOriginalBuffer*
+b:VCSCommandSourceFile vcscommand.txt /*b:VCSCommandSourceFile*
+b:VCSCommandVCSType vcscommand.txt /*b:VCSCommandVCSType*
+cvscommand-changes vcscommand.txt /*cvscommand-changes*
+vcscommand vcscommand.txt /*vcscommand*
+vcscommand-buffer-management vcscommand.txt /*vcscommand-buffer-management*
+vcscommand-buffer-variables vcscommand.txt /*vcscommand-buffer-variables*
+vcscommand-bugs vcscommand.txt /*vcscommand-bugs*
+vcscommand-commands vcscommand.txt /*vcscommand-commands*
+vcscommand-config vcscommand.txt /*vcscommand-config*
+vcscommand-contents vcscommand.txt /*vcscommand-contents*
+vcscommand-customize vcscommand.txt /*vcscommand-customize*
+vcscommand-events vcscommand.txt /*vcscommand-events*
+vcscommand-install vcscommand.txt /*vcscommand-install*
+vcscommand-intro vcscommand.txt /*vcscommand-intro*
+vcscommand-manual vcscommand.txt /*vcscommand-manual*
+vcscommand-mappings vcscommand.txt /*vcscommand-mappings*
+vcscommand-mappings-override vcscommand.txt /*vcscommand-mappings-override*
+vcscommand-naming vcscommand.txt /*vcscommand-naming*
+vcscommand-options vcscommand.txt /*vcscommand-options*
+vcscommand-ssh vcscommand.txt /*vcscommand-ssh*
+vcscommand-ssh-config vcscommand.txt /*vcscommand-ssh-config*
+vcscommand-ssh-env vcscommand.txt /*vcscommand-ssh-env*
+vcscommand-ssh-other vcscommand.txt /*vcscommand-ssh-other*
+vcscommand-ssh-wrapper vcscommand.txt /*vcscommand-ssh-wrapper*
+vcscommand-statusline vcscommand.txt /*vcscommand-statusline*
+vcscommand.txt vcscommand.txt /*vcscommand.txt*