Fix linter errors: add necessary highlight groups or fix docstrings

Fixes #1136

powerline/config_files/colorschemes/default.json

@@ -1,13 +1,19 @@
 {
 	"name": "Default",
 	"groups": {
+		"information:additional":    { "fg": "gray9", "bg": "gray4", "attrs": [] },
+		"information:regular":       { "fg": "gray10", "bg": "gray4", "attrs": ["bold"] },
+		"information:highlighted":   { "fg": "white", "bg": "gray4", "attrs": [] },
+		"information:priority":      { "fg": "brightyellow", "bg": "mediumorange", "attrs": [] },
+		"critical:failure":          { "fg": "white", "bg": "darkestred", "attrs": [] },
+		"critical:success":          { "fg": "white", "bg": "darkestgreen", "attrs": [] },
 		"background":                { "fg": "white", "bg": "gray0", "attrs": [] },
 		"background:divider":        { "fg": "gray5", "bg": "gray0", "attrs": [] },
 		"session":                   { "fg": "black", "bg": "gray10", "attrs": ["bold"] },
 		"date":                      { "fg": "gray8", "bg": "gray2", "attrs": [] },
 		"time":                      { "fg": "gray10", "bg": "gray2", "attrs": ["bold"] },
 		"time:divider":              { "fg": "gray5", "bg": "gray2", "attrs": [] },
-		"email_alert":               { "fg": "white", "bg": "brightred", "attrs": ["bold"] },
+		"email_alert":               "warning:regular",
 		"email_alert_gradient":      { "fg": "white", "bg": "yellow_orange_red", "attrs": ["bold"] },
 		"hostname":                  { "fg": "black", "bg": "gray10", "attrs": ["bold"] },
 		"weather":                   { "fg": "gray8", "bg": "gray0", "attrs": [] },
@@ -31,13 +37,12 @@
 		"battery_empty":             { "fg": "white", "bg": "gray0", "attrs": [] },
 		"player":                    { "fg": "gray10", "bg": "black", "attrs": [] },
 		"user":                      { "fg": "white", "bg": "darkblue", "attrs": ["bold"] },
-		"superuser":                 { "fg": "white", "bg": "brightred", "attrs": ["bold"] },
 		"branch":                    { "fg": "gray9", "bg": "gray2", "attrs": [] },
 		"branch_dirty":              { "fg": "brightyellow", "bg": "gray2", "attrs": [] },
 		"branch_clean":              { "fg": "gray9", "bg": "gray2", "attrs": [] },
 		"branch:divider":            { "fg": "gray7", "bg": "gray2", "attrs": [] },
-		"cwd":                       { "fg": "gray9", "bg": "gray4", "attrs": [] },
-		"cwd:current_folder":        { "fg": "gray10", "bg": "gray4", "attrs": ["bold"] },
+		"cwd":                       "information:additional",
+		"cwd:current_folder":        "information:regular",
 		"cwd:divider":               { "fg": "gray7", "bg": "gray4", "attrs": [] },
 		"virtualenv":                { "fg": "white", "bg": "darkcyan", "attrs": [] },
 		"attached_clients":          { "fg": "gray8", "bg": "gray0", "attrs": [] }

powerline/config_files/colorschemes/ipython/__main__.json

@@ -0,0 +1,6 @@
+{
+	"groups": {
+		"prompt":       "information:additional",
+		"prompt_count": "information:highlighted"
+	}
+}

powerline/config_files/colorschemes/ipython/default.json

@@ -1,7 +0,0 @@
-{
-	"name": "Default color scheme for IPython prompt",
-	"groups": {
-		"prompt":         { "fg": "gray9", "bg": "gray4", "attrs": [] },
-		"prompt_count":   { "fg": "white", "bg": "gray4", "attrs": [] }
-	}
-}

powerline/config_files/colorschemes/shell/__main__.json

@@ -1,6 +1,10 @@
 {
 	"groups": {
 		"continuation":         "cwd",
-		"continuation:current": "cwd:current_folder"
+		"continuation:current": "cwd:current_folder",
+		"exit_fail":            "critical:failure",
+		"exit_success":         "critical:success",
+		"jobnum":               "information:priority",
+		"superuser":            "warning:regular"
 	}
 }

powerline/config_files/colorschemes/shell/default.json

@@ -2,9 +2,6 @@
 	"name": "Default color scheme for shell prompts",
 	"groups": {
 		"hostname":         { "fg": "brightyellow", "bg": "mediumorange", "attrs": [] },
-		"jobnum":           { "fg": "brightyellow", "bg": "mediumorange", "attrs": [] },
-		"exit_fail":        { "fg": "white", "bg": "darkestred", "attrs": [] },
-		"exit_success":     { "fg": "white", "bg": "darkestgreen", "attrs": [] },
 		"environment":      { "fg": "white", "bg": "darkestgreen", "attrs": [] },
 		"mode":             { "fg": "darkestgreen", "bg": "brightgreen", "attrs": ["bold"] },
 		"attached_clients": { "fg": "white", "bg": "darkestgreen", "attrs": [] }

powerline/config_files/colorschemes/shell/solarized.json

@@ -1,10 +1,7 @@
 {
 	"name": "Solarized dark for shell",
 	"groups": {
-		"jobnum":             { "fg": "solarized:base3", "bg": "solarized:base01", "attrs": [] },
-		"exit_fail":          { "fg": "solarized:base3", "bg": "solarized:red", "attrs": [] },
-		"exit_success":       { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
-		"mode":               { "fg": "solarized:base3", "bg": "solarized:green", "attrs": ["bold"] }
+		"mode": { "fg": "solarized:base3", "bg": "solarized:green", "attrs": ["bold"] }
 	},
 	"mode_translations": {
 		"vicmd": {

powerline/config_files/colorschemes/solarized.json

@@ -1,18 +1,34 @@
 {
 	"name": "Solarized dark",
 	"groups": {
-		"background":         { "fg": "solarized:base3", "bg": "solarized:base02", "attrs": [] },
-		"user":               { "fg": "solarized:base3", "bg": "solarized:blue", "attrs": ["bold"] },
-		"superuser":          { "fg": "solarized:base3", "bg": "solarized:red", "attrs": ["bold"] },
-		"virtualenv":         { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
-		"branch":             { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
-		"branch_dirty":       { "fg": "solarized:yellow", "bg": "solarized:base02", "attrs": [] },
-		"branch_clean":       { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
-		"cwd":                { "fg": "solarized:base2", "bg": "solarized:base01", "attrs": [] },
-		"cwd:current_folder": { "fg": "solarized:base3", "bg": "solarized:base01", "attrs": ["bold"] },
-		"cwd:divider":        { "fg": "solarized:base1", "bg": "solarized:base01", "attrs": [] },
-		"hostname":           { "fg": "solarized:base3", "bg": "solarized:base01", "attrs": [] },
-		"environment":        { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
-		"attached_clients":   { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] }
+		"information:additional":  { "fg": "solarized:base2", "bg": "solarized:base01", "attrs": [] },
+		"information:regular":     { "fg": "solarized:base3", "bg": "solarized:base01", "attrs": ["bold"] },
+		"information:highlighted": { "fg": "solarized:base3", "bg": "solarized:base01", "attrs": ["bold"]},
+		"information:priority":    { "fg": "solarized:base3", "bg": "solarized:yellow", "attrs": [] },
+		"warning:regular":         { "fg": "solarized:base3", "bg": "solarized:red", "attrs": [] },
+		"critical:failure":        { "fg": "solarized:base3", "bg": "solarized:red", "attrs": [] },
+		"critical:success":        { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
+		"background":              { "fg": "solarized:base3", "bg": "solarized:base02", "attrs": [] },
+		"background:divider":      { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
+		"user":                    { "fg": "solarized:base3", "bg": "solarized:blue", "attrs": ["bold"] },
+		"virtualenv":              { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
+		"branch":                  { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
+		"branch_dirty":            { "fg": "solarized:yellow", "bg": "solarized:base02", "attrs": [] },
+		"branch_clean":            { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
+		"email_alert_gradient":    { "fg": "solarized:base3", "bg": "yellow_orange_red", "attrs": [] },
+		"email_alert":             "warning:regular",
+		"cwd":                     "information:additional",
+		"cwd:current_folder":      "information:regular",
+		"cwd:divider":             { "fg": "solarized:base1", "bg": "solarized:base01", "attrs": [] },
+		"hostname":                { "fg": "solarized:base3", "bg": "solarized:base01", "attrs": [] },
+		"environment":             { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
+		"attached_clients":        { "fg": "solarized:base3", "bg": "solarized:green", "attrs": [] },
+		"date":                    { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
+		"time":                    { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": ["bold"] },
+		"time:divider":            { "fg": "solarized:base1", "bg": "solarized:base02", "attrs": [] },
+		"system_load":             { "fg": "solarized:base1", "bg": "solarized:base03", "attrs": [] },
+		"weather_temp_gradient":   { "fg": "blue_red", "bg": "solarized:base03", "attrs": [] },
+		"weather":                 { "fg": "solarized:base1", "bg": "solarized:base03", "attrs": [] },
+		"uptime":                  { "fg": "solarized:base1", "bg": "solarized:base03", "attrs": [] }
 	}
 }

powerline/segments/vim/plugin/commandt.py

@@ -50,6 +50,8 @@ def finder(pl):
 	$command_t to add them). All Command-T finders have ``CommandT::`` module 
 	prefix, but it is stripped out (actually, any ``CommandT::`` substring will 
 	be stripped out).
+
+	Highlight groups used: ``commandt:finder``.
 	'''
 	initialize()
 	vim.command('ruby $powerline.commandt_set_active_finder')
@@ -80,6 +82,8 @@ def path(pl):
 	$command_t.active_finder is required in order to omit displaying path for 
 	finders ``MRUBufferFinder``, ``BufferFinder``, ``TagFinder`` and 
 	``JumpFinder`` (pretty much any finder, except ``FileFinder``).
+
+	Highlight groups used: ``commandt:path``.
 	'''
 	initialize()
 	vim.command('ruby $powerline.commandt_set_active_finder')