@@ -72,6 +72,10 @@ a category nor a value axis.
    :members:
    :member-order: bysource
 
+.. autoclass:: pptx.chart.axis.AxisTitle()
+   :members:
+   :member-order: bysource
+
 
 Value Axes
 ~~~~~~~~~~
@@ -227,10 +231,11 @@ The following properties are available on series objects of all types.
 |BarSeries| objects
 ~~~~~~~~~~~~~~~~~~~
 
-These properties are only available on series belonging to a bar-type plot.
+These properties are available on a series belonging to a bar-type plot.
 
 .. autoclass:: pptx.chart.series.BarSeries()
    :exclude-members: get_or_add_ln, ln
+   :inherited-members:
    :members:
    :member-order: bysource
    :undoc-members:
@@ -239,9 +244,10 @@ These properties are only available on series belonging to a bar-type plot.
 |LineSeries| objects
 ~~~~~~~~~~~~~~~~~~~~
 
-These properties are only available on series belonging to a line-type plot.
+These properties are available on a series belonging to a line-type plot.
 
 .. autoclass:: pptx.chart.series.LineSeries()
+   :inherited-members:
    :members:
    :member-order: bysource
    :undoc-members:
@@ -266,6 +272,11 @@ An XY or bubble chart has a :attr:`points` attribute providing access to a
 sequence of |Point| objects. That sequence supports iteration, indexed
 access, and ``len()``.
 
+.. autoclass:: pptx.chart.point.CategoryPoints()
+   :members:
+   :member-order: bysource
+   :undoc-members:
+
 .. autoclass:: pptx.chart.point.BubblePoints()
    :members:
    :member-order: bysource
 
@@ -11,7 +11,7 @@ The |Slides| object is accessed using the
 is not intended to be constructed directly.
 
 .. autoclass:: pptx.slide.Slides()
-   :members: add_slide
+   :members:
    :member-order: bysource
    :undoc-members:
 
 
@@ -131,6 +131,8 @@ def _warn_node(self, msg, node):
 
 .. |CategoryLevel| replace:: :class:`.CategoryLevel`
 
+.. |CategoryPoints| replace:: :class:`.CategoryPoints`
+
 .. |_Cell| replace:: :class:`_Cell`
 
 .. |Chart| replace:: :class:`.Chart`
 
@@ -20,6 +20,7 @@ positioned one inch from the top-left corner of the slide::
 
     from pptx.enum.shapes import MSO_SHAPE
 
+    shapes = slide.shapes
     left = top = width = height = Inches(1.0)
     shape = shapes.add_shape(
         MSO_SHAPE.ROUNDED_RECTANGLE, left, top, width, height
 
@@ -7,6 +7,7 @@
 from __future__ import absolute_import, print_function, unicode_literals
 
 from collections import Sequence
+from warnings import warn
 
 from ..dml.chtfmt import ChartFormat
 from ..dml.fill import FillFormat
@@ -110,10 +111,17 @@ class BarSeries(_BaseCategorySeries):
     """
     @lazyproperty
     def fill(self):
+        """**DEPRECATED**. Use `.format.fill` instead.
+
+        Return the |FillFormat| object providing access to fill properties
+        such as fill color.
         """
-        |FillFormat| instance for this series, providing access to fill
-        properties such as fill color.
-        """
+        msg = (
+            'BarSeries.fill property is deprecated and will be removed in a '
+            'future release.'
+        )
+        warn(msg, UserWarning, stacklevel=2)
+
         spPr = self._element.get_or_add_spPr()
         return FillFormat.from_fill_parent(spPr)
 
@@ -150,10 +158,17 @@ def invert_if_negative(self, value):
 
     @lazyproperty
     def line(self):
+        """**DEPRECATED**. Use `.format.line` instead.
+
+        Return the |LineFormat| object providing access to line properties
+        such as line color and width.
         """
-        |LineFormat| instance for this shape, providing access to line
-        properties such as line color and width.
-        """
+        msg = (
+            'BarSeries.line property is deprecated and will be removed in a '
+            'future release.'
+        )
+        warn(msg, UserWarning, stacklevel=2)
+
         return LineFormat(self)
 
     @property
 
@@ -9,6 +9,7 @@
 from copy import deepcopy
 from xml.sax.saxutils import escape
 
+from ..compat import to_unicode
 from ..enum.chart import XL_CHART_TYPE
 from ..oxml import parse_xml
 from ..oxml.ns import nsdecls
@@ -1498,7 +1499,7 @@ def _cat_pt_xml(self):
                 '                </c:pt>\n'
             ).format(**{
                 'cat_idx':   idx,
-                'cat_label': escape(str(category.label)),
+                'cat_label': escape(to_unicode(category.label)),
             })
         return xml
 
 
@@ -58,6 +58,10 @@ def _intro_text(self):
             cls_docstring = self._clsdict['__doc__']
         except KeyError:
             cls_docstring = ''
+
+        if cls_docstring is None:
+            return ''
+
         return textwrap.dedent(cls_docstring).strip()
 
     def _member_def(self, member):
 
@@ -4,7 +4,11 @@
 Base shape-related objects such as BaseShape.
 """
 
-from __future__ import absolute_import, print_function
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
+
+from warnings import warn
 
 from ..action import ActionSetting
 from ..shared import ElementProxy
@@ -83,11 +87,14 @@ def height(self, value):
 
     @property
     def id(self):
-        """
-        Read-only positive integer identifying this shape. The id of a shape
-        is unique among all shapes on a slide.
-        """
-        return self._element.shape_id
+        """**DEPRECATED**. Use `.shape_id` instead."""
+        msg = (
+            'BaseShape.shape_id property is deprecated and will be removed i'
+            'n a future release.'
+        )
+        warn(msg, UserWarning, stacklevel=2)
+
+        return self.shape_id
 
     @property
     def is_placeholder(self):
@@ -152,6 +159,14 @@ def rotation(self):
     def rotation(self, value):
         self._element.rot = value
 
+    @property
+    def shape_id(self):
+        """Read-only positive integer identifying this shape.
+
+        The id of a shape is unique among all shapes on a slide.
+        """
+        return self._element.shape_id
+
     @property
     def shape_type(self):
         """
 
@@ -71,7 +71,7 @@ def fit_text(self, font_family='Calibri', max_size=18, bold=False,
         than *max_size* points. If the path to a matching TrueType font is
         provided as *font_file*, that font file will be used for the font
         metrics. If *font_file* is |None|, best efforts are made to locate
-        a font file with mathching *font_family*, *bold*, and *italic*
+        a font file with matchhing *font_family*, *bold*, and *italic*
         installed on the current system (usually succeeds if the font is
         installed).
         """