unofficial mirror of guix-patches@gnu.org 
 help / color / mirror / code / Atom feed
* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
@ 2022-08-05  1:23 Joshua Branson via Guix-patches via
  2022-08-05  1:32 ` Joshua Branson via Guix-patches via
                   ` (4 more replies)
  0 siblings, 5 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-05  1:23 UTC (permalink / raw)
  To: 56987; +Cc: Joshua Branson

New users may find the default debbugs commands a little awkward to use.
This patch provides three new functions and documentation that may ease
them into using debbugs and encourages them to close their open bug
reports.

* etc/guix-debbugs.el (debbugs-guix-search, debbugs-my-open-bugs,
debbugs-get-bug-by-id): new procedures.
* doc/contributing.texi (Debbugs User Interfaces): documented the new
emacs procedures and explained how to modify .emacs.d to use them.
---
 doc/contributing.texi | 57 +++++++++++++++++++++++++++++++++++--
 etc/guix-debbugs.el   | 65 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 120 insertions(+), 2 deletions(-)
 create mode 100644 etc/guix-debbugs.el

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 02c7c5ae59..683b9bd9d2 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -1453,14 +1453,67 @@ issues using @file{debbugs.el}, which you can install with:
 guix install emacs-debbugs
 @end example
 
-For example, to list all open issues on @code{guix-patches}, hit:
+Newcomers may find the default debbugs functions awkward to use.  We
+provide three helper functions that will help you start contributing to
+guix sooner:
+
+@table @asis
+@item @code{M-x debbugs-guix-search}
+to search for guix bugs.
+
+@item @code{M-x debbugs-my-open-bugs}
+to search for your open bug reports.  These are reports that you
+submitted.  Once every six months, run this command, and try to close
+your open bugs.  Or just update the bug report with something like,
+'This is still a bug.  Please do not close this bug.'
+
+@item @code{M-x debbugs-get-bug-by-id}
+to search for bugs by the 5 digit bug number.
+@end table
+
+To start using these guix specific functions, define the variable
+@code{user-mail-address}, and put the following into your
+@code{.emacs.d} (assuming the guix source is located in ~/src/guix/):
+
+@lisp
+(setq user-mail-address "awesomecoder@@gnu.org")
+
+(load-file "~/src/guix/etc/guix-debbugs.el")
+
+(setq smtpmail-smtp-user user-mail-address
+      message-send-mail-function 'smtpmail-send-it
+      send-mail-function 'smtpmail-send-it
+      ;; customize this variable to suit your smtp email server.
+      smtpmail-smtp-server "smtp.gnu.org"
+      ;; customize this variable to suit your email server's port.
+      smtpmail-smtp-service 587)
+@end lisp
+
+Emacs' debbugs interface is awesome, but in order to use it to its
+fullest potential, you need to set up emacs to send email.  Luckily, the
+previous lines of code set up Emacs to use email for you! Now, go ahead
+and test Emacs' email sending ablities via @code{C-x m}.  For testing
+purposes, send a test email to a friend or to yourself.  To send the
+message, type in @code{C-c C-c}.  Emacs will ask you for your email
+password and optionally offer to save it in the unencrypted file
+@code{~/.authinfo}.  If you would rather save the password to an
+encrypted file (@code{~/.authinfo.gpg}), then please see
+@xref{Overview,,, auth, Emacs auth-source} and optionally set up GPG
+@comment I cannot get the below link to work.  Why?
+agent (@xref{gnupg, gnupg, gnupg, Invoking GPG-AGENT}). If you can send
+the email, then you should be all set to use Emacs's debbugs interface!
+
+Finally, we encourage all potential contributers to occassionally review
+some pending patches. There's quite a few!  You can test to see if the
+patch works for you, and reply to the open bug report.  Here is how you
+might get started finding the pending patches:
 
 @example
 @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
 @end example
 
 @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on
-this nifty tool!
+this nifty tool, like how to close, tag, and merge bug reports!
 
 @node Debbugs Usertags
 @subsection Debbugs Usertags
