[Emacs-diffs] emacs-26 b657286: Add documentation for tabulated-list functions in the elisp manual

[Alex Branham]

branch: emacs-26
commit b657286a8c760904747c7b62bcc1f1794969ba84
Author: Alex Branham <address@hidden>
Commit: Alex Branham <address@hidden>

    Add documentation for tabulated-list functions in the elisp manual
    
    * doc/lispref/modes.texi: Add documentation for
      'tabulated-list-delete-entry', 'tabulated-list-get-id',
      'tabulated-list-get-entry', 'tabulated-list-header-overlay-p',
      'tabulated-list-put-tag', and 'tabulated-list-set-col'.
    
    Bug#21074
---
 doc/lispref/modes.texi | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 9df1a69..26cb028 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1101,6 +1101,65 @@ that tags placed via @code{tabulated-list-put-tag} will 
not be removed
 from entries that haven't changed (normally all tags are removed).
 @end defun
 
address@hidden tabulated-list-delete-entry
+This function deletes the entry at point.
+
+It returns a list @code{(@var{id} @var{cols})}, where @var{id} is the
+ID of the deleted entry and @var{cols} is a vector of its column
+descriptors.  It moves point to the beginning of the current line.  It
+returns @code{nil} if there is no entry at point.
+
+Note that this function only changes the buffer contents; it does not
+alter @code{tabulated-list-entries}.
address@hidden defun
+
address@hidden tabulated-list-get-id &optional pos
+This @code{defsubst} returns the ID object from
address@hidden (if that is a list) or from the list
+returned by @code{tabulated-list-entries} (if it is a function).  If
+omitted or @code{nil}, @var{pos} defaults to point.
address@hidden defun
+
address@hidden tabulated-list-get-entry &optional pos
+This @code{defsubst} returns the entry object from
address@hidden (if that is a list) or from the list
+returned by @code{tabulated-list-entries} (if it is a function).  This
+will be a vector for the ID at @var{pos}.  If there is no entry at
address@hidden, then the function returns @code{nil}.
address@hidden defun
+
address@hidden tabulated-list-use-header-line
address@hidden tabulated-list-header-overlay-p &optional POS
+This @code{defsubst} returns non-nil if there is a fake header at
address@hidden  A fake header is used if
address@hidden is @code{nil} to put the column
+names at the beginning of the buffer.  If omitted or @code{nil},
address@hidden defaults to @code{point-min}.
address@hidden defun
+
address@hidden tabulated-list-padding
address@hidden tabulated-list-put-tag tag &optional advance
+This function puts @var{tag} in the padding area of the current line.
+The padding area can be empty space at the beginning of the line, the
+width of which is governed by @code{tabulated-list-padding}.
address@hidden should be a string, with a length less than or equal to
address@hidden  If @var{advance} is non-nil, this
+function advances point by one line.
address@hidden defun
+
address@hidden tabulated-list-set-col col desc &optional change-entry-data
+This function changes the tabulated list entry at point, setting
address@hidden to @var{desc}.  @var{col} is the column number to change, or
+the name of the column to change.  @var{desc} is the new column
+descriptor, which is inserted via @code{tabulated-list-print-col}.
+
+If @var{change-entry-data} is non-nil, this function modifies the
+underlying data (usually the column descriptor in the list
address@hidden) by setting the column descriptor of the
+vector to @code{desc}.
address@hidden defun
+
+
 @node Generic Modes
 @subsection Generic Modes
 @cindex generic mode