python-common: Reference it in the docs

Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>

diff --git a/doc/conf.py b/doc/conf.py
index fadb5248a86340143b29fb8854633b627f81b4b9..19e2cf45b4b5208a7b0fd63e8ddc42f96f15f4ff 100644 (file)
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -106,6 +106,7 @@ class Mock(object):
 sys.modules['ceph_module'] = Mock()
 
 for pybind in [os.path.join(top_level, 'src/pybind'),
-               os.path.join(top_level, 'src/pybind/mgr')]:
+               os.path.join(top_level, 'src/pybind/mgr'),
+               os.path.join(top_level, 'src/python-common')]:
     if pybind not in sys.path:
         sys.path.insert(0, pybind)

diff --git a/doc/mgr/orchestrator_cli.rst b/doc/mgr/orchestrator_cli.rst
index 38684229b1155f7b8e1f69316d5943741e9edc40..5138de05bb9e586b35efb81567d6ec98943c5662 100644 (file)
--- a/doc/mgr/orchestrator_cli.rst
+++ b/doc/mgr/orchestrator_cli.rst
@@ -149,7 +149,8 @@ Create OSDs on a group of devices on a single host::
 
 The output of ``osd create`` is not specified and may vary between orchestrator backends.
 
-Where ``drive.group.json`` is a JSON file containing the fields defined in :class:`orchestrator.DriveGroupSpec`
+Where ``drive.group.json`` is a JSON file containing the fields defined in
+:class:`ceph.deployment_utils.drive_group.DriveGroupSpec`
 
 Example::
 

diff --git a/doc/mgr/orchestrator_modules.rst b/doc/mgr/orchestrator_modules.rst
index 6e6005718f530f96ce073547e5a96b64f4e5b673..77338660946489ee5c2056076eeb428b99d2d4a4 100644 (file)
--- a/doc/mgr/orchestrator_modules.rst
+++ b/doc/mgr/orchestrator_modules.rst
@@ -250,6 +250,8 @@ OSD management
 .. automethod:: Orchestrator.replace_osds
 .. automethod:: Orchestrator.remove_osds
 
+.. py:currentmodule:: ceph.deployment.drive_group
+
 .. autoclass:: DeviceSelection
    :members:
 
@@ -257,6 +259,8 @@ OSD management
    :members:
    :exclude-members: from_json
 
+.. py:currentmodule:: orchestrator
+
 Stateless Services
 ------------------
 

diff --git a/src/python-common/ceph/deployment/drive_group.py b/src/python-common/ceph/deployment/drive_group.py
index 74e005a51736ac1822a4e805de9d02a06cfd0a3d..b77add828448e77c1a28b956263e2fb9aee3ba56 100644 (file)
--- a/src/python-common/ceph/deployment/drive_group.py
+++ b/src/python-common/ceph/deployment/drive_group.py
@@ -55,11 +55,6 @@ class DeviceSelection(object):
 
 
 class DriveGroupValidationError(Exception):
-    """
-    Defining an exception here is a bit problematic, cause you cannot properly catch it,
-    if it was raised in a different mgr module.
-    """
-
     def __init__(self, msg):
         super(DriveGroupValidationError, self).__init__('Failed to validate Drive Group: ' + msg)