[elpa] externals/ebdb 838103e 01/16: New option ebdb-default-window-size to control popup sizes

[Eric Abrahamsen]

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

    New option ebdb-default-window-size to control popup sizes
    
    * ebdb-com.el (ebdb-default-window-size): New option, float between 0
      and 1.
      (ebdb-popup-window): Use it in the default no-specializers method.
      Later use this in the MUAs, too. Also delete some unnecessary :group
      tags on other options.
    * ebdb.org (Pop-up Buffers): Document new option.
---
 ebdb-com.el | 15 ++++++-----
 ebdb.info   | 89 ++++++++++++++++++++++++++++++++-----------------------------
 ebdb.org    | 12 ++++++---
 ebdb.texi   | 11 +++++---
 4 files changed, 72 insertions(+), 55 deletions(-)

diff --git a/ebdb-com.el b/ebdb-com.el
index 39bb8f9..40b5617 100644
--- a/ebdb-com.el
+++ b/ebdb-com.el
@@ -59,7 +59,6 @@
   "Make *EBDB* window a dedicated window.
 Allowed values include nil (not dedicated) 'ebdb (weakly dedicated)
 and t (strongly dedicated)."
-  :group 'ebdb-record-display
   :type '(choice (const :tag "EBDB window not dedicated" nil)
                  (const :tag "EBDB window weakly dedicated" ebdb)
                  (const :tag "EBDB window strongly dedicated" t)))
@@ -68,12 +67,17 @@ and t (strongly dedicated)."
   "When non-nil, have EBDB buffers join atomic windows.
 Atomic windows are window groups that are treated as single
 windows by other splitting/display code."
-  :group 'ebdb-record-display
   :type 'boolean)
 
+(defcustom ebdb-default-window-size 0.4
+  "Default size of EBDB popup windows.
+Specified as a float between 0 and 1, which is interpreted as a
+fractional size of the window that is being split to make way for
+the *EBDB* buffer."
+  :type 'float)
+
 (defcustom ebdb-fill-field-values t
   "When non-nil, fill long field values."
-  :group 'ebdb-record-display
   :type '(choice (const :tag "Always fill" nil)
                  (const :tag "Never fill" t)))
 
@@ -83,12 +87,10 @@ This should be a list of menu entries.
 When set to a function, it is called with two arguments RECORD and FIELD
 and it should either return nil or a list of menu entries.
 Used by `ebdb-mouse-menu'."
-  :group 'ebdb-record-display
   :type 'sexp)
 
 (defcustom ebdb-display-hook nil
   "Hook run after the *EBDB* is filled in."
-  :group 'ebdb-record-display
   :type 'hook)
 
 ;; Faces for font-lock
@@ -101,7 +103,6 @@ Used by `ebdb-mouse-menu'."
                                  (ebdb-record-organization . 
ebdb-organization-name))
   "Alist of record class types to the face names.
 Faces are used to font-lock their names in the *EBDB* buffer."
-  :group 'ebdb-faces
   :type '(repeat (cons (ebdb-record :tag "Record type") (face :tag "Face"))))
 
 (defface ebdb-person-name
@@ -817,7 +818,7 @@ Ie, don't pop up at all."
 
 (cl-defmethod ebdb-popup-window ()
   "When popping up from a random window, use half the window."
-  (list (get-buffer-window) 0.5))
+  (list (get-buffer-window) ebdb-default-window-size))
 
 (defun ebdb-display-records (records &optional fmt append
                                      select pop buf)
diff --git a/ebdb.info b/ebdb.info
index 0c8c0ad..b1546aa 100644
--- a/ebdb.info
+++ b/ebdb.info
@@ -671,10 +671,14 @@ Windows::).
      existing atomic windows will become part of the atomic buffer.
      Otherwise they will be opened to one side of the atomic window.
 
+ -- User Option: ebdb-default-window-size
+     Set to a float between 0 and 1 to specify how much of an existing
+     window the popped-up *EBDB* buffer should occupy.
+
    At present, there are _no_ other user customization options
-controlling the size and layout of MUA pop-up buffers: each MUA creates
-the pop-up according to hard-coded rules.  This will likely change in
-the future: please complain to the author.
+controlling the layout of MUA pop-up buffers: each MUA creates the
+pop-up according to hard-coded rules.  This will likely change in the
+future: please complain to the author.
 
 
 File: ebdb.info,  Node: Auto-Updating Records,  Next: Noticing and Automatic 
Rules,  Prev: Pop-up Buffers,  Up: Display and Updating
@@ -2326,6 +2330,7 @@ File: ebdb.info,  Node: Index,  Prev: Hacking EBDB,  Up: 
Top
 * ebdb-default-phone-class:              Hacking EBDB.        (line  40)
 * ebdb-default-record-class:             Creating Records.    (line  10)
 * ebdb-default-record-class <1>:         Hacking EBDB.        (line  24)
+* ebdb-default-window-size:              Pop-up Buffers.      (line  31)
 * ebdb-delete-field:                     Init and Delete Methods.
                                                               (line  15)
 * ebdb-delete-field-or-record:           The Basics of ebdb-mode.
