Add meta object to spec and themes

If `description` is present, it must be a string less than 140
characters long and should briefly describe the purpose of the object.

doc/spec.md

@@ -5,10 +5,10 @@
 <dd>Tony Crisci (dubstepdish.com)</dd>
 
 <dt>Revision</dt>
-<dd>0.0.2</dd>
+<dd>0.1.0</dd>
 
 <dt>Date</dt>
-<dd>30 October 2013</dd>
+<dd>10 April 2014</dd>
 
 <dt>Copyright</dt>
 <dd>Copyright © 2013 Tony Crisci. This work is licensed <a href="http://creativecommons.org/licenses/by-sa/3.0/us/">CC-BY-SA 3.0</a>
@@ -95,6 +95,14 @@ bar_colors:
 
 An *i3-config-builder object* is always a single object. The i3-config-builder object may optionally have any of the members described below at its root. Each of the keys for the i3-config-builder object and all their members must only consist of word characters, digits, and the underscore.
 
+### The Meta Object
+
+The *meta object* may be present at the root of the i3-config-builder object with the key `meta`. If present, its value must be an object which may contain any of the following keys:
+
+* `description`
+
+If `description` is present, it must be a string less than 140 characters long and should briefly describe the purpose of the object.
+
 ### The Colors Object
 
 The *colors object* may be present at the root of the i3-config-builder object with the key `colors`. If present, its value must be a single object with keys that each represent a *color alias*. The value of a color alias must be a single string value that expresses a valid *hex color code* in the same format as HTML hex color codes.

themes/archlinux

@@ -1,7 +1,7 @@
 # vim: filetype=yaml
-# archlinux theme for i3 by okraits
-# http://okraits.de
 ---
+meta:
+  description: 'Archlinux theme by okraits <http://okraits.de>'
 window_colors:
   focused:
     border:           '#0088CC'

themes/debian

@@ -1,6 +1,7 @@
 # vim: filetype=yaml
-# debian theme for i3wm by lasers
 ---
+meta:
+  description: 'Debian theme by lasers'
 window_colors:
   focused:
     border:           '#d70a53'

themes/default

@@ -1,7 +1,7 @@
 # vim: filetype=yaml
-# i3 default theme
-# http://i3wm.org
 ---
+meta:
+  description: 'Default theme for i3wm <http://i3wm.org>'
 window_colors:
   focused:
     border:           '#4c7899'

themes/okraits

@@ -1,7 +1,7 @@
 # vim: filetype=yaml
-# simple i3 theme by okraits
-# http://okraits.de
 ---
+meta:
+  description: 'A simple theme by okraits <http://okraits.de>'
 window_colors:
   focused:
     border:           '#888888'

themes/solarized

@@ -1,6 +1,7 @@
 # vim: filetype=yaml
-# solarized colorscheme by lasers (no cyan version)
 ---
+meta:
+  description: 'Solarized theme by lasers'
 colors:
   base03:           '#002b36'
   base02:           '#073642'

themes/ubuntu

@@ -1,6 +1,7 @@
 # vim: filetype=yaml
-# ubuntu theme for i3wm by lasers
 ---
+meta:
+  description: 'Ubuntu theme by lasers'
 window_colors:
   focused:
     border:           '#dd4814'