From a72e0e50f0afbb8b37b9ebd8e1fa83ce3eb9f643 Mon Sep 17 00:00:00 2001
From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 19 Feb 2022 16:58:52 +0100
Subject: [PATCH] Some vtable.texi copy edits

* doc/misc/vtable.texi (Making A Table): Mention the accessors.
---
 doc/misc/vtable.texi | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/doc/misc/vtable.texi b/doc/misc/vtable.texi
index 8e6db5659d0..472dee70ec0 100644
--- a/doc/misc/vtable.texi
+++ b/doc/misc/vtable.texi
@@ -89,7 +89,7 @@ Here's just about the simplest vtable that can be created:
 @end lisp
 
 By default, vtable uses the @code{variable-pitch} font, and
-right-aligns columns that only have numerical data (and left-aligns
+right-aligns columns that have only numerical data (and left-aligns
 the rest).
 
 You'd normally want to name the columns:
@@ -102,7 +102,8 @@ You'd normally want to name the columns:
 @end lisp
 
 Clicking on the column names will sort the table based on the data in
-each object (and in this example, each object is just a simple list).
+each column (which, in this example, corresponds to an element in a
+list).
 
 By default, the data is displayed ``as is'', that is, the way
 @samp{(format "%s" ...)} would display it, but you can override that.
@@ -123,7 +124,7 @@ will still sort after @samp{45}, because sorting is done on the actual
 data, and not the displayed data.
 
 Alternatively, instead of having a general formatter for the table,
-you can instead put the formatter in the column definition:
+you can put the formatter in the column definition:
 
 @lisp
 (make-vtable
@@ -151,10 +152,10 @@ version of @kbd{M-x list-buffers}:
              ("File" (or (buffer-file-name object) "")))))
 @end lisp
 
-@var{objects} in this case is a list of buffers.  To get the data to be
-displayed, vtable calls the @dfn{getter} function, which is called for
-each column of every object, and should return something suitable for
-display.
+@var{objects} in this case is a list of buffers.  To get the data to
+be displayed, vtable calls the @dfn{getter} function, which is called
+for each column of every object, and which should return the data that
+will eventually be displayed.
 
 Also note the @dfn{actions}: These are simple commands that will be
 called with the object under point.  So hitting @kbd{@key{RET}} on a line
@@ -178,7 +179,7 @@ Finally, here's an example that uses just about all the features:
                                            :max-width max-width))))
             (:name "Size" :width 10
                    :formatter file-size-human-readable)
-            (:name "Time" :width 10 :primary ascend :direction 'descend)
+            (:name "Time" :width 10 :primary ascend)
             "Name")
  :objects-function (lambda ()
                      (directory-files "/tmp/" t "\\.jpg\\'"))
-- 
2.39.5