From aea4c6ae3a0b470ca16b2b209f8ee344c7b21a94 Mon Sep 17 00:00:00 2001 From: Michael Albinus Date: Tue, 14 Jun 2016 10:37:58 +0200 Subject: [PATCH] Release debbugs 0.9.6. * 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 | 50 +++++++++----- packages/debbugs/debbugs-org.el | 6 ++ packages/debbugs/debbugs-ug.info | 113 ++++++++++++++++++------------- packages/debbugs/debbugs-ug.texi | 43 ++++++++---- packages/debbugs/debbugs.el | 2 +- 5 files changed, 137 insertions(+), 77 deletions(-) diff --git a/packages/debbugs/debbugs-gnu.el b/packages/debbugs/debbugs-gnu.el index 0ecfb165a..c5c4ca921 100644 --- a/packages/debbugs/debbugs-gnu.el +++ b/packages/debbugs/debbugs-gnu.el @@ -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))))) diff --git a/packages/debbugs/debbugs-org.el b/packages/debbugs/debbugs-org.el index ecd522d69..71adf1de0 100644 --- a/packages/debbugs/debbugs-org.el +++ b/packages/debbugs/debbugs-org.el @@ -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." diff --git a/packages/debbugs/debbugs-ug.info b/packages/debbugs/debbugs-ug.info index 422aa98b6..11738e30d 100644 --- a/packages/debbugs/debbugs-ug.info +++ b/packages/debbugs/debbugs-ug.info @@ -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. +  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 '' 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)  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)  File: debbugs-ug.info, Node: Key Index, Prev: Variable Index, Up: Top @@ -555,40 +574,40 @@ Key Index [index] * 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) -* '': Tabulated Lists. (line 30) -* '': Tabulated Lists. (line 31) -* 'R': Tabulated Lists. (line 40) -* '': Tabulated Lists. (line 29) -* 's': Tabulated Lists. (line 57) -* 't': Tabulated Lists. (line 60) -* '': 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) +* : Tabulated Lists. (line 30) +* : Tabulated Lists. (line 31) +* R: Tabulated Lists. (line 40) +* : Tabulated Lists. (line 29) +* s: Tabulated Lists. (line 57) +* t: Tabulated Lists. (line 60) +* : TODO Items. (line 16) +* w: Tabulated Lists. (line 44) +* x: Tabulated Lists. (line 63)  Tag Table: Node: Top1097 Node: Retrieving Bugs2635 -Node: Searching Bugs6095 -Ref: Searching Bugs-Footnote-19980 -Ref: Searching Bugs-Footnote-210068 -Node: Layout10159 -Node: Tabulated Lists10634 -Node: TODO Items13881 -Node: Control Messages14928 -Node: Minor Mode17324 -Node: Command Index18263 -Node: Variable Index18910 -Node: Key Index19558 +Node: Searching Bugs6362 +Ref: Searching Bugs-Footnote-110520 +Ref: Searching Bugs-Footnote-210608 +Node: Layout10699 +Node: Tabulated Lists11174 +Node: TODO Items14532 +Node: Control Messages15579 +Node: Minor Mode17975 +Node: Command Index18914 +Node: Variable Index19703 +Node: Key Index20422  End Tag Table diff --git a/packages/debbugs/debbugs-ug.texi b/packages/debbugs/debbugs-ug.texi index 045e9d1e3..40057a28b 100644 --- a/packages/debbugs/debbugs-ug.texi +++ b/packages/debbugs/debbugs-ug.texi @@ -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 diff --git a/packages/debbugs/debbugs.el b/packages/debbugs/debbugs.el index c99ba7aab..ad5147444 100644 --- a/packages/debbugs/debbugs.el +++ b/packages/debbugs/debbugs.el @@ -5,7 +5,7 @@ ;; Author: Michael Albinus ;; 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. -- 2.39.2