unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Jens Schmidt via "Bug reports for GNU Emacs, the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
To: 63497@debbugs.gnu.org
Subject: bug#63497: [PATCH] Remove obsolete information on archiving mail from Gnus manual
Date: Sat, 13 May 2023 21:28:37 +0200	[thread overview]
Message-ID: <c04edb61-5823-b44e-9307-73757355eab7@vodafonemail.de> (raw)

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






             reply	other threads:[~2023-05-13 19:28 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-05-13 19:28 Jens Schmidt via Bug reports for GNU Emacs, the Swiss army knife of text editors [this message]
2023-05-18 11:10 ` bug#63497: [PATCH] Remove obsolete information on archiving mail from Gnus manual Eli Zaretskii
2023-05-19  0:39   ` Andrew Cohen
2023-05-19  6:08     ` Eli Zaretskii
2023-05-20 21:51 ` bug#63497: [PATCH] Remove obsolete information on archiving mail Jens Schmidt via Bug reports for GNU Emacs, the Swiss army knife of text editors
2023-05-21  6:26   ` Eli Zaretskii

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=c04edb61-5823-b44e-9307-73757355eab7@vodafonemail.de \
    --to=bug-gnu-emacs@gnu.org \
    --cc=63497@debbugs.gnu.org \
    --cc=jschmidt4gnu@vodafonemail.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.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).