GNU bug report logs - #78845
[PATCH 0/2] doc: Document desktop notifications configuration for Gnus.

Previous Next

To reply to this bug, email your comments to 78845 AT debbugs.gnu.org.
There is no need to reopen the bug first.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim <at> guixotic.coop>
To: bug-gnu-emacs <at> gnu.org
Cc: Maxim Cournoyer <maxim <at> guixotic.coop>
Subject: [PATCH 0/2] doc: Document desktop notifications configuration for
 Gnus.
Date: Fri, 20 Jun 2025 13:00:51 +0900

Maxim Cournoyer (2):
  doc: Update Texinfo menus.
  doc: Document desktop notifications configuration for Gnus.

 doc/misc/gnus.texi | 40 ++++++++++++++++++++++++++++++++++++----
 1 file changed, 36 insertions(+), 4 deletions(-)


base-commit: 477112ebc3497e9529cc06b24134d85d17c642ee
-- 
2.49.0

Message #8 received at 78845 <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim <at> guixotic.coop>
To: 78845 <at> debbugs.gnu.org
Cc: Maxim Cournoyer <maxim <at> guixotic.coop>
Subject: [PATCH 1/2] doc: Update Texinfo menus.
Date: Fri, 20 Jun 2025 13:27:16 +0900

Generated from Emacs via M-x texinfo-all-menus-update, and dropping
changes made due to limitations of the tool.
---
 doc/misc/gnus.texi | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 62909fc99f1..cf2ea9d16ea 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -438,7 +438,6 @@ Top
 * Finding the News::            Choosing a method for getting news.
 * The Server is Down::          How can I read my mail then?
 * Child Gnusae::                You can have more than one Gnus active at a time.
-* Fetching a Group::            Starting Gnus just to read a group.
 * New Groups::                  What is Gnus supposed to do with new groups?
 * Changing Servers::            You may want to move from one server to another.
 * Startup Files::               Those pesky startup files---@file{.newsrc}.
@@ -661,7 +660,7 @@ Top
 * NNTP::                        Reading news from an @acronym{NNTP} server.
 * News Spool::                  Reading news from the local spool.
 
-@acronym{NNTP}
+NNTP
 
 * Direct Functions::            Connecting directly to the server.
 * Indirect Functions::          Connecting indirectly to the server.
@@ -731,8 +730,8 @@ Top
 
 Virtual Groups
 
-* Selection Groups::            Articles selected from many places.
-* Combined Groups::             Combining multiple  groups.
+* Selection Groups::            Combining articles from many groups.
+* Combined Groups::             Combining multiple groups.
 
 Email Based Diary
 
@@ -841,6 +840,7 @@ Top
 * Undo::                        Some actions can be undone.
 * Predicate Specifiers::        Specifying predicates.
 * Moderation::                  What to do if you're a moderator.
+* Fetching a Group::            Starting Gnus just to read a group.
 * Image Enhancements::          Emacs can display images.
 * Fuzzy Matching::              What's the big fuzz?
 * Thwarting Email Spam::        Simple ways to avoid unsolicited commercial email.
-- 
2.49.0

Message #11 received at 78845 <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim <at> guixotic.coop>
To: 78845 <at> debbugs.gnu.org
Cc: Maxim Cournoyer <maxim <at> guixotic.coop>
Subject: [PATCH 2/2] doc: Document desktop notifications configuration for
 Gnus.
Date: Fri, 20 Jun 2025 13:27:17 +0900

* doc/misc/gnus.texi (Notifications): Add section.
---
 doc/misc/gnus.texi | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index cf2ea9d16ea..85e94f0f91d 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -837,6 +837,7 @@ Top
 * Mode Lines::                  Displaying information in the mode lines.
 * Highlighting and Menus::      Making buffers look all nice and cozy.
 * Daemons::                     Gnus can do things behind your back.
+* Notifications::               Setting up desktop notifications.
 * Undo::                        Some actions can be undone.
 * Predicate Specifiers::        Specifying predicates.
 * Moderation::                  What to do if you're a moderator.
