DOC: sync CFS function descriptions with PGPROEE9_6 state

Author: Liudmila Mantrova

doc/src/sgml/func.sgml

@@ -20405,7 +20405,6 @@ SELECT (pg_stat_file('filename')).modification;
    </para>
 
   </sect2>
-
   <sect2 id="functions-compression-control">
    <title>Compression Control Functions</title>
 
@@ -20462,87 +20461,89 @@ SELECT (pg_stat_file('filename')).modification;
         <literal><function>cfs_start_gc(n_workers integer)</function></literal>
         </entry>
        <entry><type>integer</type></entry>
-       <entry>Manually initiate GC using specified number of workers (only if background GC is disabled).
+       <entry>Starts garbage collection using the specified number of workers.
+       You can only run this function to start the garbage collection manually
+       if background garbage collection is disabled.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_enable_gc(enabled boolean)</function></literal>
         </entry>
        <entry><type>boolean</type></entry>
-       <entry>Enable or disable background GC (also can be done using <xref linkend="guc-cfs-gc"> configuation variable).
+       <entry>Enables/disables background garbage collection. Alternatively, you can use the <xref linkend="guc-cfs-gc"> configuration variable.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_gc_relation(rel regclass)</function></literal>
         </entry>
        <entry><type>integer</type></entry>
-       <entry>Perform garbage collection of particular table. Returns number of processed segments.
+       <entry>Performs garbage collection for a particular table. This function returns the number of processed segments.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_version()</function></literal>
         </entry>
        <entry><type>text</type></entry>
-       <entry>CFS version and used compression algorithm.
+       <entry>Displays the CFS version and the specific compression algorithm used.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_estimate(rel regclass)</function></literal>
         </entry>
        <entry><type>float8</type></entry>
-       <entry>Estimate effect of table compression. Returns average compress ratio for first ten blocks of the relation.
+       <entry>Estimates the effect of table compression. Returns the average compression ratio for the first ten blocks of the relation.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_compression_ratio(rel regclass)</function></literal>
         </entry>
        <entry><type>float8</type></entry>
-       <entry>Returns real compression ration for all segments of the compressed relation.
+       <entry>Returns the actual compression ratio for all segments of the compressed relation.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_fragmentation(rel regclass)</function></literal>
         </entry>
        <entry><type>float8</type></entry>
-       <entry>Returns average fragmentation of the relation files.
+       <entry>Returns the average fragmentation ratio of the relation files.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_gc_activity_processed_bytes()</function></literal>
         </entry>
        <entry><type>int64</type></entry>
-       <entry>Returns total size of pages transferred by CFS during garbage collection.
+       <entry>Returns the total size of pages processed by CFS during garbage collection.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_gc_activity_processed_pages()</function></literal>
         </entry>
        <entry><type>int64</type></entry>
-       <entry>Returns number of pages transferred by CFS during garbage collection.
+       <entry>Returns the number of pages processed by CFS during garbage collection.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_gc_activity_processed_files()</function></literal>
         </entry>
        <entry><type>int64</type></entry>
-       <entry>Returns number of files compacted by CFS during garbage collection.
+       <entry>Returns the number of files compacted by CFS during garbage collection.
        </entry>
       </row>
       <row>
        <entry>
         <literal><function>cfs_gc_activity_scanned_files()</function></literal>
         </entry>
        <entry><type>int64</type></entry>
-       <entry>Returns number of files scanned by CFS during garbage collection.
+       <entry>Returns the number of files scanned by CFS during garbage collection.
        </entry>
       </row>
      </tbody>