From: Christopher Hoffman <choffman@redhat.com>
Date: Wed, 13 Aug 2025 16:10:12 +0000 (+0000)
Subject: doc/cephfs, qa/cephfs: Reword some documentation.
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=cfe3dab721f61088f703eb56544b4745a14b82cc;p=ceph.git

doc/cephfs, qa/cephfs: Reword some documentation.

Reword some documentation for enctag and mount.py
function descriptions.

Signed-off-by: Christopher Hoffman <choffman@redhat.com>
---

diff --git a/doc/cephfs/fs-volumes.rst b/doc/cephfs/fs-volumes.rst
index 160a656f035..e372f4b082c 100644
--- a/doc/cephfs/fs-volumes.rst
+++ b/doc/cephfs/fs-volumes.rst
@@ -380,7 +380,7 @@ file. The case of the file name used when the file was created is preserved.
 .. note:: Setting ``--casesensitive=0`` option implicitly enables
    Unicode normalization on the subvolume.
 
-A separate encryption tag is available for use with encryption. This is to be used tagging the subvolume, with
+A separate encryption tag is available for use with encryption. This is to be used tagging the subvolume with
 an identifier that is useful for system administrators or other services. By default, the tag is empty. This tag
 is not required, but can be a useful step in setting up encrypted subvolumes.
 
diff --git a/qa/tasks/cephfs/mount.py b/qa/tasks/cephfs/mount.py
index 8b599403bbd..60e8e88ce5b 100644
--- a/qa/tasks/cephfs/mount.py
+++ b/qa/tasks/cephfs/mount.py
@@ -1510,7 +1510,7 @@ class CephFSMountBase(object):
 
     def lchown(self, fs_path, uid, gid):
         """
-        Change ownership of a link with uid and gid provided.
+        Change the ownership of a link with the provided UID and GID.
         """
 
         abs_path = os.path.join(self.hostfs_mntpt, fs_path)
@@ -1528,7 +1528,7 @@ class CephFSMountBase(object):
 
     def symlink(self, fs_path, symlink_path):
         """
-        Change ownership of a link with uid and gid provided.
+        Create a symlink to the provided file/path with the provided name.
         """
 
         src_path = os.path.join(self.hostfs_mntpt, fs_path)
@@ -1547,7 +1547,7 @@ class CephFSMountBase(object):
 
     def copy_file_range(self, src, dest, length):
         """
-        Truncate a file of certain size
+        Copy a portion of data from src file to dest file.
         """
 
         src_path = os.path.join(self.hostfs_mntpt, src)
@@ -1611,7 +1611,7 @@ class CephFSMountBase(object):
 
     def touch_os(self, fs_path):
         """
-        Create a dentry if it doesn't already exist.  Use open in os module.
+        Create a dentry if it doesn't already exist. Uses the open method in the os module.
 
         :param fs_path:
         :return: