Renamed the cdata_list_attributes argument to multi_valued_attributes since it's facing the end-user and that's a more easily understandable name.

1 files changed, 21 insertions, 2 deletions

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 61c4bb9..8376549 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -428,8 +428,15 @@ consolidated::
  print(rel_soup.p)
  # <p>Back to the <a rel="index contents">homepage</a></p>
 
-You can use ```get_attribute_list`` to get a value that's always a list,
-string, whether or not it's a multi-valued atribute
+ You can disable this by passing ``multi_valued_attributes=None`` as a
+keyword argument into the ``BeautifulSoup`` constructor::
+
+  no_list_soup = BeautifulSoup('<p class="body strikeout"></p>', 'html', multi_valued_attributes=None)
+  no_list_soup.p['class']
+  # u'body strikeout'
+
+You can use ```get_attribute_list`` to get a value that's always a
+list, whether or not it's a multi-valued atribute::
 
   id_soup.p.get_attribute_list('id')
   # ["my id"]
@@ -440,8 +447,20 @@ If you parse a document as XML, there are no multi-valued attributes::
  xml_soup.p['class']
  # u'body strikeout'
 
+Again, you can configure this using the ``multi_valued_attributes`` argument::
+
+  class_is_multi= { '*' : 'class'}
+  xml_soup = BeautifulSoup('<p class="body strikeout"></p>', 'xml', multi_valued_attributes=class_is_multi)
+  xml_soup.p['class']
+  # [u'body', u'strikeout']
 
+You probably won't need to do this, but if you do, use the defaults as
+a guide. They implement the rules described in the HTML specification::
 
+  from bs4.builder import builder_registry
+  builder_registry.lookup('html').DEFAULT_CDATA_LIST_ATTRIBUTES
+
+  
 ``NavigableString``
 -------------------