doc/cephfs: edit ceph-dokan.rst (2 of x)

Edit the last half of doc/cephfs/ceph-dokan.rst. This is part of a
larger project whose goal is the improvement of the CephFS
documentation.

Follows https://github.com/ceph/ceph/pull/64690.

Signed-off-by: Zac Dover <zac.dover@proton.me>

diff --git a/doc/cephfs/ceph-dokan.rst b/doc/cephfs/ceph-dokan.rst
index 7038010377e27434325a5bc5bf85b6874219d6b1..71557fcd7ec87604dda1810e5212f24ac288ec48 100644 (file)
--- a/doc/cephfs/ceph-dokan.rst
+++ b/doc/cephfs/ceph-dokan.rst
@@ -64,8 +64,8 @@ Run ``ceph-dokan --help`` for a full list of arguments.
 Credentials
 -----------
 
-The ``--id`` option passes the name of the CephX user whose keyring we intend to
-use for mounting CephFS. The following commands are equivalent::
+The ``--id`` option passes the name of the CephX user whose keyring 
+is used when mounting CephFS. The following commands are equivalent::
 
     ceph-dokan --id foo -l x
     ceph-dokan --name client.foo -l x
@@ -78,28 +78,26 @@ like so::
 
     ceph-dokan.exe unmap -l x
 
-Note that when unmapping Ceph filesystems, the exact same mount point argument
-must be used as when the mapping was created.
+.. note:: When unmapping Ceph filesystems, you must specify the mount point
+   argument that was used at the time of the creation of the mapping. 
 
 Limitations
 -----------
 
-Be aware that Windows ACLs are ignored. Posix ACLs are supported but cannot be
-modified using the current CLI. In the future, we may add some command actions
-to change file ownership or permissions.
+Windows ACLs are ignored. Posix ACLs are supported but cannot be modified using
+the current CLI. In the future, we may add some command actions that change
+file ownership or permissions.
 
-Another thing to note is that CephFS doesn't support mandatory file locks, which
-Windows relies heavily upon. At present Ceph lets Dokan handle file
-locks, which are only enforced locally.
+CephFS doesn't support mandatory file locks, which Windows relies heavily upon.
+Ceph relies upon Dokan to handle file locks, which are only enforced locally.
 
-Unlike ``rbd-wnbd``, ``ceph-dokan`` doesn't currently provide a ``service``
-command. In order for the cephfs mount to survive host reboots, consider using
-``NSSM``.
+Unlike ``rbd-wnbd``, ``ceph-dokan`` doesn't provide a ``service`` command.  To
+make a CephFS mount survive host reboots, use ``NSSM``.
 
 Troubleshooting
 ===============
 
-Please consult the `Windows troubleshooting`_ page.
+See the `Windows troubleshooting`_ page.
 
 .. _Windows troubleshooting: ../../install/windows-troubleshooting
 .. _installation guide: ../../install/windows-install