@@ -2579,45 +2584,45 @@ Node: MUA Interaction20152
 Node: Loading MUA Code20705
 Node: Display and Updating21418
 Node: Pop-up Buffers22184
-Node: Auto-Updating Records23767
-Node: Noticing and Automatic Rules26167
-Node: Interactive Commands27500
-Node: EBDB and MUA summary buffers29975
-Node: Sender name display30493
-Node: Summary buffer marks31720
-Node: Mail Address Completion32899
-Node: A Note on Completion35408
-Node: Specific MUAs36031
-Node: Gnus36179
-Node: Posting Styles36401
-Node: EBDB Buffers37976
-Node: Searching39187
-Node: Changing Search Behavior40849
-Node: The Basics of ebdb-mode42096
-Node: Customizing Record Display46405
-Node: Marking50725
-Node: Exporting/Formatting51152
-Node: Completion52101
-Node: Snarfing52897
-Node: Internationalization54914
-Node: Diary Integration57615
-Node: Mail Aliases58480
-Node: vCard Support59194
-Node: Org Integration59693
-Node: Citing Records61591
-Node: Hacking EBDB62349
-Node: Field Classes64940
-Node: Init and Delete Methods68076
-Node: The Labeled Field Class69583
-Node: The Singleton Field Class70437
-Node: Actions70875
-Node: Custom Field Searching71547
-Node: Fast Lookups74414
-Node: Formatting in the EBDB Buffer76224
-Node: Writing Internationalization Libraries78300
-Node: Writing Integration For New MUAs82714
-Node: Article snarfing86162
-Node: Index86880
+Node: Auto-Updating Records23927
+Node: Noticing and Automatic Rules26327
+Node: Interactive Commands27660
+Node: EBDB and MUA summary buffers30135
+Node: Sender name display30653
+Node: Summary buffer marks31880
+Node: Mail Address Completion33059
+Node: A Note on Completion35568
+Node: Specific MUAs36191
+Node: Gnus36339
+Node: Posting Styles36561
+Node: EBDB Buffers38136
+Node: Searching39347
+Node: Changing Search Behavior41009
+Node: The Basics of ebdb-mode42256
+Node: Customizing Record Display46565
+Node: Marking50885
+Node: Exporting/Formatting51312
+Node: Completion52261
+Node: Snarfing53057
+Node: Internationalization55074
+Node: Diary Integration57775
+Node: Mail Aliases58640
+Node: vCard Support59354
+Node: Org Integration59853
+Node: Citing Records61751
+Node: Hacking EBDB62509
+Node: Field Classes65100
+Node: Init and Delete Methods68236
+Node: The Labeled Field Class69743
+Node: The Singleton Field Class70597
+Node: Actions71035
+Node: Custom Field Searching71707
+Node: Fast Lookups74574
+Node: Formatting in the EBDB Buffer76384
+Node: Writing Internationalization Libraries78460
+Node: Writing Integration For New MUAs82874
+Node: Article snarfing86322
+Node: Index87040
 
 End Tag Table
 
diff --git a/ebdb.org b/ebdb.org
index 5180089..91bb961 100644
--- a/ebdb.org
+++ b/ebdb.org
@@ -480,10 +480,16 @@ existing atomic windows will become part of the atomic 
buffer.
 Otherwise they will be opened to one side of the atomic window.
 #+end_defopt
 
+#+ATTR_TEXINFO: :options ebdb-default-window-size
+#+begin_defopt
+Set to a float between 0 and 1 to specify how much of an existing
+window the popped-up {{{buf(EBDB)}}} buffer should occupy.
+#+end_defopt
+
 At present, there are _no_ other user customization options
-controlling the size and layout of MUA pop-up buffers: each MUA
-creates the pop-up according to hard-coded rules.  This will likely
-change in the future: please complain to the author.
+controlling the layout of MUA pop-up buffers: each MUA creates the
+pop-up according to hard-coded rules.  This will likely change in the
+future: please complain to the author.
 *** Auto-Updating Records
 EBDB can automatically update the name and mail addresses of records
 based on information in an MUA message. The first and most important
diff --git a/ebdb.texi b/ebdb.texi
index 68993f6..960df2d 100644
--- a/ebdb.texi
+++ b/ebdb.texi
@@ -699,10 +699,15 @@ existing atomic windows will become part of the atomic 
buffer.
 Otherwise they will be opened to one side of the atomic window.
 @end defopt
 
+@defopt ebdb-default-window-size
+Set to a float between 0 and 1 to specify how much of an existing
+window the popped-up *EBDB* buffer should occupy.
+@end defopt
+
 At present, there are _no_ other user customization options
-controlling the size and layout of MUA pop-up buffers: each MUA
-creates the pop-up according to hard-coded rules.  This will likely
-change in the future: please complain to the author.
+controlling the layout of MUA pop-up buffers: each MUA creates the
+pop-up according to hard-coded rules.  This will likely change in the
+future: please complain to the author.
 
 @node Auto-Updating Records
 @subsection Auto-Updating Records