docs: adjust API docs to reflect relocations

Steve Canny · Steve Canny · commit 026009d6838f · 2015-02-15T18:24:15.000-08:00
diff --git a/docs/api/document.rst b/docs/api/document.rst
@@ -7,27 +7,18 @@ Document objects
 The main Document and related objects.
 
 
-.. currentmodule:: docx.api
+|Document| constructor
+----------------------
 
+.. autofunction:: docx.Document
 
-|Document| objects
-------------------
-
-
-.. autoclass:: Document
-   :members:
-   :exclude-members: numbering_part, styles_part
 
-
-.. currentmodule:: docx.parts.document
-
-
-|Sections| objects
+|Document| objects
 ------------------
 
-
-.. autoclass:: Sections
+.. autoclass:: docx.document.Document()
    :members:
+   :exclude-members: styles_part
 
 
 |CoreProperties| objects
diff --git a/docs/api/section.rst b/docs/api/section.rst
@@ -1,14 +1,21 @@
 
 .. _section_api:
 
+
 Section objects
 ===============
 
 Provides access to section properties such as margins and page orientation.
 
 
+|Sections| objects
+------------------
+
 .. currentmodule:: docx.section
 
+.. autoclass:: Sections
+   :members:
+
 
 |Section| objects
 -----------------
diff --git a/docs/api/shape.rst b/docs/api/shape.rst
@@ -4,17 +4,15 @@
 Shape-related objects
 =====================
 
-.. currentmodule:: docx.parts.document
+.. currentmodule:: docx.shape
 
 
 |InlineShapes| objects
 ----------------------
 
 .. autoclass:: InlineShapes
    :members:
-
-
-.. currentmodule:: docx.shape
+   :exclude-members: add_picture
 
 
 |InlineShape| objects
diff --git a/docs/api/text.rst b/docs/api/text.rst
@@ -8,34 +8,26 @@ Text-related objects
 |Paragraph| objects
 -------------------
 
-.. currentmodule:: docx.text.paragraph
-
-.. autoclass:: Paragraph
+.. autoclass:: docx.text.paragraph.Paragraph()
    :members:
 
 
 |ParagraphFormat| objects
 -------------------------
 
-.. currentmodule:: docx.text.paragraph
-
-.. autoclass:: ParagraphFormat
+.. autoclass:: docx.text.parfmt.ParagraphFormat()
    :members:
 
 
 |Run| objects
 -------------
 
-.. currentmodule:: docx.text.run
-
-.. autoclass:: Run
+.. autoclass:: docx.text.run.Run()
    :members:
 
 
 |Font| objects
 --------------
 
-.. currentmodule:: docx.text.run
-
-.. autoclass:: Font
+.. autoclass:: docx.text.run.Font()
    :members:
diff --git a/docs/conf.py b/docs/conf.py
@@ -91,6 +91,8 @@
 
 .. |Document| replace:: :class:`.Document`
 
+.. |DocumentPart| replace:: :class:`.DocumentPart`
+
 .. |docx| replace:: ``python-docx``
 
 .. |Emu| replace:: :class:`.Emu`
diff --git a/docx/document.py b/docx/document.py
@@ -17,7 +17,8 @@
 
 class Document(ElementProxy):
     """
-    WordprocessingML (WML) document.
+    WordprocessingML (WML) document. Not intended to be constructed directly.
+    Use :func:`docx.Document` to open or create a document.
     """
 
     __slots__ = ('_part', '__body')
