--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/thirdparty/color-theme-solarized/README.md Mon Feb 13 12:46:18 2012 -0600
@@ -0,0 +1,163 @@
+Solarized Colorscheme for Emacs
+===============================
+
+Stolen from Ethan Schoonover <[email protected]> by Greg Pfeil <[email protected]>
+
+Visit the [Solarized homepage]
+------------------------------
+
+See the [Solarized homepage] for screenshots,
+details and colorscheme versions for Vim, Mutt, popular terminal emulators and
+other applications.
+
+Screenshots
+-----------
+
+
+
+Downloads
+---------
+
+If you have come across this colorscheme via the [Emacs-only repository] on
+github, see the link above to the Solarized homepage or visit the main [Solarized repository].
+
+The [Emacs-only repository] is kept in sync with the main [Solarized repository]. Issues, bug reports, changelogs that are not specific to the Emacs implementation should be submitted to the main [Solarized repository].
+
+[Solarized homepage]: http://ethanschoonover.com/solarized
+[Solarized repository]: https://github.com/altercation/solarized
+[Emacs-only repository]: https://github.com/sellout/emacs-color-theme-solarized
+[color-theme]: http://www.nongnu.org/color-theme
+
+Installation & Usage
+--------------------
+
+### Emacs 24
+
+1. Add the `emacs-color-theme-solarized` directory to your Emacs `custom-theme-load-path`.
+2. Add `(load-theme solarized-[light|dark] t)` to your Emacs init file.
+3. Reload the init file, or restart Emacs.
+
+### [color-theme] \(pre-Emacs 24\)
+
+1. Download and install [color-theme].
+2. Add the `emacs-color-theme-solarized` directory to your Emacs `load-path`.
+3. Add `(require 'color-theme-solarized)` to your Emacs init file (usually `~/.emacs`).
+3. Reload the init file, or restart Emacs.
+4. Use the usual [color-theme] mechanism to select one of the Solarized themes, or `M-x color-theme-solarized-[light|dark]`.
+
+### IMPORTANT NOTE FOR TERMINAL USERS:
+
+If you are going to use Solarized in Terminal mode (i.e. not in a GUI version
+like Cocoa or X11 Emacs), **please please please** consider setting your
+terminal emulator's colorscheme to use the Solarized palette. The [Solarized
+repository] includes palettes for some popular terminal emulator as well as
+Xdefaults; or you can download them from the official [Solarized homepage].
+If you use this emacs color theme *without* having changed your emulator's
+palette, you will need to configure Solarized to degrade its colorscheme to
+a set compatible with the terminal's default limited 256 color palette
+(whereas by using the terminal's 16 ANSI color values, you would
+see the correct, specific values for the Solarized palette).
+
+If you do use the custom terminal colors, i.e. the 16 overridden ANSI color
+values, the emacs colorscheme 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 customize the `solarized-termcolor` variable to
+`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.
+
+Advanced Configuration
+----------------------
+
+Solarized will work out of the box with just the instructions specified above
+but does include several variables that can be customized.
+
+ variable name default optional
+ --------------------------------------------
+ solarized-termcolors = 16 | 256
+ solarized-degrade = nil | t
+ solarized-bold = t | nil
+ solarized-underline = t | nil
+ solarized-italic = t | nil
+ solarized-contrast = normal| high, low
+ solarized-visibility = normal| high, low
+ solarized-broken-srgb= nil | t (see details for Mac behavior)
+ --------------------------------------------
+
+### Option Details
+
+* solarized-termcolors
+
+ This is set to *16* by default, meaning that Solarized will attempt to use
+ the standard 16 colors of your terminal emulator, assuming that you've set
+ these colors to the correct Solarized values either manually or by
+ importing one of the many colorscheme available for popular terminal
+ emulators and Xdefaults.
+ If you don't want to use the Solarized colors via the terminal
+ emulator's palette, you can set this to *256*, which will use a degraded
+ version of the Solarized palette by displaying the closest colors in
+ the terminal's default 256 colors as shown in [Xterm's color
+ chart](http://en.wikipedia.org/wiki/File:Xterm_color_chart.png).
+
+* solarized-degrade
+
+ For test purposes only; in GUI mode, this forces Solarized to use the 256
+ degraded color mode to test the approximate color values for accuracy.
+
+* solarized-bold | solarized-underline | solarized-italic
+
+ If you wish to stop Solarized from displaying bold, underlined or
+ italicized typefaces, simply set the appropriate variable to `nil`.
+
+* 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.
+
+* 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. Default value is `normal` with `high` and `low` options.
+
+* solarized-broken-srgb
+
+ Emacs [bug #8402](http://debbugs.gnu.org/cgi/bugreport.cgi?bug=8402)
+ results in incorrect color handling on Macs. If this is `t` (the default
+ on Macs), Solarized works around it with alternative colors. However,
+ these colors are not totally portable, so you may be able to edit the
+ "Gen RGB" column in `solarized-definitions.el` to improve them further.
+
+Code Notes
+----------
+
+I have attempted to modularize the creation of Emacs colorschemes in this script and, while it could be refactored further, it should be a good foundation for the creation of any color scheme. By simply changing the values in the `solarized-colors` table in `solarized-definitions.el` and testing in a GUI Emacs, you can rapidly prototype new colorschemes without diving into the weeds of line-item editing each syntax highlight declaration.
+
+The Values
+----------
+
+L\*a\*b values are canonical (White D65, Reference D50), other values are
+matched in sRGB space.
+
+ SOLARIZED HEX 16/8 TERMCOL XTERM/HEX L*A*B RGB HSB
+ --------- ------- ---- ------- ----------- ---------- ----------- -----------
+ base03 #002b36 8/4 brblack 234 #1c1c1c 15 -12 -12 0 43 54 193 100 21
+ base02 #073642 0/4 black 235 #262626 20 -12 -12 7 54 66 192 90 26
+ base01 #586e75 10/7 brgreen 240 #585858 45 -07 -07 88 110 117 194 25 46
+ base00 #657b83 11/7 bryellow 241 #626262 50 -07 -07 101 123 131 195 23 51
+ base0 #839496 12/6 brblue 244 #808080 60 -06 -03 131 148 150 186 13 59
+ base1 #93a1a1 14/4 brcyan 245 #8a8a8a 65 -05 -02 147 161 161 180 9 63
+ base2 #eee8d5 7/7 white 254 #e4e4e4 92 -00 10 238 232 213 44 11 93
+ base3 #fdf6e3 15/7 brwhite 230 #ffffd7 97 00 10 253 246 227 44 10 99
+ yellow #b58900 3/3 yellow 136 #af8700 60 10 65 181 137 0 45 100 71
+ orange #cb4b16 9/3 brred 166 #d75f00 50 50 55 203 75 22 18 89 80
+ red #dc322f 1/1 red 160 #d70000 50 65 45 220 50 47 1 79 86
+ magenta #d33682 5/5 magenta 125 #af005f 50 65 -05 211 54 130 331 74 83
+ violet #6c71c4 13/5 brmagenta 61 #5f5faf 50 15 -45 108 113 196 237 45 77
+ blue #268bd2 4/4 blue 33 #0087ff 55 -10 -45 38 139 210 205 82 82
+ cyan #2aa198 6/6 cyan 37 #00afaf 60 -35 -05 42 161 152 175 74 63
+ green #859900 2/2 green 64 #5f8700 60 -20 65 133 153 0 68 100 60
+