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.
(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.
;; 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."
"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)
(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)))))
-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.
*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)
'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
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
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'
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 ----------
*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
* 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
* 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
\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
@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.}.
@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"
@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
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
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
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 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