GNU bug report logs - #63497
[PATCH] Remove obsolete information on archiving mail from Gnus manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 63497 in the body.
You can then email your comments to 63497 AT debbugs.gnu.org in the normal way.

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

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

From: Jens Schmidt <jschmidt4gnu <at> vodafonemail.de>
To: bug-gnu-emacs <at> gnu.org
Subject: [PATCH] Remove obsolete information on archiving mail from Gnus manual
Date: Sat, 13 May 2023 21:28:37 +0200

Hi,

my first test patch to practice things, pls comment if its format is not 
what you expect.  I hope Thunderbird does not mess up the format.  FSF 
copyright assignment is in process, but probably not yet completed.

Regardless of this being a test patch, it fixes a real but minor doc 
issue in the Gnus manual:  In 2012 Lars committed a change that removed 
the previous "external marks" feature  from various backends 
(89b163db286d79b43fb5c9927fc622bbf7d2ef1a).

The Gnus manual still references these external marks in section 
"Archiving Mails", I guess that reference just got overlooked.  But 
without external marks, archiving mails in Gnus is rather difficult (to 
my knowledge), at least for the nnml backend.  So I decided to rather 
remove that section entirely.

Thanks

Jens



* doc/misc/gnus.texi: Remove obsolete information on archiving mail from 
Gnus manual

---
 doc/misc/gnus.texi | 25 -------------------------
 1 file changed, 25 deletions(-)

diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index be7504c92bf..e08a5587962 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -713,7 +713,6 @@ Top

 Browsing the Web

-* Archiving Mail::
 * Web Searches::                Creating groups from articles that 
match a string.
 * RSS::                         Reading RDF site summary.

@@ -17247,7 +17246,6 @@ Browsing the Web
 interfaces to these sources.

 @menu
-* Archiving Mail::
 * Web Searches::                Creating groups from articles that 
match a string.
 * RSS::                         Reading RDF site summary.
 @end menu
@@ -17264,29 +17262,6 @@ Browsing the Web
 Unplugged}) handle downloading articles, and then you can read them at
 leisure from your local disk.  No more World Wide Wait for you.

-@node Archiving Mail
-@subsection Archiving Mail
-@cindex archiving mail
-@cindex backup of mail
-
-Some of the back ends, notably @code{nnml}, @code{nnfolder}, and
-@code{nnmaildir}, now actually store the article marks with each group.
-For these servers, archiving and restoring a group while preserving
-marks is fairly simple.
-
-(Preserving the group level and group parameters as well still
-requires ritual dancing and sacrifices to the @file{.newsrc.eld} deity
-though.)
-
-To archive an entire @code{nnml}, @code{nnfolder}, or @code{nnmaildir}
-server, take a recursive copy of the server directory.  There is no need
-to shut down Gnus, so archiving may be invoked by @code{cron} or
-similar.  You restore the data by restoring the directory tree, and
-adding a server definition pointing to that directory in Gnus.  The
-@ref{Article Backlog}, @ref{Asynchronous Fetching} and other things
-might interfere with overwriting data, so you may want to shut down Gnus
-before you restore the data.
-
 @node Web Searches
 @subsection Web Searches
 @cindex nnweb
-- 
2.30.2

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Jens Schmidt <jschmidt4gnu <at> vodafonemail.de>,
 Andrew G Cohen <cohen <at> andy.bu.edu>
Cc: 63497 <at> debbugs.gnu.org
Subject: Re: bug#63497: [PATCH] Remove obsolete information on archiving mail
 from Gnus manual
Date: Thu, 18 May 2023 14:10:37 +0300

> Date: Sat, 13 May 2023 21:28:37 +0200
> From:  Jens Schmidt via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
> 
> my first test patch to practice things, pls comment if its format is not 
> what you expect.  I hope Thunderbird does not mess up the format.  FSF 
> copyright assignment is in process, but probably not yet completed.

It's not.

> Regardless of this being a test patch, it fixes a real but minor doc 
> issue in the Gnus manual:  In 2012 Lars committed a change that removed 
> the previous "external marks" feature  from various backends 
> (89b163db286d79b43fb5c9927fc622bbf7d2ef1a).
> 
> The Gnus manual still references these external marks in section 
> "Archiving Mails", I guess that reference just got overlooked.  But 
> without external marks, archiving mails in Gnus is rather difficult (to 
> my knowledge), at least for the nnml backend.  So I decided to rather 
> remove that section entirely.

Andrew, should these parts be removed, indeed?

> * doc/misc/gnus.texi: Remove obsolete information on archiving mail from 
> Gnus manual

