diff --git a/vim/autoload/togglebg.vim b/vim/autoload/togglebg.vim deleted file mode 100644 index 108511f..0000000 --- a/vim/autoload/togglebg.vim +++ /dev/null @@ -1,55 +0,0 @@ -" Toggle Background -" Modified: 2011 Apr 29 -" Maintainer: Ethan Schoonover -" License: OSI approved MIT license - -if exists("g:loaded_togglebg") - finish -endif -let g:loaded_togglebg = 1 - -" noremap is a bit misleading here if you are unused to vim mapping. -" in fact, there is remapping, but only of script locally defined remaps, in -" this case TogBG. The - - - - - - diff --git a/vim/doc/javacomplete.txt b/vim/doc/javacomplete.txt deleted file mode 100644 index ef5f211..0000000 --- a/vim/doc/javacomplete.txt +++ /dev/null @@ -1,568 +0,0 @@ -*javacomplete.txt* For Vim version 7.0 and above. Last change: 2011-01-30 - - JAVACOMPLETE REFERENCE MANUAL by cheng fang~ - fangread@yahoo.com.cn~ - - -1. Overview |javacomplete-overview| - 1.1 Features |javacomplete-features| - 1.2 Requirements |javacomplete-requirements| - 1.3 Download |javacomplete-download| - 1.4 Install |javacomplete-install| -2. Usage |javacomplete-usage| - 2.1 Input contexts |javacomplete-contexts| - 2.2 Kind letter |javacomplete-kindletter| - 2.3 Options |javacomplete-options| - 2.4 Commands |javacomplete-commands| -3. Java parser in Vim |javacomplete-parser| - 3.1 Abstract Syntax Tree |javacomplete-ast| - 3.2 Global Constants |javacomplete-constants| - 3.3 Parsing Functions |javacomplete-functions| - 3.4 Sample |javacomplete-sample| -4. FAQ |javacomplete-faq| -5. Limitations |javacomplete-limitations| -6. History - 6.1 javacomplete |javacomplete-history| - 6.2 Parser |java-parser-history| - 6.2 Reflection.java |javacomplete-reflection| -7. Todo |javacomplete-todo| -8. Thanks |javacomplete-thanks| - -============================================================================== -1. Overview *javacomplete-overview* - -This is javacomplete, an omni-completion script of JAVA language for vim 7 and -above. It includes javacomplete.vim, java_parser.vim, Reflection.java, and -javacomplete.txt. - -1.1 Features *javacomplete-features* - -- List members of a class, including (static) fields, (static) methods and ctors. -- List classes or subpackages of a package. -- Provide parameters information of a method, list all overload methods. -- Complete an incomplete word. -- Provide a complete JAVA parser written in Vim script language. -- Use the JVM to obtain most information. -- Use the embedded parser to obtain the class information from source files. -- Tags generated by ctags can also be used. -- JSP is supported, Builtin objects such as request, session can be recognized. - The classes and jar files in the WEB-INF will be appended automatically to the classpath. - -1.2 Requirements *javacomplete-requirements* - -It works on all the platforms wherever -- Vim version 7.0 and above, -- JDK version 1.1 and above, -exists. - -1.3 Download *javacomplete-download* - -You can download the lastest version from this url: - http://www.vim.org/scripts/script.php?script_id=1785 - -1.4 Install *javacomplete-install* - -1. Unzip javacomplete.zip to a directory of 'runtimepath', e.g. -$HOME/.vim (unix/linux), $VIM/vimfiles (windows). > - > unzip javacomplete.zip -d ~/.vim - -< To update Vim help tags, run vim and run command: > - :helptags $HOME/.vim/doc -< or > - :helptags $VIM/vimfiles/doc - -NOTE: javacomplete.vim, java_parser.vim and Reflection.java should be in one -autoload directory of 'runtimepath'. -javacomplete.txt should be in one doc directory of 'runtimepath'. - -2. Set 'omnifunc' option. e.g. > - :setlocal omnifunc=javacomplete#Complete -< Or, use autocmd: > - :" Only do this part when compiled with support for autocommands. - :if has("autocmd") - : autocmd Filetype java setlocal omnifunc=javacomplete#Complete - :endif -You can add this command to your .vimrc or _vimrc. - -3. Set 'completefunc' option to show parameters information IF YOU LIKE. e.g. > - :setlocal completefunc=javacomplete#CompleteParamsInfo -You can map as follows for better display: > - :inoremap - :inoremap - -4. Reflection.java will be automatcally compiled and placed to $HOME when you -use first time. Assure that Reflection.java is in the same directory with -javacomplete.vim to be searched in autoload subdirectory of &rtp. -If no Reflection.class is generated, check that you have the write permission -in $HOME directory. -If a previous Reflection.java is not compatible with the new version -javacomplete.vim, please compile Reflection.java manually. - -============================================================================== -2. Usage *javacomplete-usage* - -You can use it like other omni-completion script. Many samples of input context -are gived in the following section. - -Make sure a JVM launcher (default 'java') can be searched in the PATH enviroment -variable, otherwise Use javacomplete#SetJVMLauncher() to specify one. See option -`javacomplete-launcher`. - -See FAQ in time if some problem occurs. When meeting other problems not -described in FAQ, you can contact with the auther by the following e-mail: -fangread@yahoo.com.cn - -2.1 Input contexts |javacomplete-contexts| -It recognize nearly all kinds of Primary Expressions (see langspec-3.0) -except for "Primary.new Indentifier". Casting conversion is also supported. - -Samples of input contexts are as following: (Note that '|' indicates cursor) - (1). after '.', list members of a class or a package - - package.| subpackages and classes of a package - - Type.| static members of the 'Type' class and "class" - - var.| or field.| members of a variable or a field - - method().| members of result of method() - - this.| members of the current class - - ClassName.this.| members of the qualified class - - super.| members of the super class - - array.| members of an array object - - array[i].| array access, return members of the element of array - - "String".| String literal, return members of java.lang.String - - int.| or void.| primitive type or pseudo-type, return "class" - - int[].| array type, return members of a array type and "class" - - java.lang.String[].| - - new int[].| members of the new array instance - - new java.lang.String[i=1][].| - - new Type().| members of the new class instance - - Type.class.| class literal, return members of java.lang.Class - - void.class.| or int.class.| - - ((Type)var).| cast var as Type, return members of Type. - - (var.method()).| same with "var.|" - - (new Class()).| same with "new Class().|" - - (2). after '(', list matching methods with parameters information. - - method(|) methods matched - - var.method(|) methods matched - - new ClassName(|) constructors matched - - this(|) constructors of current class matched - - super(|) constructors of super class matched - Any place between '(' and ')' will be supported soon. - Help information of javadoc is not supported yet. - - (3). after an incomplete word, list all the matched beginning with it. - - var.ab| subset of members of var beginning with `ab` - - ab| list of all maybes - - (4). import statement - - " import java.util.|" - - " import java.ut|" - - " import ja|" - - " import java.lang.Character.|" e.g. "Subset" - - " import static java.lang.Math.|" e.g. "PI, abs" - - (5). package declaration - - " package com.|" - - The above are in simple expression. - (6). after compound expression: - - PrimaryExpr.var.| - - PrimaryExpr.method().| - - PrimaryExpr.method(|) - - PrimaryExpr.var.ab| - e.g. - - "java.lang . System.in .|" - - "java.lang.System.getenv().|" - - "int.class.toString().|" - - "list.toArray().|" - - "new ZipFile(path).|" - - "new ZipFile(path).entries().|" - - (7). Nested expression: - - "System.out.println( str.| )" - - "System.out.println(str.charAt(| )" - - "for (int i = 0; i < str.|; i++)" - - "for ( Object o : a.getCollect| )" - - -2.2 Kind letter *javacomplete-kindletter* - -A single letter indicates the kind of compeltion item. These kinds are: - + ctor - v local variable or parameter - f nonstatic field - F static field - m nonstatic method - M static method - P package - C class type - I interface type - -2.3 Options *javacomplete-options* - -1. Set java compiler (default 'javac') using the following function: - javacomplete#SetCompiler('javac') *javacomplete-compiler* - -2. Set java launcher (default 'java') using the following function: - javacomplete#SetJVMLauncher('java') *javacomplete-launcher* - -3. Set classpath using the following function: > - javacomplete#AddClassPath('jarfile_or_classes_path') - javacomplete#DelClassPath('jarfile_or_classes_path') - javacomplete#SetClassPath('semicolon_separated_string') -< - Another two variables will be used if they are existing: - |g:java_classpath| global classpath - |b:classpath| associated with current buffer - In one sense, s:classpath is like a classpath option for a PROJECT. - If some of them are body set, the priority of these variables is: - first, b:classpath first, - second, s:classpath - third, g:java_classpath - last, $CLASSPATH - -4. Set sourcepath using the following function: > - javacomplete#AddSourcePath('sources_file_path') - javacomplete#DelSourcePath('sources_file_path') - javacomplete#SetSourcePath('sources_file_path') - -5. Set option for using JDK1.1 if you meet the problem described in FAQ 3: > - javacomplete#UseJDK11() - -6. Set methods to search declaration: > - " 1 - by builtin searchdecl(), quickest but inaccurate in many cases. - " 2 - by special Searchdecl(), work NOT WELL YET. - " 4 - by java_parser, slowest but accurate in most cases. Not for JSP. - javacomplete#SetSearchdeclMethod() - -2.4 Commands *javacomplete-commands* - -============================================================================== -3. Java parser in Vim *javacomplete-parser* - -3.1 Abstract Syntax Tree *javacomplete-ast* - -3.2 Global Constants *javacomplete-constants* - -3.3 Parsing Functions *javacomplete-functions* - -3.4 Sample Codes *javacomplete-sample* -This parser can be a good candidate for anyone who needs a java parser to get -a abstract syntax tree for many use. The following are sample codes: > - - " NOTE: The script contains a single parser instance. You cannot create - " another parser! The only way to parse another JAVA code is reset the - " parser by calling java_parser#InitParser(). - - " 1. Initialize the parser - " for a code snippet, - call java_parser#InitParser(['for (int i = 0; i < N; i++) {', '', '}']) - " or for the current buffer, - call java_parser#InitParser(getline('^', '$')) - " or for a whole source file - call java_parser#InitParser(readfile('java/util/Arrays.java')) - - " 2. Get the result tree - call java_parser#compilationUnit() - " or others according to the input code - call java_parser#expression() - call java_parser#block() - call java_parser#statement() - - " 3. Use the tree as you like - - " 4. The default scan strategy is scanning only sklenton. - " You can change it by set the option 'scanStrategy'. - " The values for 'scanStrategy' option are: - " 0 - only class members when parse full file; - " 1 - keep statement as a whole string; - " 2 - all - call java_parser#InitParser(getline('^', '$'), {'scanStrategy': 2}) - - " 5. I recommend that keeping scanStrategy as default. - " If you want to parse a code snippet such as a method body of the whole - " file, you can call java_parser#GotoPosition() to go to what you are going - " to start parsing. - " Then, call java_parser#block(), java_parser#statement() or - " java_parser#expression() to parse the smaller snippet. - " NOTE: This way will keep the result tree reserved. - call java_parser#GotoPosition(def.body.pos) - call java_parser#block() - -============================================================================== -4. FAQ *javacomplete-faq* - -(1). When you meets the following problem: > - omni-completion error: Exception in thread "main" - java.lang.NoClassDefFoundError: Reflection -It is Reflection.class not found in autoload directory or $HOME that cause -this problem. -There are several reasons causing this problem: - o No compiler. Use javacomplete#SetCompiler() to specify one. - o No write permission for $HOME directory. - -(2). Reflection.java should be searched in autoload subdirectory of &rtp. -Reflection.class should be searched in $HOME or autoload subdirectory of &rtp. -If not found, javacomplete try to compile it and place the generated class -file in $HOME. - -(3). A error when using JDK1.1: - Unable to initialize threads: cannot find class java/lang/Thread -When I tested JDK1.1.8 on Windows XP, I found -classpath options cause it. -There are two way to avoid it is: - o Add the runtime classes to classpath, like - "${JDK118}\classes;${JDK118}\lib\classes.zip;${JDK118}\lib\classes.jar;" - o Add Reflection.class and others to the CLASSPATH enviroment variable. - And call javacomplete#UseJDK11() to set option. - -============================================================================== -5. Limitations *javacomplete-limitations* - -The embedded parser works a bit slower than expected. - -============================================================================== -6. History - -6.1 javacomplete *javacomplete-history* - -v0.77.1.2 - 2011-01-30 Fixed to adapt globpath() (vim < 7.2). Patched by Sam Lidder. - -v0.77.1.1 - 2010-11-12 Fixed to ignore the 'suffixes' and 'wildignore' options which - make Reflection.class can not be found. - -v0.77.1 - 2007-09-19 Supported showing method parameters information in any place - between parenthesises. - -v0.77 - 2007-09-19 bug fix - 2007-09-18 Added GetCurrentFileKey() avoid empty key of s:files for current buffer. - 2007-09-16 Use a new strategy for searching inherited members. - 2007-09-11 - - Supported new contexts "jav|", "var|", just after an incomplete word. - - Supported new context "abs(|)", a imported static method. - 2007-09-10 - - Improved FoundClassDeclaration() - - Fixed bug calling cursor(0, 0) - 2007-09-09 Rewrote DoGetClassInfo(), GetFQN() and IsFQN()¡£ - 2007-09-08 Fixed a bug when merging superclass's members - 2007-09-05 -- 07 - - Improved s:MergeLines() and s:ExtractCleanExpr(). - - Rewrote CompleteAfterDot(). Added ParseExpr(). Removed s:GetNextSubexprType() - - Supported accessible static imported members. - - Supported accessible inherited members. - - 2007-09-04 Used b:changedtick and getftime() to check buffer (or other file) for changing. - 2007-09-01 Supported not-file-name toplevel or static member class in source files. - -v0.76.8 - 2007-08-30 - - Created the s:TreeVisitor to search type or symbol names. - - Supported local and anonymous class. - - 2007-08-29 - - Supported appending automatically classpath under WEB-INF for jsp files. - -v0.76.7 - 2007-08-28 - - Fixed case of "new java.util.zip.ZipFile().|" - - Improved process of type arguments and method parameters. JAVA5+ - - Reorganize codes in javacomplete#Complete() - - Added CONTEXT_NEED_TYPE, removed CONTEXT_INCOMPLETE_WORD - - 2007-08-24 Add Context types for type declaration: CONTEXT_NEED_TYPE - -v0.76.6 - 2007-08-23 Improved GetStatement() and related. Bug fixed. - -v0.76.5 - 2007-08-21 - - Fixed bug: "foo().|", "getFoo().foo().|", - "for (Enumeration entries = ; entries.|; )". - - Supported input contexts: "((Object)o).|", "((Object)o).getClass().|", - "new ZipFile(path).|", "(new String().)|". - -v0.76.4 - 2007-08-17 - - Improved input contexts: "int.class.toString().|", "list.toArray().|". - - Fixed recognizing "this(|)", "method1(|)" - - Added the 'kind' letter to distinguish between classes and packages. - 2007-08-14 - - Support accessible nested classes. - - Support import static members and import accessible nested classes. - 2007-08-11 - - Fixed a bug when Reflection.java is in the path which contains space. - - Improved process of this and super in JSP. - - Fixed an severe bug parsing current jsp file. - -v0.76.3 - 2007-08-10 - - Add an option 'searchdecl' set by javacomplete#SetSearchdeclMethod(). - - Make an improvement for jsp file. - - Clear cache when set options affecting classpath. - - Improved DoGetPackageList() and s:GenerateImports(). - - Replace codes searching list of string with index(). - -v0.76.2 - 2007-08-08 - - Fix failing to list members of nested class. - - Combine members of local packages and loadable packages. - - Add quick recognition of package or import. - 2007-08-06 Add inherited fields and methods to local class. - -v0.76.1 - 2007-08-04 - - Fix using a: in javacomplete#SetClassPath() - - Fix a bug in javacomplete#GetClassPath() - -v0.76 2007-08-04 - 2007-08-04 - - Fix a infinite loop bug in s:GetMatchedIndexEx() - - Fix that array type not recognised in compound expression. - - Add a option for JDK1.1. See FAQ 3. - 2007-08-03 - - Improve for 'this' or 'super'. - - Support searching toplevel class in sourcepath. - - Clean - 2007-08-02 - - Improve the process of checking a class in one of packages. - 2007-08-01 - - Add Searchdecl() using java_parser.vim to provide quick information. - - Supports input context: "StringLiteral".|, "int.|", "void.|" - 2007-07-28 - - Automatcally compile Reflection.java and place it to $HOME. - - Add option 'javacompiler', default 'javac' - - Add option 'java', default 'java' - -v0.75 2007-02-13 - - Add java_parser.vim. - - Add b:sourcepath option. - - Improve recognition of classes defined in current buffer or in source path. - - Support generating class information from tags instead of returning list directly. - -v0.74 2007-02-03 - - Support jre1.2 (and above). - - Support input context like "boolean.class.|" - - Handle java primitive types like 'int'. - -v0.73 2007-02-01 - - Fix bug that CLASSPATH not used when b:classpath or g:java_classpath not set. - - Fix bug that call filter() without making a copy for incomplete. - - Improve recognition of declaration of this class - -v0.72 2007-01-31 Handle nested expression. -v0.71 2007-01-28 Add Basic support for class in current folder. -v0.70 2007-01-27 Complete the reflection part. -v0.60 2007-01-25 Design TClassInfo, etc. -v0.50 2007-01-21 Use java and Reflection.class directly. - - -6.2 Parser *java-parser-history* - -v0.67 - 2007-09-11 Append a error string to imported qid when error occurs. - 2007-09-10 Improved regexp constants. - 2007-09-07 Fixed type2Str(). Removed qualident2Str(). - -v0.66.1 08-30 Changed classCreatorRest(). -v0.66 08-27 Minor changes - -v0.65 - 2007-08-23 - - Improved s:scanComment(), s:Strpart(), s:String2Flags(). - - Improved recognizing methods, ctors, and variable declarators declared in most common form. - - Added s:optFinalParameter(), s:methodDeclaratorRest_opt(). - - Removed s:GetLine() and s:GetCol(). - - Rewrote binary functions. - -v0.64 - 2007-08-21 - - Added quick recognizing fields or methods declared in most common form. - - Optimized code: s:modeAndEXPR(), formalParameter(), and others. - -v0.63 - 2007-08-10 - - Removed the unclear s:tokens and s:modifier_keywords. - - Add java_parser#GetSnapshot() and java_parser#Restore(). - 2007-08-09 Fixed a bug when no top level class defined - -v0.62 2007-08-08 - 2007-08-08 Fix values in s:Flags and s:modifiersOpt() and the related. - 2007-08-07 Optimize code of scanDoubleQuote() and importDeclaration(). - -v0.61 2007-08-04 - 2007-08-01 Fix a bug typetag(). return a:token -> return tolower(a:token) - 2007-07-31 - - Rename all script functions matching "s:Java_\(\i\+\)" to "s:\1". - - Change s:EOI = '' - - Use get() instead of s:GetOption(). Remove it. - - Use repeat() instead of s:PrependChar(). Remove it. - - Improve scanChar() - -v0.60 2007-07-31 Now it nearly is a complete parser and support Java5,6. - And tested correctly on all java files in jdk6 src.zip. - 2007-07-19 Support new language features in java 5 and above. - 2007-07-25 Add supports for parsing statement, block or expression - 2007-07-28 Place it to autoload directory. - 2007-07-30 Clean this script. - -v0.51 2007-02-13 Optimize several scan function. -v0.50 2007-02-10 Complete the skeleton. - - -6.3 Reflection.java *javacomplete-reflection* - -v0.77 - 2007-09-14 Improved generating information of all packages in jar files. - 2007-09-06 - - Improved getting paths of all system jar files for different JDKs - in different platforms. - 2007-08-14 Major improvement. Support nontoplevel classes. - -v0.76.3 - 2007-08-09 Redefined '-P' option for returning all packages and subpackages info in one time. - -v0.76.2 - 2007-08-06 Return a modifier value as a string because it more than 32bit. - -v0.76 - 2007-08-04 Support checking and reading package members for '-E'. - 2007-08-02 - - Add an option '-E'. - - Use ZipFile and ZipEntry instead of JarFile and JarEntry, - so that it can be compiled by and run on JDK1.1 and above. -v0.7 2007-02-17 - -============================================================================== -7. Todo *javacomplete-todo* - -- Improve performance of the embedded parser. Incremental parser. -- Add quick information using balloonexpr, ballooneval, balloondelay. -- Add javadoc -- Give a hint for class name conflict in different packages. -- Support parameter information for template - -============================================================================== -8. Thanks *javacomplete-thanks* - * Bram Moolenaar and all Vim contributors for Vim - * The insenvim project - * The javac and gjc sources - * All of you for using this script :) - - * For help, documentation, bug report : - Martin Stubenschrott author of IComplete - Vissale NEANG author of OmniCppComplete - David Fishburn author of SQLComplete and others - Nico Weber testing on the Mac - Thomas Link testing on cygwin+bash - Zhixing Yu - * For the bug of 'wildignore' options - Rodrigo Rosenfeld Rosas - Alexandru Mo?oi - -FeedBack: -Any problem, bug or suggest are welcome to send to fangread@yahoo.com.cn - -============================================================================== - vim:tw=78:ts=8:ft=help:norl: diff --git a/vim/doc/solarized.txt b/vim/doc/solarized.txt deleted file mode 100644 index 93ebd68..0000000 --- a/vim/doc/solarized.txt +++ /dev/null @@ -1,254 +0,0 @@ -*solarized.vim* for Vim version 7.3 or newer. Modified: 2011 May 05 - - - Solarized Vim Colorscheme by Ethan Schoonover ~ - -Solarized Colorscheme *solarized* - *solarized-help* - *solarized-colors* - *solarized-colorscheme* - *vim-colors-solarized* - -Solarized is a carefully designed selective contrast colorscheme with dual -light and dark modes that runs in both GUI, 256 and 16 color modes. - -See the homepage at http://ethanschoonover.com/solarized for screenshots and -details. - -0. Install |solarized-install| -1. Solarized Menu |solarized-menu| -2. Options |solarized-options| -3. Toggle Background |solarized-togglebg| -4. Terminal Issues |solarized-term| - -============================================================================== -0. Install *solarized-install* - -Note: I recommend using Tim Pope's pathogen plugin to install this -colorscheme. See https://github.com/tpope/vim-pathogen . If you've installed -pathogen properly you can install Solarized with the following commands, -followed by the .vimrc configuration below. - - $ cd ~/.vim/bundle - $ git clone https://github.com/altercation/vim-colors-solarized.git - -If you aren't using pathogen, you can use the following three steps to install -Solarized: - -1. Download the solarized distribution (available on the homepage above) - and unarchive the file. - -2. Move `solarized.vim` to your `.vim/colors` directory. - -3. Move each of the files in each subdirectories to the corresponding .vim - subdirectory (e.g. autoload/togglebg.vim goes into your .vim/autoload - directory as .vim/autoload/togglebg.vim). - - -After installation, place the following lines in your .vimrc: - - syntax enable - set background=dark - colorscheme solarized - -or, for the light background mode of Solarized: - - syntax enable - set background=light - colorscheme solarized - -============================================================================== -1. Solarized Menu *solarized-menu* - -Solarized makes available a menu when used in Vim GUI mode (gvim, macvim). -This menu includes many of the options detailed below so that you can test out -different values quickly without modifying your .vimrc file. If you wish to -turn off this menu permanently, simply place the following line in your .vimrc -above the "colorscheme solarized" line. - - let g:solarized_menu=0 - -============================================================================== -2. Toggle Background *solarized-togglebg* - *toggle-bg* *togglebg* - *toggle-background* - -Solarized comes with Toggle Background, a simple plugin to switch between -light and dark background modes and reset the colorscheme. This is most useful -for colorschemes that support both light and dark modes and in terminals or -gui vim windows where the background will be properly set. - -Toggle Background can be accessed by: - - * the Solarized menu (in Vim gui mode) - * the Window menu (in Vim gui mode, even if the Solarized menu is off) - * the "yin/yang" toolbar button (in Vim gui mode) - * the default mapping of - * custom key mapping you set in your .vimrc (see below) - * command line via ":ToggleBG" (no quotes) - -Toggle Background starts with a default mapping to function key . If you -are already using this in a mapping, Toggle Background will not map itself to -a default and you will have to map it manually in your .vimrc file, or -remove/change your existing mapping to another value. To customize the -keyboard mapping in your .vimrc file, use the following line, changing the -"" value to the key or key combination you wish to use: - - call togglebg#map("") - -Note that you'll want to use a single function key or equivalent if you want -the plugin to work in all modes (normal, insert, visual). - -When using the plugin during normal, visual, or insert mode, there should be -no interruption in workflow. However, if you activate the plugin during -REPLACE mode, you will switch to standard insert mode (you will leave the -overwrite replace mode). - -============================================================================== -3. Solarized Terminal Issues *solarized-term* - -If you are going to use Solarized in Terminal mode (i.e. not in a GUI version -like gvim or macvim), **please please please** consider setting your terminal -emulator's colorscheme to used the Solarized palette. I've included palettes -for some popular terminal emulator as well as Xdefaults in the official -Solarized download available from the Solarized homepage listed at the top of -this help document. If you use Solarized *without* these colors, Solarized -will need to be told to degrade its colorscheme to a set compatible with the -limited 256 terminal palette (whereas by using the terminal's 16 ansi color -values, you can set the correct, specific values for the Solarized palette). - -If you do use the custom terminal colors, solarized.vim should work out of -the box for you. If you are using a terminal emulator that supports 256 -colors and don't want to use the custom Solarized terminal colors, you will -need to use the degraded 256 colorscheme. To do so, simply add the following -line *before* the `colorschem solarized` line: - - let g:solarized_termcolors=256 - -Again, I recommend just changing your terminal colors to Solarized values -either manually or via one of the many terminal schemes available for import. - -============================================================================== -4. Solarized Options *solarized-options* - - -AUTOGENERATE OPTIONS - -You can easily modify and experiment with Solarized display options using the -Solarized menu when using Vim in gui mode. Once you have things set to your -liking, you can autogenerate the current option list in a format ready for -insertion into your .vimrc file using the Solarized menu "Autogenerate -Options" command or at the command line with: - - :SolarizedOptions - - -OPTION LIST - -Set these in your vimrc file prior to calling the colorscheme. - -option name default optional ------------------------------------------------- -g:solarized_termcolors= 16 | 256 -g:solarized_termtrans = 0 | 1 -g:solarized_degrade = 0 | 1 -g:solarized_bold = 1 | 0 -g:solarized_underline = 1 | 0 -g:solarized_italic = 1 | 0 -g:solarized_contrast = "normal"| "high" or "low" -g:solarized_visibility= "normal"| "high" or "low" -g:solarized_hitrail = 0 | 1 -g:solarized_menu = 1 | 0 ------------------------------------------------- - - -OPTION DETAILS - ------------------------------------------------- -g:solarized_termcolors= 256 | 16 *'solarized_termcolors'* ------------------------------------------------- -The most important option if you are using vim in terminal (non gui) mode! -This tells Solarized to use the 256 degraded color mode if running in a 256 -color capable terminal. Otherwise, if set to `16` it will use the terminal -emulators colorscheme (best option as long as you've set the emulators colors -to the Solarized palette). - -If you are going to use Solarized in Terminal mode (i.e. not in a GUI -version like gvim or macvim), **please please please** consider setting your -terminal emulator's colorscheme to used the Solarized palette. I've included -palettes for some popular terminal emulator as well as Xdefaults in the -official Solarized download available from: -http://ethanschoonover.com/solarized . If you use Solarized without these -colors, Solarized will by default use an approximate set of 256 colors. It -isn't bad looking and has been extensively tweaked, but it's still not quite -the real thing. - ------------------------------------------------- -g:solarized_termtrans = 0 | 1 *'solarized_termtrans'* ------------------------------------------------- -If you use a terminal emulator with a transparent background and Solarized -isn't displaying the background color transparently, set this to 1 and -Solarized will use the default (transparent) background of the terminal -emulator. *urxvt* required this in my testing; iTerm2 did not. - -Note that on Mac OS X Terminal.app, solarized_termtrans is set to 1 by -default as this is almost always the best option. The only exception to this -is if the working terminfo file supports 256 colors (xterm-256color). - ------------------------------------------------- -g:solarized_degrade = 0 | 1 *'solarized_degrade'* ------------------------------------------------- -For test purposes only; forces Solarized to use the 256 degraded color mode -to test the approximate color values for accuracy. - ------------------------------------------------- -g:solarized_bold = 1 | 0 *'solarized_bold'* ------------------------------------------------- ------------------------------------------------- -g:solarized_underline = 1 | 0 *'solarized_underline'* ------------------------------------------------- ------------------------------------------------- -g:solarized_italic = 1 | 0 *'solarized_italic'* ------------------------------------------------- -If you wish to stop Solarized from displaying bold, underlined or -italicized typefaces, simply assign a zero value to the appropriate -variable, for example: `let g:solarized_italic=0` - ------------------------------------------------- -g:solarized_contrast = "normal"| "high" or "low" *'solarized_contrast'* ------------------------------------------------- -Stick with normal! It's been carefully tested. Setting this option to high -or low does use the same Solarized palette but simply shifts some values up -or down in order to expand or compress the tonal range displayed. - ------------------------------------------------- -g:solarized_visibility = "normal"| "high" or "low" *'solarized_visibility'* ------------------------------------------------- -Special characters such as trailing whitespace, tabs, newlines, when -displayed using ":set list" can be set to one of three levels depending on -your needs. - ------------------------------------------------- -g:solarized_hitrail = 0 | 1 *'solarized_hitrail'* ------------------------------------------------- -Visibility can make listchar entities more visible, but if one has set -cursorline on, these same listchar values standout somewhat less due to the -background color of the cursorline. g:solarized_hitrail enables highlighting -of trailing spaces (only one of the listchar types, but a particularly -important one) while in the cursoline in a different manner in order to make -them more visible. This may not work consistently as Solarized is using -a pattern match than can be overridden by a more encompassing syntax-native -match such as a comment line. - - ------------------------------------------------- -g:solarized_menu = 1 | 0 *'solarized_menu'* ------------------------------------------------- -Solarized includes a menu providing access to several of the above -display related options, including contrast and visibility. This allows -for an easy method of testing different values quickly before settling -on a final assignment for your .vimrc. If you wish to turn off this menu, -assign g:solarized_menu a value of 0. - - - vim:tw=78:noet:ts=8:ft=help:norl: diff --git a/vim/doc/tags b/vim/doc/tags deleted file mode 100644 index 22e5d5c..0000000 --- a/vim/doc/tags +++ /dev/null @@ -1,51 +0,0 @@ -'solarized_bold' solarized.txt /*'solarized_bold'* -'solarized_contrast' solarized.txt /*'solarized_contrast'* -'solarized_degrade' solarized.txt /*'solarized_degrade'* -'solarized_hitrail' solarized.txt /*'solarized_hitrail'* -'solarized_italic' solarized.txt /*'solarized_italic'* -'solarized_menu' solarized.txt /*'solarized_menu'* -'solarized_termcolors' solarized.txt /*'solarized_termcolors'* -'solarized_termtrans' solarized.txt /*'solarized_termtrans'* -'solarized_underline' solarized.txt /*'solarized_underline'* -'solarized_visibility' solarized.txt /*'solarized_visibility'* -before solarized.txt /*before* -java-parser-history javacomplete.txt /*java-parser-history* -javacomplete-ast javacomplete.txt /*javacomplete-ast* -javacomplete-commands javacomplete.txt /*javacomplete-commands* -javacomplete-compiler javacomplete.txt /*javacomplete-compiler* -javacomplete-constants javacomplete.txt /*javacomplete-constants* -javacomplete-download javacomplete.txt /*javacomplete-download* -javacomplete-faq javacomplete.txt /*javacomplete-faq* -javacomplete-features javacomplete.txt /*javacomplete-features* -javacomplete-functions javacomplete.txt /*javacomplete-functions* -javacomplete-history javacomplete.txt /*javacomplete-history* -javacomplete-install javacomplete.txt /*javacomplete-install* -javacomplete-kindletter javacomplete.txt /*javacomplete-kindletter* -javacomplete-launcher javacomplete.txt /*javacomplete-launcher* -javacomplete-limitations javacomplete.txt /*javacomplete-limitations* -javacomplete-options javacomplete.txt /*javacomplete-options* -javacomplete-overview javacomplete.txt /*javacomplete-overview* -javacomplete-parser javacomplete.txt /*javacomplete-parser* -javacomplete-reflection javacomplete.txt /*javacomplete-reflection* -javacomplete-requirements javacomplete.txt /*javacomplete-requirements* -javacomplete-sample javacomplete.txt /*javacomplete-sample* -javacomplete-thanks javacomplete.txt /*javacomplete-thanks* -javacomplete-todo javacomplete.txt /*javacomplete-todo* -javacomplete-usage javacomplete.txt /*javacomplete-usage* -javacomplete.txt javacomplete.txt /*javacomplete.txt* -solarized solarized.txt /*solarized* -solarized-colors solarized.txt /*solarized-colors* -solarized-colorscheme solarized.txt /*solarized-colorscheme* -solarized-help solarized.txt /*solarized-help* -solarized-install solarized.txt /*solarized-install* -solarized-menu solarized.txt /*solarized-menu* -solarized-options solarized.txt /*solarized-options* -solarized-term solarized.txt /*solarized-term* -solarized-togglebg solarized.txt /*solarized-togglebg* -solarized.vim solarized.txt /*solarized.vim* -toggle-background solarized.txt /*toggle-background* -toggle-bg solarized.txt /*toggle-bg* -togglebg solarized.txt /*togglebg* -urxvt solarized.txt /*urxvt* -vim-colors-solarized solarized.txt /*vim-colors-solarized* -without solarized.txt /*without*