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.

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

Previous Next

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