Please mention the names of the nodes in which you make the changes,
as if they were functions.  (Using the Emacs commands for generating
ChangeLog-style entries would automatically include those node names
for you, so it is recommended to use those commands.)

Also, once you know the bug number (which usually happens when you
submit the second version of the patch and all the subsequent
versions), please mention the bug number in the commit log message.
You can see examples of that if you type "git log" in the Emacs
repository.

Thanks.

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

From: Andrew Cohen <cohen <at> bu.edu>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 63497 <at> debbugs.gnu.org, Jens Schmidt <jschmidt4gnu <at> vodafonemail.de>,
 Andrew G Cohen <cohen <at> andy.bu.edu>
Subject: Re: bug#63497: [PATCH] Remove obsolete information on archiving
 mail from Gnus manual
Date: Fri, 19 May 2023 08:39:13 +0800

[...]

>> The Gnus manual still references these external marks in section
    >> "Archiving Mails", I guess that reference just got overlooked.
    >> But without external marks, archiving mails in Gnus is rather
    >> difficult (to my knowledge), at least for the nnml backend.  So I
    >> decided to rather remove that section entirely.

    EZ> Andrew, should these parts be removed, indeed?

Yes, I think it should be removed.  As Jens says, the purpose of this section was to
indicate that group marks are stored in the filesystem for these
backends, so saving these marks doesn't require doing anything other
than copying the files. But the marks are no longer stored in the
filesystem, so the whole section is moot.  (As an irrelevant aside, for
some strange reason its under the "Browsing the Web" topic, which is why
I have never looked at it)

Best,
Andy
-- 
Andrew Cohen

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Andrew Cohen <cohen <at> bu.edu>
Cc: 63497 <at> debbugs.gnu.org, jschmidt4gnu <at> vodafonemail.de, cohen <at> andy.bu.edu
Subject: Re: bug#63497: [PATCH] Remove obsolete information on archiving
 mail from Gnus manual
Date: Fri, 19 May 2023 09:08:59 +0300

> From: Andrew Cohen <cohen <at> bu.edu>
> Cc: Jens Schmidt <jschmidt4gnu <at> vodafonemail.de>,  Andrew G Cohen
>  <cohen <at> andy.bu.edu>,  63497 <at> debbugs.gnu.org
> Date: Fri, 19 May 2023 08:39:13 +0800
> 
> 
> [...]
> 
> >> The Gnus manual still references these external marks in section
>     >> "Archiving Mails", I guess that reference just got overlooked.
>     >> But without external marks, archiving mails in Gnus is rather
>     >> difficult (to my knowledge), at least for the nnml backend.  So I
>     >> decided to rather remove that section entirely.
> 
>     EZ> Andrew, should these parts be removed, indeed?
> 
> Yes, I think it should be removed.  As Jens says, the purpose of this section was to
> indicate that group marks are stored in the filesystem for these
> backends, so saving these marks doesn't require doing anything other
> than copying the files. But the marks are no longer stored in the
> filesystem, so the whole section is moot.  (As an irrelevant aside, for
> some strange reason its under the "Browsing the Web" topic, which is why
> I have never looked at it)

OK, thanks.

Jens, would you please rework the patch according to my comments, and
re-post?

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

From: Jens Schmidt <jschmidt4gnu <at> vodafonemail.de>
To: 63497 <at> debbugs.gnu.org
Subject: [PATCH] Remove obsolete information on archiving mail
Date: Sat, 20 May 2023 23:51:58 +0200

[Message part 1 (text/plain, inline)]

Next attempt - sorry for the delay, missed the update emails to this bug.

Not sure whether removals count towards the 15 line limit but copyright 
assignment should be through now - could you please confirm, when you're 
at it?

Thanks

Jens

[0001-Remove-obsolete-information-on-archiving-mail.patch (text/x-patch, attachment)]

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Jens Schmidt <jschmidt4gnu <at> vodafonemail.de>
Cc: 63497-done <at> debbugs.gnu.org
Subject: Re: bug#63497: [PATCH] Remove obsolete information on archiving mail
Date: Sun, 21 May 2023 09:26:07 +0300

> Date: Sat, 20 May 2023 23:51:58 +0200
> From:  Jens Schmidt via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
> 
> Next attempt - sorry for the delay, missed the update emails to this bug.

Thanks, installed on the emacs-29 branch, and closing the bug.

> Not sure whether removals count towards the 15 line limit but copyright 
> assignment should be through now - could you please confirm, when you're 
> at it?

Your assignment is on file now, yes.

Previous Next

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