* doc/lispref/modes.texi (Basic Major Modes): Mention tabulated-list-mode.

* etc/NEWS: Related markup.

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 0546ec9e93628733a7f9f2099ac6dbb6e00e2a3c..a823f4272fcc4b6103812187bf5167420311cd85 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2012-02-10  Glenn Morris  <rgm@gnu.org>
+
+       * modes.texi (Basic Major Modes): Mention tabulated-list-mode.
+
 2012-02-08  Glenn Morris  <rgm@gnu.org>
 
        * loading.texi (Named Features): Update the require example.

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 052fd0371677c26fc104d602bc2eaf69d75af562..0b020bee0b0f7346669c5773071905619c7699ed 100644 (file)
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -915,6 +915,20 @@ mode, which is used by the @samp{*Buffer List*} buffer.  @xref{List
 Buffers,,Listing Existing Buffers, emacs, The GNU Emacs Manual}.
 @end deffn
 
+@cindex tables of data
+@deffn Command tabulated-list-mode
+Tabulated List mode is another mode that derives from Special mode.  It
+displays tabulated data, i.e. a series of rows and columns, where each
+row represents a particular entry, whose properties are displayed in the
+various columns.  It provides a general mechanism for sorting on
+columns.  You can use Tabulated List mode as the basis for other modes
+that need to display lists.  For example, the @samp{*Packages*} buffer
+uses this (@pxref{Packages,,, emacs, The GNU Emacs Manual}). The
+documentation of the @code{tabulated-list-mode} function explains what
+you need to do to use it.  At a minimum, specify the column format via
+the @code{tabulated-list-format} variable.
+@end deffn
+
 @node Generic Modes
 @subsection Generic Modes
 @cindex generic mode

diff --git a/etc/NEWS b/etc/NEWS
index 95748d68d6efae8e5e2db6b7c9b09eba92993a37..d2139d3fc08e4c3d34a5eb4074fca5aa091a54c2 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -968,6 +968,7 @@ When enabled, typing certain characters triggers reindentation.
 ** New global minor mode electric-layout-mode.
 When enabled, typing certain characters automatically inserts newlines.
 
++++
 ** tabulated-list.el provides a generic major mode for tabulated data,
 from which other modes can be derived.