]> code.delx.au - gnu-emacs-elpa/commitdiff
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 0ecfb165a73c6e47b0b3710068549a942debb199..c5c4ca92139f79c91c4bb369897528793c5a0c60 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."))
 
 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.
 ;;;###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
            (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.
                       nil t))
            (cond
             ;; Server-side queries.
@@ -496,6 +502,12 @@ marked as \"client-side filter\"."
        ;; Do the search.
        (debbugs-gnu severities packages archivedp))))
 
        ;; 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."
 ;;;###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))
   "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)
         (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)))
       (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)))))
 
      ;; Otherwise, we retrieve the bugs from the server.
      (t (apply 'debbugs-get-bugs args)))))
 
index ecd522d69213c90046a85113c2f1f9f4b451c58a..71adf1de03233dd36a0cf6b7cdfa4d68d334391f 100644 (file)
@@ -195,6 +195,12 @@ returned."
        ;; Do the search.
        (debbugs-org severities packages))))
 
        ;; 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."
 ;;;###autoload
 (defun debbugs-org (severities &optional packages archivedp suppress tags)
   "List all outstanding bugs."
index 422aa98b6e60a38bba6b7889a567ba942d07a39d..11738e30deea2619b291c2fd3e2a2dd33ec68635 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.
 debbugs-ug.texi.
 
 Copyright (C) 2015-2016 Free Software Foundation, Inc.
@@ -136,28 +136,38 @@ prefix.
 
      *note Layout:: for the presentation of the results.
 
 
      *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.
 ************************************
 
 \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
 (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,
 
      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)
      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.
 
      '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
 
      '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'
           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
 
      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'
           this is the same as the status mentioned above.
 
      'owner'
+     'submitter'
      'maint'
      'correspondent'
      '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'
           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
      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 ----------
 
 
    ---------- Footnotes ----------
 
@@ -345,6 +358,9 @@ This enables the following key strokes:
                *note Control Messages::.
                
 
                *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
    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-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:                           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
 
 \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-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
 
 \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:
 
 \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
 
 
 \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
 \1f
 End Tag Table
index 045e9d1e3fd00f79d4fc403fa9c47f55a3abe45a..40057a28b2410b146bb468920046203b295bce67 100644 (file)
@@ -156,11 +156,22 @@ must be entered as comma-separated list.
 @end deffn
 
 
 @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.
 
 @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.}.
 @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
 @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"
 
 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 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
 
 @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
 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
 @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
 same as the status mentioned above.
 
 @item  owner
+@itemx submitter
 @itemx maint
 @itemx correspondent
 @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
 
 @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.
 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
 
 
 @end deffn
 
 
@@ -391,6 +406,10 @@ Send a control message for this bug, @ref{Control Messages}.
 
 @end multitable
 
 
 @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
 @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 c99ba7aabf865504292b2ac1d6b171f116cc5d30..ad5147444fa4f2e9e7ecdd6549e086d3b1f54727 100644 (file)
@@ -5,7 +5,7 @@
 ;; Author: Michael Albinus <michael.albinus@gmx.de>
 ;; Keywords: comm, hypermedia
 ;; Package: debbugs
 ;; 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.
 ;; Package-Requires: ((soap-client "3.1.1") (cl-lib "0.5"))
 
 ;; This file is not part of GNU Emacs.