Re: Org mode issue tracker

[Suvayu Ali <fatkasuvayu+linux@gmail.com>]

Hello Michael,

On Thu, Sep 26, 2013 at 11:34:31AM +0200, Michael Albinus wrote:
> 
> "Sebastien Vauban" <sva-news-D0wtAvR13HarG/iDocfnWg@public.gmane.org>
> writes:
> 
> >>> ((source . "unknown")
> >>>  (found_versions "24.3")
> >>
> >> Emacs version ends up as a tag:
> >>
> >> * TODO  .....                                   :24.3:
> 
> found_versions is optional. So we cannot assume it is always
> set. Furthermore, it is a *list* of strings (although I haven't seen
> ever more than one entry). What to do in this case?

Indeed, I guess this is quite common.  I would think handling this as an
optional tag should suffice.

> >>>  (severity . "normal")
> 
> I would really appreciate, if we could make the severity visible. In the
> org manual, I've read something about A B C priorities. On debbugs, we
> have the severities "serious", "important", "normal", "minor",
> "wishlist", and "tagged". How could we map them on the TODO items? In
> debbugs-gnu we use different faces (colors) for the entries.

You are right!  The default set of priorities are: A, B, and C.  But it
can be extended; see (info "(org) Priorities").

> 
> >>>  (subject . "24.3; org-crypt: Making epg-context local to *epg* while let-bound!")
> >>
> >> * TODO Making epg-context local to *epg* while let-bound! :24.3:org_crypt:
> >>   :PROPERTIES:
> >>   :DEBGUGS_ID:   15081
> >>   :GMANE_URL:
> >> http://mid.gmane.org/877gfqkm9t.fsf-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
> >>   :END:
> >>   <2013-08-13 Tue>
> >>
> >> As you see above, it would be great if we could simplify the suject and
> >> tag the org-module involved (note hyphens are not allowed, they need to
> >> be transformed to underscore).
> 
> OK. However, we cannot assume a given syntax on the subject. An error
> can be reported by a simple mail to @debbugs.gnu.org, with free
> subject. A preformatted subject can be assumed only, if the error has
> been reported by `report-emacs-bug' or `org-submit-bug-report'.

Would it be possible to have some heuristics?  If reported by
report-emacs-bug or org-submit-bug-report, try to extract those tags
from the subject, otherwise ignore them.

> >>>  (pending . "pending")
> >>
> >> And this should finally decide the TODO state.  For the moment a
> >> reasonable mapping would be "pending" -> "TODO".  But would be good to
> >> have support for "DONE", "WIP", or similar (I'm not familiar with all
> >> the debbug states :-p)
> 
> The pending field could have the values "pending", "forwarded" or
> "done". "forwarded" does not seem to be used on debbugs.gnu.org.

> >>>  (tags)
> 
> Tags are useful for more information on the status. They are a list of
> strings like "fixed", "notabug", "wontfix", "unreproducible",
> "moreinfo" or "patch". In the given example, this list is empty.

I have a suggestion to combine the above two.  Assuming we can't have
multiple tags from debbugs, something like below should work.

- "pending" with no tags -> "TODO"
- "done" with no tags -> "DONE"
- I can see the use of "unreproducible", "moreinfo", or "patch" tags
  with "pending" -> "UNREPRODUCIBLE", "MOREINFO", or "PATCH"
- Whereas the other tags, "fixed", "notabug", "wontfix", goes with
  "done".  We can map them to: "DONE", "NOTABUG", "WONTFIX".  As you
  see, I treat "fixed" the same as "done" with no tags.

This can be implemented by "type" TODO keywords.  You basically have 2
states, TODO and DONE.  But there are different kinds of them.

(setq org-todo-keywords
      '((type "TODO(t)" "UNREPRODUCIBLE(u)" "MOREINFO(m)" "PATCH(p)" 
	      "|" "DONE(d)" "NOTABUG(n)" "WONTFIX(w)")))

Here I'm a bit uncertain about the syntax.  Are multiple "DONE" type
keywords allowed?  If not we could split this into sets as follows:

(setq org-todo-keywords
      '((type "TODO(t)" "UNREPRODUCIBLE(u)" "MOREINFO(m)" "PATCH(p)"
              "|" "DONE(d)")
	(sequence "|" "NOTABUG(n)")
	(sequence "|" "WONTFIX(w)")))

WDYT?

> >>>  (package "emacs" "org-mode")
> >>
> >> I guess this is how you filter out org-mode bugs from the rest.
> 
> Yep. In the org-mode case, it is sufficient to filter for the package
> "org-mode". But why not create a todo list for another debbugs project,
> like "emacs" or "gnus" or whatever? And btw, one could filter also for
> other attributes but just package. Even full text search is possible.

Great idea, there could be a defcustom where you assign different org
files for different package tags!

> >> * TODO Making epg-context local to  *epg* while let-bound!     :24.3:org_crypt:
> >>   :PROPERTIES:
> >>   :DEBGUGS_ID:   15081
> >>   :REPORTER:     Thierry Volpiatto <thierry.volpiatto-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
> >>   :GMANE_URL:    http://mid.gmane.org/877gfqkm9t.fsf-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
> >>   :END:
> 
> Yep.
> 
> Now it comes to the attached emails. In a second (!) step, debbugs-gnu
> is able to retrieve the corresponding emails. In the given example, it
> would call (debbugs-get-bug-log 15081) This returns a list like
> 
> (((body . "The body of the message")
>   (msg_num . 5)
>   (attachments)
>   (header . "All header lines of the message")))
> 
> I have just shown one message, of course all messages will be
> retrieved. Alternative, one could retrieve the messages in MBOX format.
> 
> Wouldn't it be nice, if we could include the messages as well? Likely
> not by default (it would be expensive to download all messages for,
> let's say, 500 bugs at once). But we could add a kind of link which,
> when followed, could show the messages as well in org-mode. Somehow.

Since this is possibile, I think my suggestion about GMANE_URL is
redundant.  Dealing with this much more detailed information is a matter
of taste I think.  For example, some like their TODOs to be clean and
simple, with all the details in headline attachments.  Others might like
all the information easily available under the headline formatted as Org
text (text as plain text, email attachments as links).

I think this requires input from the community.  For now as a safe
default you could have each message as a sub-heading of the TODO.

* TODO Making epg-context local to  *epg* while let-bound!     :24.3:org_crypt:
  :PROPERTIES:
  :DEBGUGS_ID:   15081
  :REPORTER:     Thierry Volpiatto <thierry.volpiatto-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
  :END:

** Message 1, From: sender1
Text

[[file:email_attachment]]

** Message 2, From: sender2
Text

[[file:email_attachment]]

Cheers,  :)

-- 
Suvayu

Open source is the future. It sets us free.