@@ -22683,6 +22684,7 @@ Various
 * Mode Lines::                  Displaying information in the mode lines.
 * Highlighting and Menus::      Making buffers look all nice and cozy.
 * Daemons::                     Gnus can do things behind your back.
+* Notifications::               Setting up desktop notifications.
 * Undo::                        Some actions can be undone.
 * Predicate Specifiers::        Specifying predicates.
 * Moderation::                  What to do if you're a moderator.
@@ -23732,6 +23734,36 @@ Daemons
 is a sure-fire way of getting booted off any respectable system.  So
 behave.
 
+@node Notifications
+@section Notifications
+@cindex notifications, desktop
+@cindex desktop notifications
+
+Gnus provides the @code{gnus-notifications} package that, combined with
+a @code{gnus-demon} handler, can be used to notify you when fresh news
+or mails arrive via desktop notifications.  Here's a basic configuration
+to put in your @file{~/.gnus.el} file:
+
+@lisp
+(require 'gnus-notifications)
+(add-hook 'gnus-after-getting-new-news-hook #'gnus-notifications)
+(gnus-demon-add-handler #'gnus-demon-scan-news 15 3) ;every 15 minutes
+@end lisp
+
+@noindent
+The above will produce notifications for new arrivals when the
+@code{gnus-after-getting-new-news-hook} hook runs, which is triggered
+after retrieving news and mails with the @code{gnus-demon-scan-news}
+procedure.  The demon handler is configured to scan news every fifteen
+minutes, once Emacs has been idle for three minutes.
+
+@quotation Important
+@code{gnus-notifications} will only emit notifications for groups whose
+level is equal or lower than @var{gnus-notifications-minimum-level},
+which defaults to @code{1}, so make sure to set the level of the groups
+you want to be notified for to @code{1}, or adjust the value of
+@var{gnus-notifications-minimum-level} to your needs.
+@end quotation
 
 @node Undo
 @section Undo
-- 
2.49.0

Message #14 received at 78845 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Maxim Cournoyer <maxim <at> guixotic.coop>
Cc: 78845 <at> debbugs.gnu.org
Subject: Re: bug#78845: [PATCH 1/2] doc: Update Texinfo menus.
Date: Sat, 28 Jun 2025 12:31:24 +0300

> Cc: Maxim Cournoyer <maxim <at> guixotic.coop>
> From: Maxim Cournoyer <maxim <at> guixotic.coop>
> Date: Fri, 20 Jun 2025 13:27:16 +0900
> 
> Generated from Emacs via M-x texinfo-all-menus-update, and dropping
> changes made due to limitations of the tool.

Thanks, installed on the master branch.

Message #19 received at 78845-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Maxim Cournoyer <maxim <at> guixotic.coop>
Cc: 78845-done <at> debbugs.gnu.org
Subject: Re: bug#78845: [PATCH 2/2] doc: Document desktop notifications
 configuration for Gnus.
Date: Sat, 28 Jun 2025 12:39:16 +0300

> Cc: Maxim Cournoyer <maxim <at> guixotic.coop>
> From: Maxim Cournoyer <maxim <at> guixotic.coop>
> Date: Fri, 20 Jun 2025 13:27:17 +0900
> 
> * doc/misc/gnus.texi (Notifications): Add section.
> ---
>  doc/misc/gnus.texi | 32 ++++++++++++++++++++++++++++++++
>  1 file changed, 32 insertions(+)

Thanks, installed on master.

I needed to edit your patch, since Git complained:

  Line longer than 78 characters in commit message
  Commit aborted; please see the file CONTRIBUTE

Please in the future try to conform to our conventions as described in
CONTRIBUTE.

And with that, I'm closing this bug.

Message #22 received at 78845-done <at> debbugs.gnu.org (full text, mbox):

From: Maxim Cournoyer <maxim <at> guixotic.coop>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 78845-done <at> debbugs.gnu.org
Subject: Re: bug#78845: [PATCH 2/2] doc: Document desktop notifications
 configuration for Gnus.
Date: Thu, 03 Jul 2025 11:30:59 +0900

Hi,

Thanks for the review/install, Eli!  I'll pay attention to the Emacs
commit message conventions more closely in my next submission.

Have a good week,

-- 
Maxim

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.