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 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.
+composed letters to the particular email 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.
Based on the Debbugs/SOAP service, frontends are written which
offer handling of bugs inside Emacs. These frontends are restricted
These commands retrieve bug reports from the GNU Debbugs server.
'debbugs-gnu' returns a tabulated list, and 'debbugs-org' returns
- a list of TODO items in 'org-mode'. If there were more than
- 'debbugs-gnu-default-hits-per-page' bug results from the query,
- there are widgets ('debbugs-gnu') or links ('debbugs-org') in the
- result buffer for retrieving the other results.
+ a list of TODO items in 'org-mode'. In order not to stress the
+ GNU Debbugs server, the bugs are retrieved in chunks of 500 bugs.
+ However, the bug report buffer shows all retrieved bugs then, in
+ reverse bug number order.
SEVERITIES is a list of strings which filter for the severities
of the bugs to be retrieved. Valid severities are '"serious"',
on the GNU Debbugs server.
SUPPRESS shall also distinct between 'nil' and non-'nil'. When
- non-'nil', closed bugs are suppressed from the results.
+ non-'nil', closed bugs are suppressed from being retrieved from
+ the Debbugs server. Which bugs are regarded as suppressed is
+ configured in the customer option 'debbugs-gnu-suppress-bugs'.
+ Per default, bugs marked as '"done"' are suppressed from being
+ retrieved.
When SEVERITIES contains the severity '"tagged"', TAGS is
consulted in order to restrict the result on bugs which are
customer options 'debbugs-gnu-default-severities' and
'debbugs-gnu-default-packages'.
- When the result would exceed more than 500 bugs, the user is
- asked how many bugs to retrieve at once. This value can be
- configured in the customer option
- 'debbugs-gnu-default-hits-per-page'. However, it is not
- recommended to exceeds the default value.
-
*note Layout:: for the presentation of the results.
-- Command: debbugs-gnu-bugs &rest bugs
A comma-separated list of defined user tags.
'submitter'
- The address of the bug submitter.
+ The email address of the bug submitter.
'date'
A time period the bug has been in which the bug has been
A tabulated list of bug reports consist of four columns for every bug
entry: 'Id' (the bug number), 'State' (some bug attributes),
'Submitter' (the name of the bug submitter), and 'Title' (the bug
-subject). Per default the bugs are sorted by 'Id'; this could be
-changed by clicking in the headline.
-
- Per bug retrieval only up to 500
-('debbugs-gnu-default-hits-per-page') bugs are retrieved and presented
-in a buffer. If there shall be presented more bugs, widgets are
-placed on the top and bottom of the buffer for navigation to further
-report buffers.
+subject). Per default the bugs are sorted descending by 'Id'; this
+could be changed by clicking in the headline.
Different foreground colours present further information on the bug
report. If the bug number uses a red colour ('debbugs-gnu-tagged'),
Restore the full list again after narrowing.
'g' 'debbugs-gnu-rescan'
- Reload all bugs from the GNU Debbugs server.
+ Reload all bugs. With a prefix argument 'C-u', the
+ bug status cache is disabled, and all bug reports are
+ retrieved from the GNU Debbugs server.
'B' 'debbugs-gnu-show-blocking-reports'
'b' 'debbugs-gnu-show-blocked-by-reports'
mapped onto properties of these items. They can be shown by the usual
navigation in 'org-mode'.
- Per bug retrieval only up to 500
-('debbugs-gnu-default-hits-per-page') bugs are retrieved and presented
-in a buffer. At the end of the buffer there is a link, which allows
-to append the next 500 bugs to the list.
-
Bug severities are mapped onto org severities, see
'debbugs-org-severity-priority'.
- The bug report buffers have enabled the minor 'debbugs-gnu-mode'.
+ The bug report buffers have enabled the minor 'debbugs-org-mode'.
This enables the following key strokes:
'<TAB>' 'org-cycle'
The second bug number is read interactively.
+'serious'
'important'
-'minor'
'normal'
-'serious'
+'minor'
'wishlist'
- "severity 12345 important|minor|normal|serious|wishlist"
+ "severity 12345 serious|important|normal|minor|wishlist"
'invalid'
"tags 12345 notabug"
* debbugs-browse-mode: Minor Mode. (line 12)
* debbugs-gnu: Retrieving Bugs. (line 15)
-* debbugs-gnu-bugs: Retrieving Bugs. (line 71)
+* debbugs-gnu-bugs: Retrieving Bugs. (line 69)
* debbugs-gnu-search: Searching Bugs. (line 10)
* debbugs-org: Retrieving Bugs. (line 17)
-* debbugs-org-bugs: Retrieving Bugs. (line 72)
+* debbugs-org-bugs: Retrieving Bugs. (line 70)
* debbugs-org-search: Searching Bugs. (line 11)
\1f
* debbugs-browse-function: Minor Mode. (line 12)
* debbugs-gnu-all-packages: Retrieving Bugs. (line 36)
* debbugs-gnu-all-severities: Retrieving Bugs. (line 27)
-* debbugs-gnu-default-hits-per-page: Retrieving Bugs. (line 63)
-* debbugs-gnu-default-packages: Retrieving Bugs. (line 59)
-* debbugs-gnu-default-severities: Retrieving Bugs. (line 59)
-* debbugs-gnu-mail-backend: Tabulated Lists. (line 75)
+* 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)
\1f
File: debbugs-ug.info, Node: Key Index, Prev: Variable Index, Up: Top
\0\b[index\0\b]
* Menu:
-* '/': Tabulated Lists. (line 42)
-* 'B': Tabulated Lists. (line 56)
-* 'b': Tabulated Lists. (line 57)
-* 'C': Tabulated Lists. (line 70)
-* 'C-c # C': TODO Items. (line 30)
-* 'C-c # d': TODO Items. (line 24)
-* 'C-c # t': TODO Items. (line 27)
-* 'd': Tabulated Lists. (line 39)
-* 'g': Tabulated Lists. (line 53)
-* '<mouse-1>': Tabulated Lists. (line 36)
-* '<mouse-2>': Tabulated Lists. (line 37)
-* 'R': Tabulated Lists. (line 46)
-* '<RET>': Tabulated Lists. (line 35)
-* 's': Tabulated Lists. (line 61)
-* 't': Tabulated Lists. (line 64)
-* '<TAB>': TODO Items. (line 21)
-* 'w': Tabulated Lists. (line 50)
-* 'x': Tabulated Lists. (line 67)
+* '/': 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\7f2634
-Node: Searching Bugs\7f6165
-Ref: Searching Bugs-Footnote-1\7f10044
-Ref: Searching Bugs-Footnote-2\7f10132
-Node: Layout\7f10223
-Node: Tabulated Lists\7f10698
-Node: TODO Items\7f14062
-Node: Control Messages\7f15327
-Node: Minor Mode\7f17638
-Node: Command Index\7f18577
-Node: Variable Index\7f19224
-Node: Key Index\7f19872
+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\7f17239
+Node: Command Index\7f18178
+Node: Variable Index\7f18825
+Node: Key Index\7f19473
\1f
End Tag Table