Release debbugs 0.9.6.
authorMichael Albinus <michael.albinus@gmx.de>
Tue, 14 Jun 2016 08:37:58 +0000 (10:37 +0200)
committerMichael Albinus <michael.albinus@gmx.de>
Tue, 14 Jun 2016 08:37:58 +0000 (10:37 +0200)
* packages/debbugs/debbugs-gnu.el (debbugs-gnu-search): Fix list
of supported attributes.
(debbugs-gnu-patches): Move down.  Do not use hard coded package list.
(debbugs-gnu-get-bugs): Re-enable user tags.

* packages/debbugs/debbugs-org.el (debbugs-org-patches): New defun.

* packages/debbugs/debbugs-ug.texi (Retrieving Bugs):
Add debbugs-gnu-patches and debbugs-org-patches.
(Searching Bugs): Precise, that this isn't a FULL text search.
Fix list of supported attributes.
(Tabulated Lists): Document debbugs-gnu-suppress-closed.

* packages/debbugs/debbugs.el: Increase Version to 0.9.6.

packages/debbugs/debbugs-gnu.el
packages/debbugs/debbugs-org.el
packages/debbugs/debbugs-ug.info
packages/debbugs/debbugs-ug.texi
packages/debbugs/debbugs.el

index 0ecfb16..c5c4ca9 100644 (file)
@@ -342,12 +342,6 @@ between the words, AND is used by default.  The phrase can also
 be empty, in this case only the following attributes are used for
 search."))
 
