v0.5.0, update docs

Author: derek73

docs/release_log.rst

@@ -1,5 +1,7 @@
 Release Log
 ===========
+* 0.5.0 - August 4, 2016
+    - Refactor join_on_conjunctions(), fix #53
 * 0.4.1 - July 25, 2016
     - Remove "bishop" from titles because it also could be a first name
     - Fix handling of lastname prefixes with periods, e.g. "Jane St. John" (#50)

nameparser/__init__.py

@@ -1,4 +1,4 @@
-VERSION = (0, 4, 1)
+VERSION = (0, 5, 0)
 __version__ = '.'.join(map(str, VERSION))
 __author__ = "Derek Gulbranson"
 __author_email__ = '[email protected]'

nameparser/parser.py

@@ -580,16 +580,18 @@ def parse_pieces(self, parts, additional_parts_count=0):
 
     def join_on_conjunctions(self, pieces, additional_parts_count=0):
         """
-        Join conjunctions to surrounding pieces, e.g.:
+        Join conjunctions to surrounding pieces. Title- and prefix-aware. e.g.:
             
-            ['Mr.', 'and'. 'Mrs.', 'John', 'Doe'] 
-                         v 
-            ['Mr. and Mrs.', 'John', 'Doe']
+            ['Mr.', 'and'. 'Mrs.', 'John', 'Doe'] ==>
+                            ['Mr. and Mrs.', 'John', 'Doe']
             
-            
-            ['The', 'Secretary', 'of', 'State', 'Hillary', 'Clinton']
-                         v
-            ['The Secretary of State', 'Hillary', 'Clinton']
+            ['The', 'Secretary', 'of', 'State', 'Hillary', 'Clinton'] ==>
+                            ['The Secretary of State', 'Hillary', 'Clinton']
+        
+        When joining titles, saves newly formed piece to the instance's titles
+        constant so they will be parsed correctly later. E.g. after parsing the
+        example names above, 'The Secretary of State' and 'Mr. and Mrs.' would
+        be present in the titles constant set.
         
         :param list pieces: name pieces strings after split on spaces
         :param int additional_parts_count: