[elpa] master a75b177: Minor fixes for debbugs control messages

[Michael Albinus]

branch: master
commit a75b1774883be8946e9571314852ff80d191d287
Author: Michael Albinus <address@hidden>
Commit: Michael Albinus <address@hidden>

    Minor fixes for debbugs control messages
    
    * packages/debbugs/debbugs-gnu.el (debbugs-gnu-send-mail-function)
    (debbugs-gnu-mail-backend, debbugs-gnu-emacs-current-release):
    Fix :type entries.
    
    * packages/debbugs/debbugs-ug.texi (Control Messages):
    Precise arguments of some control messages.  Explain default value
    of `debbugs-gnu-send-mail-function'.
---
 packages/debbugs/debbugs-gnu.el  |   23 +++++++++++------------
 packages/debbugs/debbugs-ug.info |   22 +++++++++++++++-------
 packages/debbugs/debbugs-ug.texi |   13 +++++++++----
 packages/debbugs/debbugs.el      |    5 -----
 4 files changed, 35 insertions(+), 28 deletions(-)

diff --git a/packages/debbugs/debbugs-gnu.el b/packages/debbugs/debbugs-gnu.el
index 4169dc8..e868056 100644
--- a/packages/debbugs/debbugs-gnu.el
+++ b/packages/debbugs/debbugs-gnu.el
@@ -205,13 +205,15 @@
 (defcustom debbugs-gnu-send-mail-function nil
   "A function to send control messages from debbugs.
 If nil, the value of `send-mail-function' is used instead."
-  :type '(radio (function-item message-send-mail-with-sendmail)
+  :type '(radio (const :tag "Use `send-mail-function'" nil)
+               (function-item message-send-mail-with-sendmail)
                (function-item message-smtpmail-send-it)
+               (function-item mailclient-send-it)
                (function-item smtpmail-send-it)
                (function-item feedmail-send-it)
