update release log and documentation

Author: derek73

docs/customize.rst

@@ -1,3 +1,50 @@
+Pre-processing
+=================
+
+
+Name buckets
+++++++++++++++
+
+Each attribute has a corresponding ordered list of name pieces. 
+
+* o.title_list
+* o.first_list
+* o.middle_list
+* o.last_list
+* o.suffix_list
+* o.nickname_list
+
+If you're doing pre- or post-processing you may wish to manipulate these lists directly. 
+The strings returned by the attribute names just join these lists with spaces.
+
+::
+
+  >>> hn = HumanName("Juan Q. Xavier Velasquez y Garcia, Jr.")
+  >>> hn.middle_list
+  [u'Q.', u'Xavier']
+  >>> hn.middle_list += ["Ricardo"]
+  >>> hn.middle_list
+  [u'Q.', u'Xavier', 'Ricardo']
+
+
+You can also replace any name bucket's contents by assigning a string or a list
+directly to the attribute.
+
+::
+
+  >>> hn = HumanName("Dr. John A. Kenneth Doe")
+  >>> hn.title = ["Associate","Professor"]
+  >>> hn.suffix = "Md."
+  <HumanName : [
+  	title: 'Associate Processor' 
+  	first: 'John' 
+  	middle: 'A. Kenneth' 
+  	last: 'Doe' 
+  	suffix: 'Md.'
+  	nickname: ''
+  ]>
+
+
 Customizing the Parser with Your Own Configuration
 ==================================================
 

docs/release_log.rst

@@ -1,7 +1,10 @@
 Release Log
 ===========
 
-* 0.3.5 - August, 2015
+* 0.3.6 - August 6, 2015
+    - Fix strings that start with conjunctions (#20)
+    - handle assigning lists of names to a name attribute
+* 0.3.5 - August 4, 2015
     - Fix handling of string encoding in python 2.x (#34)
     - Add support for dictionary key access, e.g. name['first']
     - add 'santa' to prefixes, add 'cpa', 'csm', 'phr', 'pmp' to suffixes (#35)

docs/usage.rst

@@ -43,6 +43,9 @@ Example
         suffix: 'Jr.'
         nickname: ''
     ]>
+    >>> name.suffix = ["custom","values"]
+    >>> name.suffix
+    u'custom values'
     >>> name.full_name = 'Doe-Ray, Jonathan "John" A. Harris'
     >>> name.as_dict()
     {u'last': u'Doe-Ray', u'suffix': u'', u'title': u'', u'middle': u'A. Harris', u'nickname': u'John', u'first': u'Jonathan'}

nameparser/config/regexes.py

@@ -9,6 +9,7 @@
     ("initial", re.compile(r'^(\w\.|[A-Z])?$', re.U)),
     ("nickname", re.compile(r'\s*?[\("](.+?)[\)"]', re.U)),
     ("roman_numeral", re.compile(r'^(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})$', re.I | re.U)),
+    ("no_vowels",re.compile(r'^[^aeyiuo]+$', re.I | re.U))
 ])
 """
 All regular expressions used by the parser are precompiled and stored in the config.