doc/glossary: define "OSD"

Define "OSD" as "Object Storage Device", distinct from
"object storage daemon".

Signed-off-by: Zac Dover <zac.dover@gmail.com>

diff --git a/doc/glossary.rst b/doc/glossary.rst
index ebcdd70a656e53bf13317a923e90d61de9452bb0..4dc55aa28d1f5d8f95e64d59809c898c6bc42c94 100644 (file)
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -168,11 +168,16 @@
 
        Node
        Object Storage Device
+                See :term:`OSD`.
+
        OSD
-               A physical or logical storage unit (for example: LUN).
-               Sometimes, Ceph users use the
-               term "OSD" to refer to :term:`Ceph OSD Daemon`, though the
-               proper term is "Ceph OSD".
+                **O**\bject **S**\torage **D**\evice. A physical or logical
+                storage unit (for example: LUN). Ceph users sometimes use the
+                term "OSD" to refer to :term:`Ceph OSD Daemon`, but this is
+                incorrect. The proper expansion of "Ceph OSD" is "object
+                storage device". In contrast, :term:`Ceph OSD Daemon` refers to
+                :ref:`\``ceph-osd``<ceph_osd-daemon>`, not to "**O**\bject
+                **S**\torage **D**\evice".
 
        OSD fsid
                 This is a unique identifier used to further improve the

diff --git a/doc/man/8/ceph-osd.rst b/doc/man/8/ceph-osd.rst
index 2536a7721e7132a4a33b409ad4169f65457731bd..5b631eeff744b3931196e7c45b40eb07a5ff5d65 100644 (file)
--- a/doc/man/8/ceph-osd.rst
+++ b/doc/man/8/ceph-osd.rst
@@ -1,5 +1,7 @@
 :orphan:
 
+.. _ceph_osd-daemon:
+
 ========================================
  ceph-osd -- ceph object storage daemon
 ========================================