-;;;###autoload
-(defun debbugs-gnu-patches ()
-  "List the bug reports that have been marked as containing a patch."
-  (interactive)
-  (debbugs-gnu nil '("emacs") nil nil "patch"))
-
 ;;;###autoload
 (defun debbugs-gnu-search ()
   "Search for Emacs bugs interactively.
@@ -379,16 +373,28 @@ marked as \"client-side filter\"."
            (setq key (completing-read
                       "Enter attribute: "
                       (if phrase
-                          '("severity" "package" "tags"
-                            "author" "date" "subject"
-                            ;; Client-side queries.
-                            "status")
-                        '("severity" "package" "archive" "src" "status" "tag"
-                          "owner" "submitter" "maint" "correspondent"
-                          ;; Client-side queries.
-                          "date" "log_modified" "last_modified"
-                          "found_date" "fixed_date" "unarchived"
-                          "subject" "done" "forwarded" "msgid" "summary"))
+                          (append
+                           '("severity" "package" "tags"
+                             "author" "date" "subject")
+                            ;; Client-side filters.
+                           (mapcar
+                            (lambda (key)
+                              (propertize
+                               key 'face 'debbugs-gnu-done
+                               'help-echo "Client-side filter"))
+                            '("status")))
+                        (append
+                         '("severity" "package" "archive" "src" "status" "tag"
+                           "owner" "submitter" "maint" "correspondent")
+                         ;; Client-side filters.
+                         (mapcar
+                          (lambda (key)
+                            (propertize
+                             key 'face 'debbugs-gnu-done
+                             'help-echo "Client-side filter"))
+                          '("date" "log_modified" "last_modified"
+                            "found_date" "fixed_date" "unarchived"
+                            "subject" "done" "forwarded" "msgid" "summary"))))
                       nil t))
            (cond
             ;; Server-side queries.
@@ -496,6 +502,12 @@ marked as \"client-side filter\"."
        ;; Do the search.
        (debbugs-gnu severities packages archivedp))))
 
+;;;###autoload
+(defun debbugs-gnu-patches ()
+  "List the bug reports that have been marked as containing a patch."
+  (interactive)
+  (debbugs-gnu nil debbugs-gnu-default-packages nil nil "patch"))
+
 ;;;###autoload
 (defun debbugs-gnu (severities &optional packages archivedp suppress tags)
   "List all outstanding bugs."
@@ -563,7 +575,7 @@ marked as \"client-side filter\"."
   "Retrieve bug numbers from debbugs.gnu.org according search criteria."
   (let* ((debbugs-port "gnu.org")
         (bugs (assoc 'bugs query))
-        (tags (assoc 'tag query))
+        (tags (and (member '(severity . "tagged") query) (assoc 'tag query)))
         (local-tags (and (member '(severity . "tagged") query) (not tags)))
         (phrase (assoc 'phrase query))
         args)
@@ -600,6 +612,10 @@ marked as \"client-side filter\"."
       (mapcar
        (lambda (x) (cdr (assoc "id" x)))
        (apply 'debbugs-search-est args)))
+     ;; User tags.
+     (tags
+      (setq args (mapcar (lambda (x) (if (eq x :package) :user x)) args))
+      (apply 'debbugs-get-usertag args))
      ;; Otherwise, we retrieve the bugs from the server.
      (t (apply 'debbugs-get-bugs args)))))
 
index ecd522d..71adf1d 100644 (file)
@@ -195,6 +195,12 @@ returned."
        ;; Do the search.
        (debbugs-org severities packages))))
 
+;;;###autoload
+(defun debbugs-org-patches ()
+  "List the bug reports that have been marked as containing a patch."
+  (interactive)
+  (debbugs-org nil debbugs-gnu-default-packages nil nil "patch"))
+
 ;;;###autoload
 (defun debbugs-org (severities &optional packages archivedp suppress tags)
   "List all outstanding bugs."
index 422aa98..11738e3 100644 (file)
@@ -1,4 +1,4 @@
-This is debbugs-ug.info, produced by makeinfo version 6.0 from
+This is debbugs-ug.info, produced by makeinfo version 6.1 from
 debbugs-ug.texi.
 
 Copyright (C) 2015-2016 Free Software Foundation, Inc.
@@ -136,28 +136,38 @@ prefix.
 
      *note Layout:: for the presentation of the results.
 
+ -- Command: debbugs-gnu-patches
+ -- Command: debbugs-org-patches
+
+     The commands 'debbugs-gnu-patches' and 'debbugs-org-patches' show
+     all bugs tagged with '"patch"'.  This is useful for bug triages.
+
+     *note Layout:: for the presentation of the results.
+
 \1f
 File: debbugs-ug.info,  Node: Searching Bugs,  Next: Layout,  Prev: Retrieving Bugs,  Up: Top
 
 2 Searching in the Debbugs Database.
 ************************************
 
-The GNU Debbugs server allows full text search in the database.  It
-uses a HyperEstraier based search engine
+The GNU Debbugs server allows text search in the database in the
+messages submitted to the bugs.  It uses a HyperEstraier based search
+engine
 (http://fallabs.com/hyperestraier/uguide-en.html#searchcond)(1).
 
  -- Command: debbugs-gnu-search
  -- Command: debbugs-org-search
 
      These both commands are completely interactive.  They ask for a
-     '"search phrase"' for the full text search.  It is just a string
-     which contains the words to be searched for, combined by
-     operators like AND, ANDNOT and OR. If there is no operator
-     between the words, AND is used by default.
+     '"search phrase"' for the text search.  It is just a string which
+     contains the words to be searched for, combined by operators like
+     AND, ANDNOT and OR.  If there is no operator between the words,
+     AND is used by default.  Only complete words, contained in a
+     message body, are searched for.
 
      Wild card searches are also supported.  It can be used for
      forward match search and backward match search.  For example,
-     "[BW] euro" matches words which begin with "euro".  "[EW] shere"
+     "[BW] euro" matches words which begin with "euro".  "[EW] sphere"
      matches words which end with "sphere".  Moreover, regular
      expressions are also supported.  For example, "[RX] ^inter.*al$"
      matches words which begin with "inter" and end with "al".(2)
@@ -182,8 +192,8 @@ uses a HyperEstraier based search engine
      'tags'
           A comma-separated list of defined user tags.
 
-     'submitter'
-          The email address of the bug submitter.
+     'author'
+          The email address of a message originator.
 
      'date'
           A time period the bug has been in which the bug has been
@@ -193,8 +203,8 @@ uses a HyperEstraier based search engine
           Word(s) the subject of the bug report contains.
 
      'status'
-          The status of the bug report.  Valid values are "done",
-          "forwarded" and "open".
+          The status of the bug report.  Valid values are "pending",
+          "forwarded", "fixed" and "done".
 
      It is also possible to apply these commands with an empty search
      phrase.  In this case, the GNU Debbugs server is searched only
@@ -214,10 +224,11 @@ uses a HyperEstraier based search engine
           this is the same as the status mentioned above.
 
      'owner'
+     'submitter'
      'maint'
      'correspondent'
-          The email address of the bug's owner, maintainer, or
-          correspondent (somebody who has participated in bug
+          The email address of the bug's owner, submitter, maintainer,
+          or correspondent (somebody who has participated in bug
           messages).
 
      'log_modified'
@@ -247,7 +258,9 @@ uses a HyperEstraier based search engine
      server via the Debbugs/SOAP backend.  In this case, the results
      of a query are discriminated on the client side, which is
      indicated by the string "(client-side filter)" in the minibuffer
-     after the attribute name.
+     after the attribute name.  Note, that client side filters perform
+     badly, because they could be applied only after all bugs have
+     been downloaded.
 
    ---------- Footnotes ----------
 
@@ -345,6 +358,9 @@ This enables the following key strokes:
                *note Control Messages::.
                
 
+   The user option 'debbugs-gnu-suppress-closed' controls, whether
+closed bugs are shown in the initial list.
+
    The user option 'debbugs-gnu-mail-backend' controls the
 presentation of email messages produced by typing '<RET>' or by
 clicking the mouse on a bug: if its value is 'gnus', the default, a
@@ -524,10 +540,12 @@ Command Index
 * debbugs-browse-mode:                   Minor Mode.         (line 12)
 * debbugs-gnu:                           Retrieving Bugs.    (line 15)
 * debbugs-gnu-bugs:                      Retrieving Bugs.    (line 69)
-* debbugs-gnu-search:                    Searching Bugs.     (line 10)
+* debbugs-gnu-patches:                   Retrieving Bugs.    (line 78)
+* debbugs-gnu-search:                    Searching Bugs.     (line 11)
 * debbugs-org:                           Retrieving Bugs.    (line 17)
 * debbugs-org-bugs:                      Retrieving Bugs.    (line 70)
-* debbugs-org-search:                    Searching Bugs.     (line 11)
+* debbugs-org-patches:                   Retrieving Bugs.    (line 79)
+* debbugs-org-search:                    Searching Bugs.     (line 12)
 
 \1f
 File: debbugs-ug.info,  Node: Variable Index,  Next: Key Index,  Prev: Command Index,  Up: Top
@@ -544,7 +562,8 @@ Variable Index
 * debbugs-gnu-default-packages:          Retrieving Bugs.    (line 63)
 * debbugs-gnu-default-severities:        Retrieving Bugs.    (line 63)
 * debbugs-gnu-default-suppress-bugs:     Retrieving Bugs.    (line 44)
-* debbugs-gnu-mail-backend:              Tabulated Lists.    (line 71)
+* debbugs-gnu-mail-backend:              Tabulated Lists.    (line 74)
+* debbugs-gnu-suppress-closed:           Tabulated Lists.    (line 71)
 
 \1f
 File: debbugs-ug.info,  Node: Key Index,  Prev: Variable Index,  Up: Top
@@ -555,40 +574,40 @@ Key Index
 \0\b[index\0\b]
 * Menu:
 
-* '/':                                   Tabulated Lists.    (line 36)
-* 'B':                                   Tabulated Lists.    (line 52)
-* 'b':                                   Tabulated Lists.    (line 53)
-* 'C':                                   Tabulated Lists.    (line 66)
-* 'C-c # C':                             TODO Items.         (line 25)
-* 'C-c # d':                             TODO Items.         (line 19)
-* 'C-c # t':                             TODO Items.         (line 22)
-* 'd':                                   Tabulated Lists.    (line 33)
-* 'g':                                   Tabulated Lists.    (line 47)
-* '<mouse-1>':                           Tabulated Lists.    (line 30)
-* '<mouse-2>':                           Tabulated Lists.    (line 31)
-* 'R':                                   Tabulated Lists.    (line 40)
-* '<RET>':                               Tabulated Lists.    (line 29)
-* 's':                                   Tabulated Lists.    (line 57)
-* 't':                                   Tabulated Lists.    (line 60)
-* '<TAB>':                               TODO Items.         (line 16)
-* 'w':                                   Tabulated Lists.    (line 44)
-* 'x':                                   Tabulated Lists.    (line 63)
+* /:                                     Tabulated Lists.    (line 36)
+* B:                                     Tabulated Lists.    (line 52)
+* b:                                     Tabulated Lists.    (line 53)
+* C:                                     Tabulated Lists.    (line 66)
+* C-c # C:                               TODO Items.         (line 25)
+* C-c # d:                               TODO Items.         (line 19)
+* C-c # t:                               TODO Items.         (line 22)
+* d:                                     Tabulated Lists.    (line 33)
+* g:                                     Tabulated Lists.    (line 47)
+* <mouse-1>:                             Tabulated Lists.    (line 30)
+* <mouse-2>:                             Tabulated Lists.    (line 31)
+* R:                                     Tabulated Lists.    (line 40)
+* <RET>:                                 Tabulated Lists.    (line 29)
+* s:                                     Tabulated Lists.    (line 57)
+* t:                                     Tabulated Lists.    (line 60)
+* <TAB>:                                 TODO Items.         (line 16)
+* w:                                     Tabulated Lists.    (line 44)
+* x:                                     Tabulated Lists.    (line 63)
 
 
 \1f
 Tag Table:
 Node: Top\7f1097
 Node: Retrieving Bugs\7f2635
-Node: Searching Bugs\7f6095
-Ref: Searching Bugs-Footnote-1\7f9980
-Ref: Searching Bugs-Footnote-2\7f10068
-Node: Layout\7f10159
-Node: Tabulated Lists\7f10634
-Node: TODO Items\7f13881
-Node: Control Messages\7f14928
-Node: Minor Mode\7f17324
-Node: Command Index\7f18263
-Node: Variable Index\7f18910
-Node: Key Index\7f19558
+Node: Searching Bugs\7f6362
+Ref: Searching Bugs-Footnote-1\7f10520
+Ref: Searching Bugs-Footnote-2\7f10608
+Node: Layout\7f10699
+Node: Tabulated Lists\7f11174
+Node: TODO Items\7f14532
+Node: Control Messages\7f15579
+Node: Minor Mode\7f17975
+Node: Command Index\7f18914
+Node: Variable Index\7f19703
+Node: Key Index\7f20422
 \1f
 End Tag Table
index 045e9d1..40057a2 100644 (file)
@@ -156,11 +156,22 @@ must be entered as comma-separated list.
 @end deffn
 
 
+@deffn  {Command} debbugs-gnu-patches
+@deffnx {Command} debbugs-org-patches
+
+The commands @code{debbugs-gnu-patches} and @code{debbugs-org-patches} show
+all bugs tagged with @code{"patch"}.  This is useful for bug triages.
+
+@ref{Layout} for the presentation of the results.
+
+@end deffn
+
+
 @node Searching Bugs
 @chapter Searching in the Debbugs Database.
 
-The GNU Debbugs server allows full text search in the database.  It
-uses a
+The GNU Debbugs server allows text search in the database in the
+messages submitted to the bugs.  It uses a
 @uref{http://fallabs.com/hyperestraier/uguide-en.html#searchcond,
 HyperEstraier based search engine}@footnote{This has been added to the
 Debbugs/SOAP backend of the GNU Debbugs server only.}.
@@ -169,10 +180,11 @@ Debbugs/SOAP backend of the GNU Debbugs server only.}.
 @deffnx {Command} debbugs-org-search
 
 These both commands are completely interactive.  They ask for a
-@code{"search phrase"} for the full text search.  It is just a string
-which contains the words to be searched for, combined by operators
-like AND, ANDNOT and OR.  If there is no operator between the words,
-AND is used by default.
+@code{"search phrase"} for the text search.  It is just a string which
+contains the words to be searched for, combined by operators like AND,
+ANDNOT and OR@.  If there is no operator between the words, AND is
+used by default.  Only complete words, contained in a message body,
+are searched for.
 
 Wild card searches are also supported.  It can be used for forward
 match search and backward match search.  For example, "[BW] euro"
@@ -202,8 +214,8 @@ server, @xref{Retrieving Bugs}.
 @item tags
 A comma-separated list of defined user tags.
 
-@item submitter
-The email address of the bug submitter.
+@item author
+The email address of a message originator.
 
 @item date
 A time period the bug has been in which the bug has been submitted or
@@ -213,8 +225,8 @@ modified.
 Word(s) the subject of the bug report contains.
 
 @item status
-The status of the bug report.  Valid values are "done", "forwarded"
-and "open".
+The status of the bug report.  Valid values are "pending",
+"forwarded", "fixed" and "done".
 @end table
 
 It is also possible to apply these commands with an empty search
@@ -234,10 +246,11 @@ An arbitrary string the bug is annotated with.  Usually, this is the
 same as the status mentioned above.
 
 @item  owner
+@itemx submitter
 @itemx maint
 @itemx correspondent
-The email address of the bug's owner, maintainer, or correspondent
-(somebody who has participated in bug messages).
+The email address of the bug's owner, submitter, maintainer, or
+correspondent (somebody who has participated in bug messages).
 
 @item  log_modified
 @itemx last_modified
@@ -265,6 +278,8 @@ Not all of these attributes could be queried on the GNU Debbugs server
 via the Debbugs/SOAP backend.  In this case, the results of a query
 are discriminated on the client side, which is indicated by the string
 "(client-side filter)" in the minibuffer after the attribute name.
+Note, that client side filters perform badly, because they could be
+applied only after all bugs have been downloaded.
 @end deffn
 
 
@@ -391,6 +406,10 @@ Send a control message for this bug, @ref{Control Messages}.
 
 @end multitable
 
+@vindex debbugs-gnu-suppress-closed
+The user option @code{debbugs-gnu-suppress-closed} controls, whether
+closed bugs are shown in the initial list.
+
 @vindex debbugs-gnu-mail-backend
 The user option @code{debbugs-gnu-mail-backend} controls the
 presentation of email messages produced by typing @kbd{@key{RET}} or
index c99ba7a..ad51474 100644 (file)
@@ -5,7 +5,7 @@
 ;; Author: Michael Albinus <michael.albinus@gmx.de>
 ;; Keywords: comm, hypermedia
 ;; Package: debbugs
-;; Version: 0.9.5
+;; Version: 0.9.6
 ;; Package-Requires: ((soap-client "3.1.1") (cl-lib "0.5"))
 
 ;; This file is not part of GNU Emacs.