[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/debbugs 298ea80 081/311: * debbugs.texi: Update documen
From: |
Stefan Monnier |
Subject: |
[elpa] externals/debbugs 298ea80 081/311: * debbugs.texi: Update documentation. |
Date: |
Sun, 29 Nov 2020 18:41:45 -0500 (EST) |
branch: externals/debbugs
commit 298ea80ce1fcffcb0c6e2d14627e5b4607d103fe
Author: Evgeny M. Zubok <zoubok@mail.ru>
Commit: Michael Albinus <michael.albinus@gmx.de>
* debbugs.texi: Update documentation.
---
debbugs.texi | 70 ++++++++++++++++++++++++++++++++++++++++++++++--------------
1 file changed, 54 insertions(+), 16 deletions(-)
diff --git a/debbugs.texi b/debbugs.texi
index 92e33e2..ed0dd2a 100644
--- a/debbugs.texi
+++ b/debbugs.texi
@@ -45,7 +45,7 @@ the Debian project but actually used also by the GNU project.
The
main distinctive feature of Debbugs is that it's mostly email-based.
All actions on bug reports: opening, closing, changing the status,
commenting, forwarding are performed via email by sending specially
-composed letters to the partucular mail addresses. However, searching
+composed letters to the particular mail addresses. However, searching
the bug reports, querying bug report status and viewing comments have
been web-based for a long time. To overcome this inconvenience the
Debbugs/SOAP service was introduced.
@@ -165,9 +165,16 @@ Debbugs server the list of bug numbers that match a user's
query.
@defun debbugs-get-bugs &rest query
This function returns a list of bug numbers that match the
-@var{query}. @var{query} is a key-value pair sequence, where the key
-is a keyword (symbol) and the value is a string. All queries are
-logically concatenated via AND.
+@var{query}. @var{query} is a sequence of keyword-value pairs where the
+values are strings, i.e. :KEYWORD ``VALUE'' [:KEYWORD ``VALUE'']*
+
+The keyword-value pair is a subquery. The keywords are allowed to
+have multiple occurrence within the query at any place. The
+subqueries with the same keyword form the logical subquery, which
+returns the union of bugs of every subquery it contains.
+
+The result of the @var{query} is an intersection of results of all
+subqueries.
Valid keywords are:
@@ -176,6 +183,9 @@ Valid keywords are:
The value is the name of the package a bug belongs to, like @code{"emacs"},
@code{"coreutils"}, @code{"gnus"}, or @code{"tramp"}.
+@item :src
+This is used to retrieve bugs that belong to source with given name.
+
@item :severity
This is the severity of the bug. The exact set of available severities
depends on the policy of a particular Debbugs port:
@@ -194,8 +204,7 @@ An arbitrary string the bug is annotated with. Usually,
this is used
to mark the status of the bug. The list of possible tags depends on
the Debbugs port.
-Debian port:
-@code{"patch"}, @code{"wontfix"}, @code{"moreinfo"},
+Debian port: @code{"patch"}, @code{"wontfix"}, @code{"moreinfo"},
@code{"unreproducible"}, @code{"fixed"}, @code{"potato"},
@code{"woody"}, @code{"sid"}, @code{"help"}, @code{"security"},
@code{"upstream"}, @code{"pending"}, @code{"sarge"},
@@ -203,11 +212,15 @@ Debian port:
@code{"confirmed"}, @code{"ipv6"}, @code{"lfs"},
@code{"fixed-in-experimental"}, @code{"fixed-upstream"}, @code{"l10n"},
@code{"etch"}, @code{"etch-ignore"}, @code{"lenny"},
-@code{"lenny-ignore"}.
+@code{"lenny-ignore"}, @code{"squeeze"}, @code{"squeeze-ignore"},
+@code{"wheezy"}, @code{"wheezy-ignore"}. The actual list of tags can be
+found on @uref{http://www.debian.org/Bugs/Developer#tags}.
-GNU port:
-@code{"fixed"}, @code{"notabug"}, @code{"wontfix"},
-@code{"unreproducible"}, @code{"moreinfo"}, @code{"patch"}.
+GNU port: @code{"fixed"}, @code{"notabug"}, @code{"wontfix"},
+@code{"unreproducible"}, @code{"moreinfo"}, @code{"patch"},
+@code{"pending"}, @code{"help"}, @code{"security"}, @code{"confirmed"}.
+See @url{http://debbugs.gnu.org/Developer.html#tags} for the actual list
+of tags.
@item :owner
This is used to identify bugs by the owner's email address. The
@@ -220,19 +233,44 @@ With this keyword it is possible to filter bugs by the
submitter's
email address. The special email address @code{"me"} is used as
pattern, replaced with the variable @code{user-mail-address}.
+@item :maint
+This is used to find bugs of the packages which are maintained by the
+person with the given email address. The special email address
+@code{"me"} is used as pattern, replaced with @code{user-mail-address}.
+
+@item :correspondent
+This allows to find bug reports where the person with the given email
+address has participated. The special email address @code{"me"} is used
+as pattern, replaced with @code{user-mail-address}.
+
+@item :affects
+With this keyword it is possible to find bugs which affect the package
+with the given name. The bugs are chosen by the value of field
+@code{affects} in bug's status. The returned bugs do not necessary
+belong to this package.
+
+@item :status
+Status of bug. Valid values are @code{"done"}, @code{"forwarded"} and
+@code{"open"}.
+
@item :archive
-A keyword to filter for bugs which are already archived, or not.
-Valid values are @code{"0"} (not archived), @code{"1"} (archived) or
+A keyword to filter for bugs which are already archived, or not. Valid
+values are @code{"0"} (not archived), @code{"1"} (archived) or
@code{"both"}. If this keyword is not given in the query,
@code{:archive "0"} is assumed by default.
@end table
-Example. Get all bug reports that were initiated by me.
+Example. Get all opened and forwarded release critical bugs for the
+packages which are maintained by @code{"me"} and which have a patch:
@example
-(let ((debbugs-port "gnu.org"))
- (debbugs-get-bugs :submitter "me" :archive "both"))
-@result{} (5516 5551 5645 7259)
+(let ((debbugs-port "debian.org"))
+ (debbugs-get-bugs :maint "me" :tag "patch"
+ :severity "critical"
+ :status "open"
+ :severity "grave"
+ :status "forwarded"
+ :severity "serious"))
@end example
@end defun
- [elpa] externals/debbugs 7f4fc6a 070/311: * debbugs-gnu.el (debbugs-gnu-default-suppress-bugs), (continued)
- [elpa] externals/debbugs 7f4fc6a 070/311: * debbugs-gnu.el (debbugs-gnu-default-suppress-bugs), Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs abc7751 069/311: * debbugs-gnu.el (debbugs-gnu-search): Let-bind, Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 90417e5 056/311: * debbugs-gnu.el (debbugs-gnu-send-control-message): Add "pending" etc., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 5129bba 063/311: * debbugs.texi: New file., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 1ef5eb3 059/311: * debbugs-gnu.el (debbugs-gnu-send-control-message): Add "invalid"., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs d7b7072 060/311: * debbugs-gnu.el (debbugs-gnu-show-reports): Add packages to the status bar., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs f347ec7 066/311: (debbugs-gnu-summary-mode): Make sure `gnus-article-copy' is alive., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 17943cc 072/311: * Debbugs.wsdl (ArrayOfArrayOfAnyType), Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 080565c 074/311: * debbugs-gnu.el (debbugs-gnu-search): Add full text search., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 560f17c 080/311: * debbugs.el (debbugs-get-mbox, debbugs-get-bugs): Fix typos in, Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 298ea80 081/311: * debbugs.texi: Update documentation.,
Stefan Monnier <=
- [elpa] externals/debbugs e56e7b3 083/311: Change default value of `debbugs-gnu-default-severities' to '("important" "normal"), Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs b00d778 087/311: Make sure the buffer isn't read-only before altering., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 5495087 089/311: Allow ignoring matches in From/Subject when narrowing., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs df2ec72 042/311: (debbugs-summary-mode): Remove address@hidden from the list, too., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 1c81865 045/311: * debbugs-gnu.el (debbugs-gnu-*): Rename from `debbugs-*'., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs ba9a8ca 046/311: (debbugs-gnu-send-control-message): Add donenotabug and donewontfix., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs bbe09ae 047/311: (debbugs-gnu-send-control-message): Add doneunreproducible., Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 0c2daec 051/311: * debbugs-gnu.el (debbugs-gnu-sort-state): Give tagged bugs, Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs d189263 054/311: * debbugs.el (debbugs-get-bugs): Weaken syntax for packages (and, Stefan Monnier, 2020/11/29
- [elpa] externals/debbugs 3f67f71 061/311: * debbugs.el (debbugs-get-bugs): Add search keywords :src :maint, Stefan Monnier, 2020/11/29