diff --git a/etc/guix-debbugs.el b/etc/guix-debbugs.el
new file mode 100644
index 0000000000..794489b671
--- /dev/null
+++ b/etc/guix-debbugs.el
@@ -0,0 +1,65 @@
+;;; package --- Summary -*- lexical-binding: t; -*-
+;;; guix-debbugs.el Helpful Debbugs Functions for guix
+;;
+;; Copyright (C) 2022 Joshua Branson
+;;
+;; Author: Joshua Branson <jbranso@dismail.de>
+;; Maintainer: Joshua Branson <jbranso@dismail.de>
+;; Created: August 04, 2022
+;; Modified: August 04, 2022
+;; Version: 0.0.1
+;; Keywords: guix debbugs
+;; Homepage: https://git.savannah.gnu.org/git/guix.git
+;; Package-Requires: ((emacs "24.3"))
+;;
+;; This file is not part of GNU Emacs.
+;;
+;;; Commentary:
+;;
+;; The debbugs functions are a little awkward to use.  This file provides
+;; better and easier to use functions for the guix project.  Specifically it
+;; provides two new functions:
+;;
+;; M-x debbugs-guix-search to search for guix bugs
+;; M-x debbugs-my-open-bugs to search for my open bug reports.
+;; M-x debbugs-get-buy-by-id to open a specific bug by its ID.
+;;
+;;; Code:
+
+;; setting up debbugs
+(require 'debbugs-autoloads)
+
+;; Users need to set up send-mail-function.  Otherwise "C" in debbugs-gnu-mode WILL NOT work.
+;; eg:
+;;
+;;     (setq user-mail-address "awesomecoder@gnu.org")
+;;     (load-file "~/src/guix/etc/guix-debbugs.el")
+;;     (setq message-send-mail-function 'smtpmail-send-it
+;;           smtpmail-smtp-user user-mail-address
+;;           ;; customize this variable to suit your smtp email server.
+;;           smtpmail-smtp-server "smtp.gnu.org"
+;;           ;; customize this variable to suit your email server's port.
+;;           smtpmail-smtp-service 587)
+
+;; TODO make this by default only search open bugs AND NOT closed bugs.
+(defun debbugs-guix-search ()
+  (interactive)
+  (debbugs-gnu-search (read-string "Search String: ") nil nil '("guix" "guix-patches") nil))
+
+;; the bugs that I submitted and that are still open
+;; The debbugs database runs once a day.  So after I send a bug report
+;; and run this command, my latest bug report might not be here.  No worries,
+;; just wait one day, and it will be there.  :)
+;;
+;; I have noticed that this function works 80% of the time.  But after I close bug reports,
+;; it seems to stop working for about 1/2 hour.  I'm guessing the server's database
+;; resets itself after every time that I close a bug report...
+(defun debbugs-my-open-bugs ()
+  (require 'debbugs)
+  (interactive)
+  (apply #'debbugs-gnu-bugs (debbugs-get-bugs :submitter "me" :status "open")))
+
+(defalias 'debbugs-get-bug-by-id 'debbugs-gnu-bugs)
+
+(provide 'guix-debbugs)
+;;; guix-debbugs.el ends here

base-commit: d6be56cd09bb6286b51d1efc8981993be2525d87
-- 
2.37.1





^ permalink raw reply related	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-05  1:23 [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
@ 2022-08-05  1:32 ` Joshua Branson via Guix-patches via
  2022-08-10 15:16   ` Joshua Branson via Guix-patches via
  2022-08-10 16:44 ` Michael Albinus
                   ` (3 subsequent siblings)
  4 siblings, 1 reply; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-05  1:32 UTC (permalink / raw)
  To: 56987

Joshua Branson <jbranso@dismail.de> writes:

> New users may find the default debbugs commands a little awkward to use.
> This patch provides three new functions and documentation that may ease
> them into using debbugs and encourages them to close their open bug
> reports.
>

This patch now has an acompany video!

https://video.hardlimit.com/w/gDMR9y2jhB5SkSp8iqEyK8

The video is 13 minutes long, and it explains my motivations for
submitting this patch.  Namely that debbugs can be a little confusing
and hard for new comers to set up.

I also spotted some errors with my debbugs-guix-search function as I was
making the video.  I am not certain what the problem was.  Basically
debbugs-gnu-search found my open wterm related bug, bug
debbugs-guix-search did not.  Weird.

The documentation also helps newbies set up sending email in Emacs,
which is essential to use the emacs' debbugs interface as it was
intended.

I hope others find it helpful!

>
> * etc/guix-debbugs.el (debbugs-guix-search, debbugs-my-open-bugs,
> debbugs-get-bug-by-id): new procedures.
> * doc/contributing.texi (Debbugs User Interfaces): documented the new
> emacs procedures and explained how to modify .emacs.d to use them.
> ---
>  doc/contributing.texi | 57 +++++++++++++++++++++++++++++++++++--
>  etc/guix-debbugs.el   | 65 +++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 120 insertions(+), 2 deletions(-)
>  create mode 100644 etc/guix-debbugs.el
>
> diff --git a/doc/contributing.texi b/doc/contributing.texi
> index 02c7c5ae59..683b9bd9d2 100644
> --- a/doc/contributing.texi
> +++ b/doc/contributing.texi
> @@ -1453,14 +1453,67 @@ issues using @file{debbugs.el}, which you can install with:
>  guix install emacs-debbugs
>  @end example
>  
> -For example, to list all open issues on @code{guix-patches}, hit:
> +Newcomers may find the default debbugs functions awkward to use.  We
> +provide three helper functions that will help you start contributing to
> +guix sooner:
> +
> +@table @asis
> +@item @code{M-x debbugs-guix-search}
> +to search for guix bugs.
> +
> +@item @code{M-x debbugs-my-open-bugs}
> +to search for your open bug reports.  These are reports that you
> +submitted.  Once every six months, run this command, and try to close
> +your open bugs.  Or just update the bug report with something like,
> +'This is still a bug.  Please do not close this bug.'
> +
> +@item @code{M-x debbugs-get-bug-by-id}
> +to search for bugs by the 5 digit bug number.
> +@end table
> +
> +To start using these guix specific functions, define the variable
> +@code{user-mail-address}, and put the following into your
> +@code{.emacs.d} (assuming the guix source is located in ~/src/guix/):
> +
> +@lisp
> +(setq user-mail-address "awesomecoder@@gnu.org")
> +
> +(load-file "~/src/guix/etc/guix-debbugs.el")
> +
> +(setq smtpmail-smtp-user user-mail-address
> +      message-send-mail-function 'smtpmail-send-it
> +      send-mail-function 'smtpmail-send-it
> +      ;; customize this variable to suit your smtp email server.
> +      smtpmail-smtp-server "smtp.gnu.org"
> +      ;; customize this variable to suit your email server's port.
> +      smtpmail-smtp-service 587)
> +@end lisp
> +
> +Emacs' debbugs interface is awesome, but in order to use it to its
> +fullest potential, you need to set up emacs to send email.  Luckily, the
> +previous lines of code set up Emacs to use email for you! Now, go ahead
> +and test Emacs' email sending ablities via @code{C-x m}.  For testing
> +purposes, send a test email to a friend or to yourself.  To send the
> +message, type in @code{C-c C-c}.  Emacs will ask you for your email
> +password and optionally offer to save it in the unencrypted file
> +@code{~/.authinfo}.  If you would rather save the password to an
> +encrypted file (@code{~/.authinfo.gpg}), then please see
> +@xref{Overview,,, auth, Emacs auth-source} and optionally set up GPG
> +@comment I cannot get the below link to work.  Why?
> +agent (@xref{gnupg, gnupg, gnupg, Invoking GPG-AGENT}). If you can send
> +the email, then you should be all set to use Emacs's debbugs interface!
> +
> +Finally, we encourage all potential contributers to occassionally review
> +some pending patches. There's quite a few!  You can test to see if the
> +patch works for you, and reply to the open bug report.  Here is how you
> +might get started finding the pending patches:
>  
>  @example
>  @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
>  @end example
>  
>  @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on
> -this nifty tool!
> +this nifty tool, like how to close, tag, and merge bug reports!
>  
>  @node Debbugs Usertags
>  @subsection Debbugs Usertags
> diff --git a/etc/guix-debbugs.el b/etc/guix-debbugs.el
> new file mode 100644
> index 0000000000..794489b671
> --- /dev/null
> +++ b/etc/guix-debbugs.el
> @@ -0,0 +1,65 @@
> +;;; package --- Summary -*- lexical-binding: t; -*-
> +;;; guix-debbugs.el Helpful Debbugs Functions for guix
> +;;
> +;; Copyright (C) 2022 Joshua Branson
> +;;
> +;; Author: Joshua Branson <jbranso@dismail.de>
> +;; Maintainer: Joshua Branson <jbranso@dismail.de>
> +;; Created: August 04, 2022
> +;; Modified: August 04, 2022
> +;; Version: 0.0.1
> +;; Keywords: guix debbugs
> +;; Homepage: https://git.savannah.gnu.org/git/guix.git
> +;; Package-Requires: ((emacs "24.3"))
> +;;
> +;; This file is not part of GNU Emacs.
> +;;
> +;;; Commentary:
> +;;
> +;; The debbugs functions are a little awkward to use.  This file provides
> +;; better and easier to use functions for the guix project.  Specifically it
> +;; provides two new functions:
> +;;
> +;; M-x debbugs-guix-search to search for guix bugs
> +;; M-x debbugs-my-open-bugs to search for my open bug reports.
> +;; M-x debbugs-get-buy-by-id to open a specific bug by its ID.
> +;;
> +;;; Code:
> +
> +;; setting up debbugs
> +(require 'debbugs-autoloads)
> +
> +;; Users need to set up send-mail-function.  Otherwise "C" in debbugs-gnu-mode WILL NOT work.
> +;; eg:
> +;;
> +;;     (setq user-mail-address "awesomecoder@gnu.org")
> +;;     (load-file "~/src/guix/etc/guix-debbugs.el")
> +;;     (setq message-send-mail-function 'smtpmail-send-it
> +;;           smtpmail-smtp-user user-mail-address
> +;;           ;; customize this variable to suit your smtp email server.
> +;;           smtpmail-smtp-server "smtp.gnu.org"
> +;;           ;; customize this variable to suit your email server's port.
> +;;           smtpmail-smtp-service 587)
> +
> +;; TODO make this by default only search open bugs AND NOT closed bugs.
> +(defun debbugs-guix-search ()
> +  (interactive)
> +  (debbugs-gnu-search (read-string "Search String: ") nil nil '("guix" "guix-patches") nil))
> +
> +;; the bugs that I submitted and that are still open
> +;; The debbugs database runs once a day.  So after I send a bug report
> +;; and run this command, my latest bug report might not be here.  No worries,
> +;; just wait one day, and it will be there.  :)
> +;;
> +;; I have noticed that this function works 80% of the time.  But after I close bug reports,
> +;; it seems to stop working for about 1/2 hour.  I'm guessing the server's database
> +;; resets itself after every time that I close a bug report...
> +(defun debbugs-my-open-bugs ()
> +  (require 'debbugs)
> +  (interactive)
> +  (apply #'debbugs-gnu-bugs (debbugs-get-bugs :submitter "me" :status "open")))
> +
> +(defalias 'debbugs-get-bug-by-id 'debbugs-gnu-bugs)
> +
> +(provide 'guix-debbugs)
> +;;; guix-debbugs.el ends here
>
> base-commit: d6be56cd09bb6286b51d1efc8981993be2525d87




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-05  1:32 ` Joshua Branson via Guix-patches via
@ 2022-08-10 15:16   ` Joshua Branson via Guix-patches via
  0 siblings, 0 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-10 15:16 UTC (permalink / raw)
  To: 56987

Joshua Branson <jbranso@dismail.de> writes:

I emailed the help-gnu-emacs list, to try ask how I would write a
function to only get open guix bugs and got back a pretty good reply. I
am just reposting those messages here:

>> But you can play with the QUERY argument of
>> debbugs-gnu-search, like  (this will get you only open bugs)
>>
>> (debbugs-gnu-search (read-string "Search String: ") '((pending . "open")) nil '("guix" "guix-patches"))

> Are you sure that works?
>
> (debbugs-gnu-search "wterm" '((status . "open")) nil '("guix" "guix-patches"))
>
> returns nothing
>
> (debbugs-gnu-search "wterm" '((pending . "open")) nil '("guix" "guix-patches"))
>
> returns nothing
>
> (debbugs-gnu-search "wterm"  nil nil '("guix" "guix-patches"))
>
> returns only closed bugs.  odd.
>
> M-x debbugs-gnu-search RET "wterm" RET RET x
>
> correctly returns bug 56965, which is an open bug.
>
> What am I doing wrong?

Michael Albinus <michael.albinus@gmx.de> writes:

Hi Joshua,

Well, I found the time now to check what's up.

> Hmm, looks like there's an error in debbugs-gnu-search. I'll check, but
> perhaps you might write a bug report about. I don't know whether I can
> handle it just now, due to time constraints.

There's indeed an error. The "status" attribute, when there is non-empty
query string, must be "pending" instead of "open". And it is mapped
internally to the attribute "pending".

All this shouldn't worry you. I've just pushed debbugs 0.33, which will appear
in a couple of hours on GNU ELPA. For the time being, you can apply

(debbugs-gnu-search "wterm" '((pending . "pending")) nil '("guix" "guix-patches"))

If you want to see only closed bugs, then call

(debbugs-gnu-search "wterm" '((pending . "done")) nil '("guix" "guix-patches"))

And if you want to see all bugs with this search string, there is

(debbugs-gnu-search "wterm" nil nil '("guix" "guix-patches"))

Best regards, Michael.


So I will be resubmitting this patch set, with a debbugs-guix-search
function that by default only returns open bug reports.

Thanks,

Joshua




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-05  1:23 [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
  2022-08-05  1:32 ` Joshua Branson via Guix-patches via
@ 2022-08-10 16:44 ` Michael Albinus
  2022-08-10 20:10 ` jbranso--- via Guix-patches via
                   ` (2 subsequent siblings)
  4 siblings, 0 replies; 23+ messages in thread
From: Michael Albinus @ 2022-08-10 16:44 UTC (permalink / raw)
  To: Joshua Branson; +Cc: 56987

Joshua Branson <jbranso@dismail.de> writes:

Hi Joshua,

just some comments after short reading of the patch.

>  @example
>  @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
>  @end example

Alternatively, a user could set debbugs-gnu-default-packages to '("guix" "guix-patches")
Then it won't be necessary to enter the package name(s) again and again.

> +;; Copyright (C) 2022 Joshua Branson

This would change to FSF, if bundled with the debbugs package.

> +;; Package-Requires: ((emacs "24.3"))

debbugs.el says

;; Package-Requires: ((emacs "26.1") (soap-client "3.1.5"))

So I guess you might lift up the required Emacs version.

> +;; TODO make this by default only search open bugs AND NOT closed bugs.
> +(defun debbugs-guix-search ()
> +  (interactive)
> +  (debbugs-gnu-search (read-string "Search String: ") nil nil '("guix" "guix-patches") nil))

As said the other message, it should be

(debbugs-gnu-search (read-string "Search String: ") '((pending . "pending")) nil '("guix" "guix-patches"))

> +;; The debbugs database runs once a day.  So after I send a bug report
> +;; and run this command, my latest bug report might not be here.  No worries,
> +;; just wait one day, and it will be there.  :)

To be more precise, the Hyperestraier search engine on debbugs.gnu.org
makes new indices after that period. New submitted bugs are in the
debbugs database shortly after sending the message. It is just
debbugs-gnu-search, which needs these indices.

> +;; I have noticed that this function works 80% of the time.  But after I close bug reports,
> +;; it seems to stop working for about 1/2 hour.  I'm guessing the server's database
> +;; resets itself after every time that I close a bug report...

debbugs.el uses a cache, which flushes the value after an hour. See the
variable debbugs-cache-expiry.

There is the command debbugs-gnu-rescan, bound to key "g", which rescans
an existing tabulated list. With a prefix argument ("C-u g"), the cache
is ignored, and the data are retrieved directly from debbugs.gnu.el.

However, please be cautious with invalidating the cache. Every action on
the debbugs.gnu.org server causes a workload there, and we don't want to
overuse it.

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-05  1:23 [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
  2022-08-05  1:32 ` Joshua Branson via Guix-patches via
  2022-08-10 16:44 ` Michael Albinus
@ 2022-08-10 20:10 ` jbranso--- via Guix-patches via
  2022-08-10 20:24   ` Maxime Devos
                     ` (3 more replies)
  2022-10-01 15:39 ` [bug#56987] [PATCH] added *my-open-bugs functions Joshua Branson via Guix-patches via
  2022-10-05 16:41 ` [bug#56987] [PATCH] new functions 'debbugs-gnu-my-open-bugs' and 'debbugs-gnu-guix-search' Joshua Branson via Guix-patches via
  4 siblings, 4 replies; 23+ messages in thread
From: jbranso--- via Guix-patches via @ 2022-08-10 20:10 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987

Sorry for top posting...

The emacs debbugs developers are considering to merge this patch to debbugs directly.

I am willing to submit copyright assignment to GNU/FSF.  It looks like the FSF
has a webpage that may make this process easier:

https://sfconservancy.org/assignment/

Should I use that web page to submit my potential copyright assignment?

Now that we are all on the same page:  

August 10, 2022 12:45 PM, "Michael Albinus" <michael.albinus@gmx.de> wrote:

> Joshua Branson <jbranso@dismail.de> writes:
> 
> Hi Joshua,
> 
> just some comments after short reading of the patch.
> 
>> @example
>> @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
>> @end example
> 
> Alternatively, a user could set debbugs-gnu-default-packages to '("guix" "guix-patches")
> Then it won't be necessary to enter the package name(s) again and again.

I think that I have tried that in my config, and I could not get it to work.

I will try again and get back to you, and update the guix documentation accordingly.

> 
>> +;; Copyright (C) 2022 Joshua Branson
> 
> This would change to FSF, if bundled with the debbugs package.

Will change

> 
>> +;; Package-Requires: ((emacs "24.3"))
> 
> debbugs.el says
> 
> ;; Package-Requires: ((emacs "26.1") (soap-client "3.1.5"))
> 
> So I guess you might lift up the required Emacs version.

Will do.

> 
>> +;; TODO make this by default only search open bugs AND NOT closed bugs.
>> +(defun debbugs-guix-search ()
>> + (interactive)
>> + (debbugs-gnu-search (read-string "Search String: ") nil nil '("guix" "guix-patches") nil))
> 
> As said the other message, it should be
> 
> (debbugs-gnu-search (read-string "Search String: ") '((pending . "pending")) nil '("guix"
> "guix-patches"))

Will change

> 
>> +;; The debbugs database runs once a day. So after I send a bug report
>> +;; and run this command, my latest bug report might not be here. No worries,
>> +;; just wait one day, and it will be there. :)
> 
> To be more precise, the Hyperestraier search engine on debbugs.gnu.org
> makes new indices after that period. New submitted bugs are in the
> debbugs database shortly after sending the message. It is just
> debbugs-gnu-search, which needs these indices.

Will change

> 
>> +;; I have noticed that this function works 80% of the time. But after I close bug reports,
>> +;; it seems to stop working for about 1/2 hour. I'm guessing the server's database
>> +;; resets itself after every time that I close a bug report...
> 
> debbugs.el uses a cache, which flushes the value after an hour. See the
> variable debbugs-cache-expiry.

Maybe, we could mark a bug as done in the cache when one closes the bug via
debbugs.  That may be a little above my paygrade though.

> 
> There is the command debbugs-gnu-rescan, bound to key "g", which rescans
> an existing tabulated list. With a prefix argument ("C-u g"), the cache
> is ignored, and the data are retrieved directly from debbugs.gnu.el.
> 
> However, please be cautious with invalidating the cache. Every action on
> the debbugs.gnu.org server causes a workload there, and we don't want to
> overuse it.
> 
> Best regards, Michael.


I will resubmit this with the goal of merging directly into debbugs.el.

And I am off tomorrow, so I should have some time to do so!




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-10 20:10 ` jbranso--- via Guix-patches via
@ 2022-08-10 20:24   ` Maxime Devos
  2022-08-10 20:39   ` jbranso--- via Guix-patches via
                     ` (2 subsequent siblings)
  3 siblings, 0 replies; 23+ messages in thread
From: Maxime Devos @ 2022-08-10 20:24 UTC (permalink / raw)
  To: jbranso, Michael Albinus; +Cc: 56987


[-- Attachment #1.1.1: Type: text/plain, Size: 1017 bytes --]


On 10-08-2022 22:10, jbranso--- via Guix-patches via wrote:
> I am willing to submit copyright assignment to GNU/FSF.  It looks like the FSF
> has a webpage that may make this process easier:
>
> https://sfconservancy.org/assignment/

GNU and FSF are separate (but related!) entities, they aren't synonyms. 
For example, I do some things in GNU (in mu case: GNUnet, Guix and Guix) 
but I'm not involved with FSF at all, except for asking a question once 
or twice of FSF people.

Also, the Software Freedom Conservancy is a different organisation than 
the FSF. You will need a different assignment form, contact the 
emacs-debbugs people for details.

I haven't been following 56987 100%, but a remark:

Guix does not require copyright assignment. Copyright assignment is only 
required if you sent changes to Emacs or emacs-debbugs upstream instead 
of a local Guix patch or file. That would something to discuss with 
Emacs or emacs-debbugs people though, not Guix.

Greetings,
Maxime.


[-- Attachment #1.1.2: OpenPGP public key --]
[-- Type: application/pgp-keys, Size: 929 bytes --]

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 236 bytes --]

^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-10 20:10 ` jbranso--- via Guix-patches via
  2022-08-10 20:24   ` Maxime Devos
@ 2022-08-10 20:39   ` jbranso--- via Guix-patches via
  2022-08-10 21:22   ` [bug#56987] Requesting help in assigning copright to Emacs's debbugs jbranso--- via Guix-patches via
  2022-08-11  6:24   ` Michael Albinus
  3 siblings, 0 replies; 23+ messages in thread
From: jbranso--- via Guix-patches via @ 2022-08-10 20:39 UTC (permalink / raw)
  To: Maxime Devos, Michael Albinus, Lars Ingebrigtsen; +Cc: 56987

August 10, 2022 4:24 PM, "Maxime Devos" <maximedevos@telenet.be> wrote:

> On 10-08-2022 22:10, jbranso--- via Guix-patches via wrote:
> 
>> I am willing to submit copyright assignment to GNU/FSF. It looks like the FSF
>> has a webpage that may make this process easier:
>> 
>> https://sfconservancy.org/assignment
> 
> GNU and FSF are separate (but related!) entities, they aren't synonyms.
> For example, I do some things in GNU (in mu case: GNUnet, Guix and Guix)
> but I'm not involved with FSF at all, except for asking a question once
> or twice of FSF people.

Thanks for the clarification!

> Also, the Software Freedom Conservancy is a different organization than
> the FSF. You will need a different assignment form, contact the
> emacs-debbugs people for details.

Ah, you're right! from
https://sfconservancy.org/news/2022/may/02/conservancy-launches-copyright-assignment-system

"The self-service system enables developers to entrust their copyrights
to Software Freedom Conservancy, ..."  NOT the FSF.  Bummer.

> I haven't been following 56987 100%, but a remark:
> 
> Guix does not require copyright assignment. Copyright assignment is only
> required if you sent changes to Emacs or emacs-debbugs upstream instead
> of a local Guix patch or file. That would something to discuss with
> Emacs or emacs-debbugs people though, not Guix.

That's what I mentioned in the above previous email.  

Some emacs-debbugs contributors have expressed an interest in adding in my
patch to debbugs.el directly.  They would require an assignment to the FSF. 
:)

Which thanks to Maxime, I now know that I have to email the FSF!

Also thanks for the reminder Maxime. I am adding Lars to the email chain. 
He's a co-author of debbugs I believe.

> Greetings,
> Maxime.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] Requesting help in assigning copright to Emacs's debbugs
  2022-08-10 20:10 ` jbranso--- via Guix-patches via
  2022-08-10 20:24   ` Maxime Devos
  2022-08-10 20:39   ` jbranso--- via Guix-patches via
@ 2022-08-10 21:22   ` jbranso--- via Guix-patches via
  2022-08-11 19:51     ` [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
       [not found]     ` <304e6f0d877d6b8bb60db051e661edf1@dismail.de>
  2022-08-11  6:24   ` Michael Albinus
  3 siblings, 2 replies; 23+ messages in thread
From: jbranso--- via Guix-patches via @ 2022-08-10 21:22 UTC (permalink / raw)
  To: craigt, assign; +Cc: Lars Ingebrigtsen, Michael Albinus, 56987

Hey Craig,

With Michael's help (Michael did most of the work really), I wrote
some code that may be useful to emacs's debbugs mode:

https://elpa.gnu.org/packages/debbugs.html

The pending patch is available for your viewing pleasure at:

https://issues.guix.gnu.org/56987

I have never submitted copyright assignment to GNU before.  
Is it possible I can just submit copyright to all GNU programs 
in one fell swoop?

I currently work for a global corporation that is NOT in the
software industry, thought they do own some proprietary software.

Do I need to get them to sign off on this too?

Thanks,

Joshua




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-10 20:10 ` jbranso--- via Guix-patches via
                     ` (2 preceding siblings ...)
  2022-08-10 21:22   ` [bug#56987] Requesting help in assigning copright to Emacs's debbugs jbranso--- via Guix-patches via
@ 2022-08-11  6:24   ` Michael Albinus
  2022-08-11 15:25     ` Joshua Branson via Guix-patches via
  3 siblings, 1 reply; 23+ messages in thread
From: Michael Albinus @ 2022-08-11  6:24 UTC (permalink / raw)
  To: jbranso; +Cc: 56987, Lars Ingebrigtsen

jbranso@dismail.de writes:

Hi Joshua,

> I am willing to submit copyright assignment to GNU/FSF.  It looks like the FSF
> has a webpage that may make this process easier:
>
> https://sfconservancy.org/assignment/
>
> Should I use that web page to submit my potential copyright assignment?

No, you need the FSF template. Sent offlist.

>>> @example
>>> @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
>>> @end example
>>
>> Alternatively, a user could set debbugs-gnu-default-packages to '("guix" "guix-patches")
>> Then it won't be necessary to enter the package name(s) again and again.
>
> I think that I have tried that in my config, and I could not get it to work.
>
> I will try again and get back to you, and update the guix documentation accordingly.

Well, debbugs-gnu-default-packages isn't used for
debbugs-gnu-search. But since you are writing about the debbugs package
in general, the hint might still be useful.

>> debbugs.el uses a cache, which flushes the value after an hour. See the
>> variable debbugs-cache-expiry.
>
> Maybe, we could mark a bug as done in the cache when one closes the bug via
> debbugs.  That may be a little above my paygrade though.

That's a hazardous way. Bugs are not only closed, but changed in many
ways. And you don't know, whether a user sends the control message she
has started to compose.

In debbugs-gnu-make-control-message, a bug is already removed from the
cache when the control message is sent. This is good enough I believe.

Next time the bug data are needed, the data for this bug are fetched
from the server. However, you must be a little bit patient, when you
retrieve the data immediately after sending the control message, the
server might not be ready with the action, and it might send the
unchanged data.

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-11  6:24   ` Michael Albinus
@ 2022-08-11 15:25     ` Joshua Branson via Guix-patches via
  2022-08-11 16:06       ` Michael Albinus
  2022-08-12 19:17       ` jbranso--- via Guix-patches via
  0 siblings, 2 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-11 15:25 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987, Lars Ingebrigtsen

Michael Albinus <michael.albinus@gmx.de> writes:

> jbranso@dismail.de writes:
>
> Hi Joshua,
>
>> I am willing to submit copyright assignment to GNU/FSF.  It looks like the FSF
>> has a webpage that may make this process easier:
>>
>> https://sfconservancy.org/assignment/
>>
>> Should I use that web page to submit my potential copyright assignment?
>
> No, you need the FSF template. Sent offlist.
>
>>>> @example
>>>> @kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y
>>>> @end example
>>>
>>> Alternatively, a user could set debbugs-gnu-default-packages to '("guix" "guix-patches")
>>> Then it won't be necessary to enter the package name(s) again and again.
>>
>> I think that I have tried that in my config, and I could not get it to work.
>>
>> I will try again and get back to you, and update the guix documentation accordingly.
>
> Well, debbugs-gnu-default-packages isn't used for
> debbugs-gnu-search. But since you are writing about the debbugs package
> in general, the hint might still be useful.

May I ask why debbugs-gnu-search chooses not to use
debbugs-gnu-default-packages?  I don't understand.   What functions do
use debbugs-gnu-default-packages?  Also note, that my experience with
debbugs is REALLY minimal.  I haven't even properly read the
manual...I've only skimmed.  So maybe I should read it before developing
an opinion.  :)

>>> debbugs.el uses a cache, which flushes the value after an hour. See the
>>> variable debbugs-cache-expiry.
>>
>> Maybe, we could mark a bug as done in the cache when one closes the bug via
>> debbugs.  That may be a little above my paygrade though.
>
> That's a hazardous way. Bugs are not only closed, but changed in many
> ways. And you don't know, whether a user sends the control message she
> has started to compose.

That's true.  

> In debbugs-gnu-make-control-message, a bug is already removed from the
> cache when the control message is sent. This is good enough I believe.

Now that is helpful!  so debbugs-gnu-make-control-message assumes that
you are closing the bug.  ok.  Thanks for the help again Michael!  I
couldn't have written this patch this quickly without your help.  Heck
you helped me write quite a bit of it!

> Next time the bug data are needed, the data for this bug are fetched
> from the server. However, you must be a little bit patient, when you
> retrieve the data immediately after sending the control message, the
> server might not be ready with the action, and it might send the
> unchanged data.
>
> Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-11 15:25     ` Joshua Branson via Guix-patches via
@ 2022-08-11 16:06       ` Michael Albinus
  2022-08-13 22:49         ` Joshua Branson via Guix-patches via
  2022-08-12 19:17       ` jbranso--- via Guix-patches via
  1 sibling, 1 reply; 23+ messages in thread
From: Michael Albinus @ 2022-08-11 16:06 UTC (permalink / raw)
  To: Joshua Branson; +Cc: 56987, Lars Ingebrigtsen

Joshua Branson <jbranso@dismail.de> writes:

Hi Joshua,

> May I ask why debbugs-gnu-search chooses not to use
> debbugs-gnu-default-packages?  I don't understand.

debbugs-gnu-search is not designed to be used with packages. It is
possible to do so, but by default it just looks for a search string, w/o
any further restriction.

> What functions do use debbugs-gnu-default-packages?

debbugs-gnu, and the commands which use it internally, like
debbugs-gnu-patches, debbugs-gnu-package.

>> In debbugs-gnu-make-control-message, a bug is already removed from the
>> cache when the control message is sent. This is good enough I believe.
>
> Now that is helpful!  so debbugs-gnu-make-control-message assumes that
> you are closing the bug.

No, it doesn't. A bug can be changed in many ways, not only being closed.
debbugs-gnu-make-control-message assumes only that you change something
with the bug.

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-10 21:22   ` [bug#56987] Requesting help in assigning copright to Emacs's debbugs jbranso--- via Guix-patches via
@ 2022-08-11 19:51     ` Joshua Branson via Guix-patches via
       [not found]     ` <304e6f0d877d6b8bb60db051e661edf1@dismail.de>
  1 sibling, 0 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-11 19:51 UTC (permalink / raw)
  To: craigt; +Cc: 56987

jbranso@dismail.de writes:

Just an FYI, Craig already got back to me!  It took him 1 day to respond
to my email!  Way to go copyright licensing guy!

Thanks,

Joshua




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-11 15:25     ` Joshua Branson via Guix-patches via
  2022-08-11 16:06       ` Michael Albinus
@ 2022-08-12 19:17       ` jbranso--- via Guix-patches via
  1 sibling, 0 replies; 23+ messages in thread
From: jbranso--- via Guix-patches via @ 2022-08-12 19:17 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987, craigt

FYI, Craig the licensing guy got back to me, 
and I submitted my copyright form for GNU Emacs.

Craig is wicked fast!  He helped me submit my copyright before
the patched were even ready!

That guys deserves a raise, a paid 6 month vacation, and a new puppy!
I'm pretty sure he's the kind of man to run into a burning building
to save all of the kittens.  

Thanks Craig!

Joshua




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-11 16:06       ` Michael Albinus
@ 2022-08-13 22:49         ` Joshua Branson via Guix-patches via
  0 siblings, 0 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-13 22:49 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987


For all interested parties, I am working on the patch to debbugs, and I
am recording myself coding doing it.  I've got sooo much to learn about
git!

Woo hoo!

https://video.hardlimit.com/my-library/video-playlists/ee13680a-b33c-4bc7-9794-973737d37d03

Thanks,

Joshua




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] Fwd: [gnu.org #1863422] Joshua Allen Branson GNU EMACS
       [not found]     ` <304e6f0d877d6b8bb60db051e661edf1@dismail.de>
@ 2022-08-17 20:14       ` jbranso--- via Guix-patches via
  2022-08-18  9:52         ` Michael Albinus
  0 siblings, 1 reply; 23+ messages in thread
From: jbranso--- via Guix-patches via @ 2022-08-17 20:14 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987

[-- Attachment #1: Type: text/plain, Size: 423 bytes --]

My copyright is now on file with the FSF for GNU Emacs!

Now I just need to make V2 of my patches.

Sorry it's taking me so long.

Thanks,

Joshua

-------- Forwarded message -------
From: "Craig Topham via RT" <copyright-clerk@fsf.org>
To: jbranso@dismail.de
Sent: August 17, 2022 4:25 PM
Subject: [gnu.org #1863422] Joshua Allen Branson GNU EMACS
Please find the attached PDF. Thank you for contributing.

[-- Attachment #2: Branson.1863422.GNU.EMACS.pdf --]
[-- Type: application/pdf, Size: 4091249 bytes --]

^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] Fwd: [gnu.org #1863422] Joshua Allen Branson GNU EMACS
  2022-08-17 20:14       ` [bug#56987] Fwd: [gnu.org #1863422] Joshua Allen Branson GNU EMACS jbranso--- via Guix-patches via
@ 2022-08-18  9:52         ` Michael Albinus
  2022-08-22 17:21           ` [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
  0 siblings, 1 reply; 23+ messages in thread
From: Michael Albinus @ 2022-08-18  9:52 UTC (permalink / raw)
  To: jbranso; +Cc: 56987

jbranso@dismail.de writes:

Hi Joshua,

> My copyright is now on file with the FSF for GNU Emacs!

Indeed, I've seen this on file there. Congratulations!

The assignment is just for Emacs (I remember you wanted it for any GNU
package). No problem for me, working on debbugs is covered by this.

> Now I just need to make V2 of my patches.
>
> Sorry it's taking me so long.

Take your time, there's no rush.

> Thanks,
>
> Joshua

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] etc: guix-debbugs.el: new file.
  2022-08-18  9:52         ` Michael Albinus
@ 2022-08-22 17:21           ` Joshua Branson via Guix-patches via
  0 siblings, 0 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-08-22 17:21 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987

Michael Albinus <michael.albinus@gmx.de> writes:

>
> Take your time, there's no rush.
>

Video update:

https://video.hardlimit.com/w/p/vp7WF6rjXr4ZAF1sitHmUT?playlistPosition=3&resume=true

Just letting people know that I am making progress slowly.

>
>> Thanks,
>>
>> Joshua
>
> Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] added *my-open-bugs functions
  2022-08-05  1:23 [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
                   ` (2 preceding siblings ...)
  2022-08-10 20:10 ` jbranso--- via Guix-patches via
@ 2022-10-01 15:39 ` Joshua Branson via Guix-patches via
  2022-10-02 12:52   ` Michael Albinus
  2022-10-03 20:02   ` jbranso--- via Guix-patches via
  2022-10-05 16:41 ` [bug#56987] [PATCH] new functions 'debbugs-gnu-my-open-bugs' and 'debbugs-gnu-guix-search' Joshua Branson via Guix-patches via
  4 siblings, 2 replies; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-10-01 15:39 UTC (permalink / raw)
  To: 56987; +Cc: michael.albinus, Joshua Branson

* debbugs-gnu.el: debbugs-gnu-my-open-bugs: new procedure.
* debbugs-org.el: debbugs-org-my-open-bugs: new procedure.
* debbugs-guix.el: debbugs-gnu-guix-search: new procedure.
* debugs-ug.texi: added documentation for *my-open-bugs procedures.

I did not actually compile the debbugs-ug.text, so it is possible that my 
documentation makes the info program impossible to compile.  

Also sorry for the massive delay it has been in sending this in.

Thanks,

Joshua   
---
 debbugs-gnu.el  |  9 +++++++++
 debbugs-guix.el | 42 ++++++++++++++++++++++++++++++++++++++++++
 debbugs-org.el  |  8 ++++++++
 debbugs-ug.texi | 13 ++++++++++++-
 4 files changed, 71 insertions(+), 1 deletion(-)
 create mode 100644 debbugs-guix.el

diff --git a/debbugs-gnu.el b/debbugs-gnu.el
index e6629156c1..29257cb779 100644
--- a/debbugs-gnu.el
+++ b/debbugs-gnu.el
@@ -827,6 +827,13 @@ Shall be bound in `debbugs-org-*' functions.")
     (when (called-interactively-p 'interactive)
       (message "Query finished"))))
 
+;;;###autoload
+(defun debbugs-gnu-my-open-bugs ()
+  "Retrieve the open bugs, that you submitted.  This function assumes the variable
+'user-mail-address' is defined."
+  (interactive)
+  (apply #'debbugs-gnu-bugs (debbugs-get-bugs :submitter "me" :status "open")))
+
 (defun debbugs-gnu-get-bugs (query)
   "Retrieve bug numbers from debbugs.gnu.org according search criteria."
   (let* ((debbugs-port "gnu.org")
@@ -2479,6 +2486,8 @@ or bug ranges, with default to `debbugs-gnu-default-bug-number-list'."
   (when (called-interactively-p 'interactive)
     (message "Retrieving bugs finished")))
 
+(defalias 'debbugs-gnu-get-bug-by-id 'debbugs-gnu-bugs)
+
 (defcustom debbugs-gnu-trunk-directory "~/src/emacs/trunk/"
   "The directory where the main source tree lives."
   :type 'directory
diff --git a/debbugs-guix.el b/debbugs-guix.el
new file mode 100644
index 0000000000..6f7cfe46e4
--- /dev/null
+++ b/debbugs-guix.el
@@ -0,0 +1,42 @@
+;;; debbugs-guix.el Guix Specific Debbugs Functions -*- lexical-binding: t; -*-
+;;
+;; Copyright (C) 2011-2022 Free Software Foundation, Inc.
+
+;; Author: Joshua Branson <jbranso@dismail.de>
+;; Keywords: comm, hypermedia, maint
+;; Package: debbugs
+
+;; This file is not part of GNU Emacs.
+
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;
+;; By default, debbugs-gnu-search searches for open and closed bugs of
+;; all GNU packages, which can make searching a little slow.  To
+;; remedy this situation, this file provides the function
+;; 'debbugs-gnu-guix-search', which search for open bugs that relate
+;; to the GNU guix.
+;;
+;;; Code:
+
+;;;###autoload
+(defun debbugs-gnu-guix-search ()
+  "Search for open guix bugs and patches."
+  (interactive)
+  (debbugs-gnu-search (read-string "Search String: ") '((pending . "pending"))
+                      nil '("guix" "guix-patches") nil))
+
+(provide 'debbugs-guix)
+;;; debbugs-guix.el ends here
diff --git a/debbugs-org.el b/debbugs-org.el
index c4343ecd8e..33b3662219 100644
--- a/debbugs-org.el
+++ b/debbugs-org.el
@@ -352,6 +352,14 @@ or bug ranges, with default to `debbugs-gnu-default-bug-number-list'."
   (let ((debbugs-gnu-show-reports-function #'debbugs-org-show-reports))
     (call-interactively #'debbugs-gnu-bugs)))
 
+;;;###autoload
+(defun debbugs-org-my-open-bugs ()
+  "Retrieve the open bugs, that you submitted.  This function assumes the variable
+'user-mail-address' is defined."
+  (interactive)
+  (let ((debbugs-gnu-show-reports-function #'debbugs-org-show-reports))
+    (apply #'debbugs-gnu-bugs (debbugs-get-bugs :submitter "me" :status "open"))))
+
 ;; TODO
 
 ;; - Make headline customizable.
diff --git a/debbugs-ug.texi b/debbugs-ug.texi
index f1af2a5e6f..bc96c759aa 100644
--- a/debbugs-ug.texi
+++ b/debbugs-ug.texi
@@ -206,6 +206,18 @@ of bugs you are currently working on.
 @ref{Presenting Bugs} for the presentation of the results.
 @end deffn
 
+@deffn  {Command} debbugs-gnu-my-open-bugs
+@deffnx {Command} debbugs-org-my-open-bugs
+
+It is a good idea to maintain and eventually close your open bug
+reports.  The functions @code{debbugs-gnu-my-open-bugs} and
+@code{debbugs-org-my-open-bugs} help you do this, by retrieving open
+bug reports, in which you are the submitter.  These functions assume
+that you have defined the variable @code{user-mail-address}
+(@pxref{Mail Header Fields, Mail Header Fields, Mail Header Fields,
+The Emacs Editor}).
+@end deffn
+
 
 @deffn  {Command} debbugs-gnu-emacs-release-blocking-reports &optional release
 @deffnx {Command} debbugs-org-emacs-release-blocking-reports &optional release
@@ -226,7 +238,6 @@ If this user option is non-@code{nil}, a progress report is shown when
 retrieving bugs, defaults to t.
 @end defopt
 
-
 @node Searching Bugs
 @chapter Searching in the Debbugs Database
 
-- 
2.37.3





^ permalink raw reply related	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] added *my-open-bugs functions
  2022-10-01 15:39 ` [bug#56987] [PATCH] added *my-open-bugs functions Joshua Branson via Guix-patches via
@ 2022-10-02 12:52   ` Michael Albinus
  2022-10-03 20:02   ` jbranso--- via Guix-patches via
  1 sibling, 0 replies; 23+ messages in thread
From: Michael Albinus @ 2022-10-02 12:52 UTC (permalink / raw)
  To: Joshua Branson; +Cc: 56987

Joshua Branson <jbranso@dismail.de> writes:

Hi Joshua,

> * debbugs-gnu.el: debbugs-gnu-my-open-bugs: new procedure.
> * debbugs-org.el: debbugs-org-my-open-bugs: new procedure.
> * debbugs-guix.el: debbugs-gnu-guix-search: new procedure.
> * debugs-ug.texi: added documentation for *my-open-bugs procedures.

Thanks for this. In order to push the changes, I'd like to get ChangeLog
like commit messages.

debbugs-gnu-my-open-bugs and debbugs-org-my-open-bugs are explained in
the UG. But since not everybody reads manuals, we explain the
interactive commands also in the Commentary section of the respective
file. Could you please do?

> I did not actually compile the debbugs-ug.text, so it is possible that my
> documentation makes the info program impossible to compile.

It compiles, but the reference to the Emacs manual is wrong. Better
would be

--8<---------------cut here---------------start------------->8---
(@pxref{Mail Headers, , , emacs}).
--8<---------------cut here---------------end--------------->8---

It also wouldn't hurt if you add a small section about
debbugs-gnu-guix-search. Everything, what is undocumenbted, doesn't
exist :-)

> Thanks,
>
> Joshua

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] added *my-open-bugs functions
  2022-10-01 15:39 ` [bug#56987] [PATCH] added *my-open-bugs functions Joshua Branson via Guix-patches via
  2022-10-02 12:52   ` Michael Albinus
@ 2022-10-03 20:02   ` jbranso--- via Guix-patches via
  2022-10-04 14:15     ` Michael Albinus
  1 sibling, 1 reply; 23+ messages in thread
From: jbranso--- via Guix-patches via @ 2022-10-03 20:02 UTC (permalink / raw)
  To: Michael Albinus; +Cc: 56987

October 2, 2022 8:52 AM, "Michael Albinus" <michael.albinus@gmx.de> wrote:

> Joshua Branson <jbranso@dismail.de> writes:
> 
> Hi Joshua,
> 
>> * debbugs-gnu.el: debbugs-gnu-my-open-bugs: new procedure.
>> * debbugs-org.el: debbugs-org-my-open-bugs: new procedure.
>> * debbugs-guix.el: debbugs-gnu-guix-search: new procedure.
>> * debugs-ug.texi: added documentation for *my-open-bugs procedures.
> 
> Thanks for this. In order to push the changes, I'd like to get ChangeLog
> like commit messages.

I thought that's what I had.  I'll try to fix it.  I'll just look at
the git history.

> 
> debbugs-gnu-my-open-bugs and debbugs-org-my-open-bugs are explained in
> the UG. But since not everybody reads manuals, we explain the
> interactive commands also in the Commentary section of the respective
> file. Could you please do?
> 

Yes will do.

>> I did not actually compile the debbugs-ug.text, so it is possible that my
>> documentation makes the info program impossible to compile.
> 
> It compiles, but the reference to the Emacs manual is wrong. Better
> would be
> 
> --8<---------------cut here---------------start------------->8---
> (@pxref{Mail Headers, , , emacs}).
> --8<---------------cut here---------------end--------------->8---
> 
> It also wouldn't hurt if you add a small section about
> debbugs-gnu-guix-search. Everything, what is undocumenbted, doesn't
> exist :-)

I will do both points.  Should every interactive function in any *.el file 
have an autoload ?

> 
>> Thanks,
>> 
>> Joshua
> 
> Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] added *my-open-bugs functions
  2022-10-03 20:02   ` jbranso--- via Guix-patches via
@ 2022-10-04 14:15     ` Michael Albinus
  0 siblings, 0 replies; 23+ messages in thread
From: Michael Albinus @ 2022-10-04 14:15 UTC (permalink / raw)
  To: jbranso; +Cc: 56987

jbranso@dismail.de writes:

Hi Joshua,
>>
>>> * debbugs-gnu.el: debbugs-gnu-my-open-bugs: new procedure.
>>> * debbugs-org.el: debbugs-org-my-open-bugs: new procedure.
>>> * debbugs-guix.el: debbugs-gnu-guix-search: new procedure.
>>> * debugs-ug.texi: added documentation for *my-open-bugs procedures.
>>
>> Thanks for this. In order to push the changes, I'd like to get ChangeLog
>> like commit messages.
>
> I thought that's what I had.  I'll try to fix it.  I'll just look at
> the git history.

Yes, the point is ChangeLog-style.

>> It also wouldn't hurt if you add a small section about
>> debbugs-gnu-guix-search. Everything, what is undocumenbted, doesn't
>> exist :-)
>
> I will do both points.  Should every interactive function in any *.el file
> have an autoload ?

Not necessarily. Only, we want to have it accessible directly, w/o
loading the respective .el file.

>>> Thanks,
>>>
>>> Joshua

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

* [bug#56987] [PATCH] new functions 'debbugs-gnu-my-open-bugs' and 'debbugs-gnu-guix-search'.
  2022-08-05  1:23 [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
                   ` (3 preceding siblings ...)
  2022-10-01 15:39 ` [bug#56987] [PATCH] added *my-open-bugs functions Joshua Branson via Guix-patches via
@ 2022-10-05 16:41 ` Joshua Branson via Guix-patches via
  2022-10-05 20:10   ` bug#56987: " Michael Albinus
  4 siblings, 1 reply; 23+ messages in thread
From: Joshua Branson via Guix-patches via @ 2022-10-05 16:41 UTC (permalink / raw)
  To: 56987; +Cc: michael.albinus, Joshua Branson

* debbugs-gnu.el (debbugs-gnu-my-open-bugs): new function.
* debbugs-org.el (debbugs-org-my-open-bugs): new function.
* debbugs-guix.el (debbugs-gnu-guix-search): new function.
* debugs-ug.texi (debbugs-gnu-my-open-bugs,
debbugs-gnu-guix-search, debbugs-org-my-open-bugs): added
documentation for the new functions.
---
 debbugs-gnu.el  | 17 +++++++++++++++++
 debbugs-guix.el | 51 +++++++++++++++++++++++++++++++++++++++++++++++++
 debbugs-org.el  | 16 ++++++++++++++++
 debbugs-ug.texi | 22 ++++++++++++++++++++-
 4 files changed, 105 insertions(+), 1 deletion(-)
 create mode 100644 debbugs-guix.el

diff --git a/debbugs-gnu.el b/debbugs-gnu.el
index e6629156c1..bc6417c5f5 100644
--- a/debbugs-gnu.el
+++ b/debbugs-gnu.el
@@ -164,6 +164,14 @@
 ;; presented, and in the latter case the last 10 bugs are shown,
 ;; counting from the highest bug number in the repository.
 
+;; M-x debbugs-gnu-my-open-bugs
+;;
+;; It is a good idea to maintain and eventually close your open bug
+;; reports.  The function 'debbugs-gnu-my-open-bugs' helps you do
+;; this, by retrieving open bug reports, in which you are the
+;; submitter.  This function assumes that you have defined the
+;; variable 'user-mail-address'.
+
 ;; For posting commit to bugs, or constructing a bug closing message
 ;; based on a pushed commit, use the command
 ;;
@@ -827,6 +835,13 @@ Shall be bound in `debbugs-org-*' functions.")
     (when (called-interactively-p 'interactive)
       (message "Query finished"))))
 
+;;;###autoload
+(defun debbugs-gnu-my-open-bugs ()
+  "Retrieve the open bugs, that you submitted.  This function assumes the variable
+'user-mail-address' is defined."
+  (interactive)
+  (apply #'debbugs-gnu-bugs (debbugs-get-bugs :submitter "me" :status "open")))
+
 (defun debbugs-gnu-get-bugs (query)
   "Retrieve bug numbers from debbugs.gnu.org according search criteria."
   (let* ((debbugs-port "gnu.org")
@@ -2479,6 +2494,8 @@ or bug ranges, with default to `debbugs-gnu-default-bug-number-list'."
   (when (called-interactively-p 'interactive)
     (message "Retrieving bugs finished")))
 
+(defalias 'debbugs-gnu-get-bug-by-id 'debbugs-gnu-bugs)
+
 (defcustom debbugs-gnu-trunk-directory "~/src/emacs/trunk/"
   "The directory where the main source tree lives."
   :type 'directory
diff --git a/debbugs-guix.el b/debbugs-guix.el
new file mode 100644
index 0000000000..c8d6b281f9
--- /dev/null
+++ b/debbugs-guix.el
@@ -0,0 +1,51 @@
+;;; debbugs-guix.el Guix Specific Debbugs Functions -*- lexical-binding: t; -*-
+;;
+;; Copyright (C) 2011-2022 Free Software Foundation, Inc.
+
+;; Author: Joshua Branson <jbranso@dismail.de>
+;; Keywords: comm, hypermedia, maint
+;; Package: debbugs
+
+;; This file is not part of GNU Emacs.
+
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;;
+;; By default, debbugs-gnu-search searches for open and closed bugs of
+;; all GNU packages, which can make searching a little slow.  To
+;; remedy this situation, this file provides the function
+;; 'debbugs-gnu-guix-search', which search for open bugs that relate
+;; to the GNU guix.
+;;
+;;; Code:
+
+;;;###autoload
+(defun debbugs-gnu-guix-search ()
+  "Search for open guix bugs and patches."
+  (interactive)
+  (debbugs-gnu-search (read-string "Search String: ") '((pending . "pending"))
+                      nil '("guix" "guix-patches") nil))
+
+;;;###autoload
+(defun debbugs-org-guix-search ()
+  "Search for open guix bugs and patches and display the results in an org
+ buffer."
+  (interactive)
+  (let ((debbugs-gnu-show-reports-function #'debbugs-org-show-reports))
+    (debbugs-gnu-search (read-string "Search String: ") '((pending . "pending"))
+                        nil '("guix" "guix-patches") nil)))
+
+(provide 'debbugs-guix)
+;;; debbugs-guix.el ends here
diff --git a/debbugs-org.el b/debbugs-org.el
index c4343ecd8e..c62ffc0396 100644
--- a/debbugs-org.el
+++ b/debbugs-org.el
@@ -114,6 +114,14 @@
 ;; presented, and in the latter case the last 10 bugs are shown,
 ;; counting from the highest bug number in the repository.
 
+;; M-x debbugs-org-my-open-bugs
+;;
+;; It is a good idea to maintain and eventually close your open bug
+;; reports.  The function 'debbugs-org-my-open-bugs' helps you do
+;; this, by retrieving open bug reports, in which you are the
+;; submitter.  This function assumes that you have defined the
+;; variable 'user-mail-address'.
+
 ;;; Code:
 
 (require 'debbugs-gnu)
@@ -352,6 +360,14 @@ or bug ranges, with default to `debbugs-gnu-default-bug-number-list'."
   (let ((debbugs-gnu-show-reports-function #'debbugs-org-show-reports))
     (call-interactively #'debbugs-gnu-bugs)))
 
+;;;###autoload
+(defun debbugs-org-my-open-bugs ()
+  "Retrieve the open bugs, that you submitted.  This function assumes the variable
+'user-mail-address' is defined."
+  (interactive)
+  (let ((debbugs-gnu-show-reports-function #'debbugs-org-show-reports))
+    (apply #'debbugs-gnu-bugs (debbugs-get-bugs :submitter "me" :status "open"))))
+
 ;; TODO
 
 ;; - Make headline customizable.
diff --git a/debbugs-ug.texi b/debbugs-ug.texi
index f1af2a5e6f..0f0823f722 100644
--- a/debbugs-ug.texi
+++ b/debbugs-ug.texi
@@ -206,6 +206,17 @@ of bugs you are currently working on.
 @ref{Presenting Bugs} for the presentation of the results.
 @end deffn
 
+@deffn  {Command} debbugs-gnu-my-open-bugs
+@deffnx {Command} debbugs-org-my-open-bugs
+
+It is a good idea to maintain and eventually close your open bug
+reports.  The functions @code{debbugs-gnu-my-open-bugs} and
+@code{debbugs-org-my-open-bugs} help you do this, by retrieving open
+bug reports, in which you are the submitter.  These functions assume
+that you have defined the variable @code{user-mail-address}
+(@pxref{Mail Headers, , , emacs}).
+@end deffn
+
 
 @deffn  {Command} debbugs-gnu-emacs-release-blocking-reports &optional release
 @deffnx {Command} debbugs-org-emacs-release-blocking-reports &optional release
@@ -226,7 +237,6 @@ If this user option is non-@code{nil}, a progress report is shown when
 retrieving bugs, defaults to t.
 @end defopt
 
-
 @node Searching Bugs
 @chapter Searching in the Debbugs Database
 
@@ -367,6 +377,16 @@ These commands show also a progress report when
 @end deffn
 
 
+@deffn  {Command} debbugs-gnu-guix-search
+@deffnx {Command} debbugs-org-guix-search
+
+By default, @code{debbugs-gnu-search} and @code{debbugs-org-search},
+search for all open bugs in the debbugs database.  While this is
+extensive search is laudable, it is perhaps not efficient.  These two
+functions will let you search for only open guix bugs and patches.
+@end deffn
+
+
 @node Presenting Bugs
 @chapter Presenting Bugs
 
-- 
2.37.3





^ permalink raw reply related	[flat|nested] 23+ messages in thread

* bug#56987: [PATCH] new functions 'debbugs-gnu-my-open-bugs' and 'debbugs-gnu-guix-search'.
  2022-10-05 16:41 ` [bug#56987] [PATCH] new functions 'debbugs-gnu-my-open-bugs' and 'debbugs-gnu-guix-search' Joshua Branson via Guix-patches via
@ 2022-10-05 20:10   ` Michael Albinus
  0 siblings, 0 replies; 23+ messages in thread
From: Michael Albinus @ 2022-10-05 20:10 UTC (permalink / raw)
  To: Joshua Branson; +Cc: 56987-done

Joshua Branson <jbranso@dismail.de> writes:

Hi Joshua,

> * debbugs-gnu.el (debbugs-gnu-my-open-bugs): new function.
> * debbugs-org.el (debbugs-org-my-open-bugs): new function.
> * debbugs-guix.el (debbugs-gnu-guix-search): new function.
> * debugs-ug.texi (debbugs-gnu-my-open-bugs,
> debbugs-gnu-guix-search, debbugs-org-my-open-bugs): added
> documentation for the new functions.

Thanks. I've pushed it to the GNU ELPA repository, and I've increased
the version to 0.34 after applying some cosmetic changes. Shall be
visible in a couple of hours.

Closing the bug.

Best regards, Michael.




^ permalink raw reply	[flat|nested] 23+ messages in thread

end of thread, other threads:[~2022-10-05 20:17 UTC | newest]

Thread overview: 23+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-08-05  1:23 [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
2022-08-05  1:32 ` Joshua Branson via Guix-patches via
2022-08-10 15:16   ` Joshua Branson via Guix-patches via
2022-08-10 16:44 ` Michael Albinus
2022-08-10 20:10 ` jbranso--- via Guix-patches via
2022-08-10 20:24   ` Maxime Devos
2022-08-10 20:39   ` jbranso--- via Guix-patches via
2022-08-10 21:22   ` [bug#56987] Requesting help in assigning copright to Emacs's debbugs jbranso--- via Guix-patches via
2022-08-11 19:51     ` [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
     [not found]     ` <304e6f0d877d6b8bb60db051e661edf1@dismail.de>
2022-08-17 20:14       ` [bug#56987] Fwd: [gnu.org #1863422] Joshua Allen Branson GNU EMACS jbranso--- via Guix-patches via
2022-08-18  9:52         ` Michael Albinus
2022-08-22 17:21           ` [bug#56987] [PATCH] etc: guix-debbugs.el: new file Joshua Branson via Guix-patches via
2022-08-11  6:24   ` Michael Albinus
2022-08-11 15:25     ` Joshua Branson via Guix-patches via
2022-08-11 16:06       ` Michael Albinus
2022-08-13 22:49         ` Joshua Branson via Guix-patches via
2022-08-12 19:17       ` jbranso--- via Guix-patches via
2022-10-01 15:39 ` [bug#56987] [PATCH] added *my-open-bugs functions Joshua Branson via Guix-patches via
2022-10-02 12:52   ` Michael Albinus
2022-10-03 20:02   ` jbranso--- via Guix-patches via
2022-10-04 14:15     ` Michael Albinus
2022-10-05 16:41 ` [bug#56987] [PATCH] new functions 'debbugs-gnu-my-open-bugs' and 'debbugs-gnu-guix-search' Joshua Branson via Guix-patches via
2022-10-05 20:10   ` bug#56987: " Michael Albinus
     [not found] <rt-4.2.16-14-g9a593ee-12923-1660753466-248.1863422-5-0@rt.gnu.org>
     [not found] ` <RT-Ticket-1863422@rt.gnu.org>
     [not found]   ` <rt-4.2.16-14-g9a593ee-21845-1660236515-917.1863103-5-0@rt.gnu.org>

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).