getmail service documentation error?

  • Done
  • quality assurance status badge
Details
2 participants
  • Christopher Baines
  • pelzflorian (Florian Pelz)
Owner
unassigned
Submitted by
pelzflorian (Florian Pelz)
Severity
normal

Debbugs page

pelzflorian (Florian Pelz) wrote 5 years ago
(address . bug-guix@gnu.org)(name . Christopher Baines)(address . mail@cbaines.net)
20191018070529.dnqp2qcnsimjoet4@pelzflorian.localdomain
The documentation of the getmail service’s delete_after setting is
confusing and appears to contradict upstream documentation at

I am not sure, but the code in the getmail file in the getmail source
code also appears to call destination.deliver_message before deleting,
in agreement with upstream.

Can someone with knowledge check? Shall I push the attached patch?

Regards,
Florian
From 971fee0af8908acdc73498917a8a55811122ac8e Mon Sep 17 00:00:00 2001
From: Florian Pelz <pelzflorian@pelzflorian.de>
Date: Fri, 18 Oct 2019 08:52:12 +0200
Subject: [PATCH] Fix documentation of delete_after in the getmail service.

* doc/guix.texi (Getmail service): Remove the word `not'.
* gnu/services/getmail.scm (getmail-options-configuration): Ditto.
---
doc/guix.texi | 2 +-
gnu/services/getmail.scm | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)

Toggle diff (30 lines)
diff --git a/doc/guix.texi b/doc/guix.texi
index a38eb2aa7c..32d2ffe044 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -17435,7 +17435,7 @@ Defaults to @samp{#f}.
@deftypevr {@code{getmail-options-configuration} parameter} non-negative-integer delete-after
Getmail will delete messages this number of days after seeing them, if
-they have not been delivered. This means messages will be left on the
+they have been delivered. This means messages will be left on the
server this number of days after delivering them. A value of @samp{0}
disabled this feature.
diff --git a/gnu/services/getmail.scm b/gnu/services/getmail.scm
index b807bb3a5d..b3d86cb65c 100644
--- a/gnu/services/getmail.scm
+++ b/gnu/services/getmail.scm
@@ -176,8 +176,8 @@ server.")
(delete-after
(non-negative-integer 0)
"Getmail will delete messages this number of days after seeing them, if
-they have not been delivered. This means messages will be left on the server
-this number of days after delivering them. A value of @samp{0} disabled this
+they have been delivered. This means messages will be left on the server this
+number of days after delivering them. A value of @samp{0} disabled this
feature.")
(delete-bigger-than
(non-negative-integer 0)
--
2.23.0
Christopher Baines wrote 5 years ago
(name . pelzflorian (Florian Pelz))(address . pelzflorian@pelzflorian.de)(address . bug-guix@gnu.org)
87r23aqyv4.fsf@cbaines.net
pelzflorian (Florian Pelz) <pelzflorian@pelzflorian.de> writes:

Toggle quote (10 lines)
> The documentation of the getmail service’s delete_after setting is
> confusing and appears to contradict upstream documentation at
> <http://pyropus.ca/software/getmail/configuration.html>.
>
> I am not sure, but the code in the getmail file in the getmail source
> code also appears to call destination.deliver_message before deleting,
> in agreement with upstream.
>
> Can someone with knowledge check? Shall I push the attached patch?

The change and patch looks reasonable to me.
-----BEGIN PGP SIGNATURE-----

iQKTBAEBCgB9FiEEPonu50WOcg2XVOCyXiijOwuE9XcFAl2pbf9fFIAAAAAALgAo
aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDNF
ODlFRUU3NDU4RTcyMEQ5NzU0RTBCMjVFMjhBMzNCMEI4NEY1NzcACgkQXiijOwuE
9XfEUhAAs9HRl7u3XdNUiSuE8MfaegpOF60ULBiuFSbkIWkg4pY12SO5nQY33cd1
UbYmpFWj4wj4rc3hnaY/oIhTySj/gW65tYDZ/GgUzGd1hJc2+oaybh4gSVAGZNLa
FvLuDaKN/0dMEzXppBYt642iskS6DIVwFW6VjicjSAhbdQ5whSCJZtRSV9sihPqt
QreRQnR7mBtOHwNUCw74DEyo8JCk5DMoSVkmzcy+JOKvYj1E6ru8fj5+P2Oy+J1r
DT+jmVil8kpD9zzGETFd5SGTab+5XnqaLZQUncYSrvERT7vOB9N2ZjW+ElCQr9jL
9b+TBVCvtOlLRFeAi+fvehypYl48A1P8U6RJTklAJmoi4T2D5NEbOYzJvUUz4MMH
bxN36yeAWo47dVm0GEXyRyPZsSzRuCPDxWP7jx8MArtSlt3RcJdMDsLSgWBEFIdi
ZpIXCA4BTLRjL6CnlCcK/M9J5chRtqkWxOLywrdL4X2sitZ1lK6gkjxwDmlaM6mm
BjYglEGhSGVTt6f+8k0olDFRlJ1ecOUe1sboouJItxB4f08guFrrqGq3alCRcJbR
I6ctwZR1b9+mlkA0Qnb4Js165UrviqrlXelkViBZi7Z9rqSRT8GfA0YkDlUXh+b5
yd3vEKdMzp3etDiv+/XdA6NxkJ0k9K/q+2UaNL/JdVFDTBuQqIA=
=e42t
-----END PGP SIGNATURE-----

pelzflorian (Florian Pelz) wrote 5 years ago
(name . Christopher Baines)(address . mail@cbaines.net)(address . 37804-done@debbugs.gnu.org)
20191018080231.xqm73vngjpeprhca@pelzflorian.localdomain
On Fri, Oct 18, 2019 at 08:47:11AM +0100, Christopher Baines wrote:
Toggle quote (3 lines)
> The change and patch looks reasonable to me.


Pushed. Thank you!
Closed
pelzflorian (Florian Pelz) wrote 5 years ago
Re: bug#37804: getmail service documentation error?
(address . 37804@debbugs.gnu.org)
20191018080913.boqyojcwzrw2tkfu@pelzflorian.localdomain
On Fri, Oct 18, 2019 at 10:02:31AM +0200, pelzflorian (Florian Pelz) wrote:
Toggle quote (9 lines)
> On Fri, Oct 18, 2019 at 08:47:11AM +0100, Christopher Baines wrote:
> > The change and patch looks reasonable to me.
>
>
> Pushed. Thank you!
>
>
>

I forgot prefixing the commit with doc. Too late now. Sorry.
?
Your comment

This issue is archived.

To comment on this conversation send an email to 37804@debbugs.gnu.org

To respond to this issue using the mumi CLI, first switch to it
mumi current 37804
Then, you may apply the latest patchset in this issue (with sign off)
mumi am -- -s
Or, compose a reply to this issue
mumi compose
Or, send patches to this issue
mumi send-email *.patch
You may also tag this issue. See list of standard tags. For example, to set the confirmed and easy tags
mumi command -t +confirmed -t +easy
Or, remove the moreinfo tag and set the help tag
mumi command -t -moreinfo -t +help