[elpa] externals/ebdb b3dfcb8 13/16: New command ebdb-format-these-records

[Eric Abrahamsen]

branch: externals/ebdb
commit b3dfcb883ff687bad2a1eaab27e75ef48f2f01b8
Author: Eric Abrahamsen <address@hidden>
Commit: Eric Abrahamsen <address@hidden>

    New command ebdb-format-these-records
    
    * ebdb-com.el (ebdb-format-these-records): New command formatting all
      the records currently displayed in the EBDB buffer.
      (ebdb-mode-map): Bind "F" to this command instead of
      ebdb-format-all-records, as it's more useful.
      (ebdb-format-to-tmp-buffer): Remove spurious &optional.
---
 ebdb-com.el | 17 +++++++++++++++--
 ebdb.info   | 48 ++++++++++++++++++++++++------------------------
 ebdb.org    |  6 +++---
 ebdb.texi   |  6 +++---
 4 files changed, 45 insertions(+), 32 deletions(-)

diff --git a/ebdb-com.el b/ebdb-com.el
index 37e6d89..0565f89 100644
--- a/ebdb-com.el
+++ b/ebdb-com.el
@@ -282,7 +282,7 @@ display information."
 
     (define-key km (kbd "r")           'ebdb-reformat-records)
     (define-key km (kbd "f")           'ebdb-format-to-tmp-buffer)
-    (define-key km (kbd "F")           'ebdb-format-all-records)
+    (define-key km (kbd "F")           'ebdb-format-these-records)
     (define-key km (kbd "I")            'ebdb-cite-records-ebdb)
     (define-key km (kbd "C-k")         'ebdb-delete-field-or-record)
     (define-key km (kbd "i")           'ebdb-insert-field)
@@ -3046,7 +3046,10 @@ message."
 ;;; Formatting
 
 ;;;###autoload
-(defun ebdb-format-to-tmp-buffer (&optional formatter records)
+(defun ebdb-format-to-tmp-buffer (formatter records)
+  "Format some records and display in a temporary buffer.
+Records are formatted using FORMATTER, which is prompted for.
+RECORDS is the record under point, or all marked records."
   (interactive
    (list (ebdb-prompt-for-formatter)
         (ebdb-do-records)))
@@ -3081,6 +3084,16 @@ message."
       (when (fboundp f)
        (funcall f)))))
 
+;;;###autoload
+(defun ebdb-format-these-records (formatter)
+  "Format all records in the current *EBDB* buffer.
+Prompts for FORMATTER to use."
+  (interactive
+   (list (ebdb-prompt-for-formatter)))
+  (if (derived-mode-p 'ebdb-mode)
+      (ebdb-format-to-tmp-buffer formatter (mapcar #'car ebdb-records))
+    (error "Not in an *EBDB* buffer")))
+
 ;;; Copy to kill ring
 
 ;;;###autoload
diff --git a/ebdb.info b/ebdb.info
index f6f9a3d..22e2773 100644
--- a/ebdb.info
+++ b/ebdb.info
@@ -1421,8 +1421,8 @@ is unsupported: the only options are version 3.0 and 4.0.
      *note marking: Marking. to format multiple records.
 
 ‘F’
-     Export all records in the database (not only those displayed) to a
-     different format (‘ebdb-format-all-records’).
+     Export all records in the current EBDB buffer to a different format
+     (‘ebdb-format-these-records’).
 
    It’s possible to write new formatters, documentation is forthcoming.
 
@@ -2362,7 +2362,7 @@ File: ebdb.info,  Node: Index,  Prev: Hacking EBDB,  Up: 
Top
                                                               (line  24)
 * ebdb-fill-field-values:                Customizing Record Display.
                                                               (line  28)
-* ebdb-format-all-records:               Exporting/Formatting.
+* ebdb-format-these-records:             Exporting/Formatting.
                                                               (line  20)
 * ebdb-format-to-tmp-buffer:             Exporting/Formatting.
                                                               (line  15)
@@ -2612,27 +2612,27 @@ Node: The Basics of ebdb-mode42726
 Node: Customizing Record Display47035
 Node: Marking51355
 Node: Exporting/Formatting51782
-Node: Completion52731
-Node: Snarfing53527
-Node: Internationalization55544
-Node: Diary Integration58245
-Node: Mail Aliases59110
-Node: vCard Support59824
-Node: Org Integration60323
-Node: Citing Records62221
-Node: Hacking EBDB62979
-Node: Field Classes65570
-Node: Init and Delete Methods68706
-Node: The Labeled Field Class70213
-Node: The Singleton Field Class71067
-Node: Actions71505
-Node: Custom Field Searching72177
-Node: Fast Lookups75044
-Node: Formatting in the EBDB Buffer76854
-Node: Writing Internationalization Libraries78930
-Node: Writing Integration For New MUAs83344
-Node: Article snarfing86792
-Node: Index87510
+Node: Completion52717
+Node: Snarfing53513
+Node: Internationalization55530
+Node: Diary Integration58231
+Node: Mail Aliases59096
+Node: vCard Support59810
+Node: Org Integration60309
+Node: Citing Records62207
+Node: Hacking EBDB62965
+Node: Field Classes65556
+Node: Init and Delete Methods68692
+Node: The Labeled Field Class70199
+Node: The Singleton Field Class71053
+Node: Actions71491
+Node: Custom Field Searching72163
+Node: Fast Lookups75030
+Node: Formatting in the EBDB Buffer76840
+Node: Writing Internationalization Libraries78916
+Node: Writing Integration For New MUAs83330
+Node: Article snarfing86778
+Node: Index87496
 
 End Tag Table
 
diff --git a/ebdb.org b/ebdb.org
index 2acf332..099654a 100644
--- a/ebdb.org
+++ b/ebdb.org
@@ -1332,9 +1332,9 @@ imperfect: not all fields can be exported correctly.  
VCard version
 - F ::
 
      #+KINDEX: F
-     #+FINDEX: ebdb-format-all-records
-     Export all records in the database (not only those displayed) to
-     a different format (~ebdb-format-all-records~).
+     #+FINDEX: ebdb-format-these-records
+     Export all records in the current EBDB buffer to a different
+     format (~ebdb-format-these-records~).
 
 It's possible to write new formatters, documentation is forthcoming.
 * Completion
diff --git a/ebdb.texi b/ebdb.texi
index 0c35975..7d484bb 100644
--- a/ebdb.texi
+++ b/ebdb.texi
@@ -1560,9 +1560,9 @@ Use @ref{Marking, , marking} to format multiple records.
 
 @item F
 @kindex F
-@findex ebdb-format-all-records
-Export all records in the database (not only those displayed) to
-a different format (@code{ebdb-format-all-records}).
+@findex ebdb-format-these-records
+Export all records in the current EBDB buffer to a different
+format (@code{ebdb-format-these-records}).
 @end table
 
 It's possible to write new formatters, documentation is forthcoming.