-               (function-item message-send-mail-with-mailclient
-                              :tag "Use Mailclient package")
-               (function :tag "Other"))
+               (function-item :tag "Use Mailclient package"
+                              message-send-mail-with-mailclient)
+               (function :tag "Other function"))
   :version "25.1")
 
 (defcustom debbugs-gnu-suppress-closed t
@@ -276,8 +278,8 @@ suppressed bugs is toggled by 
`debbugs-gnu-toggle-suppress'."
 If this is `gnus', the default, use Gnus.
 If this is `rmail', use Rmail instead."
   :group 'debbugs-gnu
-  :type '(choice (const :tag "Use Gnus" 'gnus)
-                (const :tag "Use Rmail" 'rmail))
+  :type '(radio (function-item :tag "Use Gnus" gnus)
+               (function-item :tag "Use Rmail" rmail))
   :version "25.1")
 
 (defface debbugs-gnu-archived '((t (:inverse-video t)))
@@ -337,9 +339,9 @@ The specification which bugs shall be suppressed is taken 
from
 (defcustom debbugs-gnu-emacs-current-release "25.1"
   "The current Emacs relase developped for."
   :group 'debbugs-gnu
-  :type '(set (const "24.5")
-             (const "25.1")
-             (const "25.2"))
+  :type '(choice (const "24.5")
+                (const "25.1")
+                (const "25.2"))
   :version "25.1")
 
 (defconst debbugs-gnu-blocking-reports
@@ -1850,7 +1852,4 @@ If given a prefix, patch in the branch directory instead."
 
 ;;; TODO:
 
-;; * Another random thought - is it possible to implement some local
-;;   cache, so only changed bugs are fetched?  Glenn Morris.
-
 ;;; debbugs-gnu.el ends here
diff --git a/packages/debbugs/debbugs-ug.info b/packages/debbugs/debbugs-ug.info
index 4a21010..03da162 100644
--- a/packages/debbugs/debbugs-ug.info
+++ b/packages/debbugs/debbugs-ug.info
@@ -429,7 +429,8 @@ The strings show the exact format of the control messages.
 'close'
      "close 12345 25.1"
 
-     The second argument, the Emacs version, is read interactively.
+     The second argument, the Emacs version, is read interactively if
+     the bugs belongs to the '"emacs"' package.
 
 'confirmed'
 'fixed'
@@ -453,13 +454,14 @@ The strings show the exact format of the control messages.
      "close 12345 25.1"
 
      The second argument in the close message, the Emacs version, is
-     read interactively.
+     read interactively if the bugs belongs to the '"emacs"' package.
 
 'forcemerge'
 'merge'
      "forcemerge|merge 12345 54321"
 
-     The second bug number is read interactively.
+     The second bug number is read interactively.  It could be also a
+     list of comma-separated bug numbers.
 
 'invalid'
      "tags 12345 notabug"
@@ -505,6 +507,12 @@ The strings show the exact format of the control messages.
      The username, read interactively, is either a package name or an
      email address.  The tag to be set is also read interactively.
 
+   How the control messages are sent is controlled by the
+'debbugs-gnu-send-mail-function' variable.  If it is 'nil' (the
+default value), the value of 'send-mail-function' is used.  This could
+be inconvenient, for example when an external interactive mail client
+is configured.
+
 
 File: debbugs-ug.info,  Node: Minor Mode,  Next: Command Index,  Prev: Layout, 
 Up: Top
 
@@ -605,9 +613,9 @@ Node: Layout10687
 Node: Tabulated Lists11162
 Node: TODO Items14520
 Node: Control Messages15567
-Node: Minor Mode17963
-Node: Command Index18902
-Node: Variable Index19691
-Node: Key Index20410
+Node: Minor Mode18399
+Node: Command Index19338
+Node: Variable Index20127
+Node: Key Index20846
 
 End Tag Table
diff --git a/packages/debbugs/debbugs-ug.texi b/packages/debbugs/debbugs-ug.texi
index 9ba5a33..d931c01 100644
--- a/packages/debbugs/debbugs-ug.texi
+++ b/packages/debbugs/debbugs-ug.texi
@@ -492,7 +492,8 @@ of comma-separated bug numbers.
 @item close
 "close 12345 25.1"
 
-The second argument, the Emacs version, is read interactively.
+The second argument, the Emacs version, is read interactively if the
+bugs belongs to the @code{"emacs"} package.
 
 @item confirmed
 @itemx fixed
@@ -516,13 +517,14 @@ The second argument, the Emacs version, is read 
interactively.
 "close 12345 25.1"
 
 The second argument in the close message, the Emacs version, is read
-interactively.
+interactively if the bugs belongs to the @code{"emacs"} package.
 
 @item forcemerge
 @itemx merge
 "forcemerge|merge 12345 54321"
 
-The second bug number is read interactively.
+The second bug number is read interactively.  It could be also a list
+of comma-separated bug numbers.
 
 @item invalid
 "tags 12345 notabug" @*
@@ -570,7 +572,10 @@ address.  The tag to be set is also read interactively.
 @end table
 
 How the control messages are sent is controlled by the
address@hidden variable.
address@hidden variable.  If it is @code{nil}
+(the default value), the value of @code{send-mail-function} is used.
+This could be inconvenient, for example when an external interactive
+mail client is configured.
 
 
 @node Minor Mode
diff --git a/packages/debbugs/debbugs.el b/packages/debbugs/debbugs.el
index 8221c37..3aa6cfd 100644
--- a/packages/debbugs/debbugs.el
+++ b/packages/debbugs/debbugs.el
@@ -933,9 +933,4 @@ current buffer."
 
 ;;; TODO:
 
-;; * SOAP interface extensions (wishlist).
-;;   - Server-side sorting.
-;;   - Regexp and/or wildcards search.
-;;   - Returning message attachments.
-
 ;;; debbugs.el ends here