commit 37d4c28b96a5c60a071a5edb25099dc0b759b82b
parent 2668a517689024356458dbe4fb01f6c815d95dc3
Author: Jaromil <jaromil@dyne.org>
Date: Fri, 18 Apr 2014 13:09:30 +0200
documentation and todo updates
Diffstat:
| A | ChangeLog.md | | | 91 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| D | ChangeLog.txt | | | 82 | ------------------------------------------------------------------------------- |
| A | KNOWN_BUGS.md | | | 13 | +++++++++++++ |
| A | README.md | | | 202 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| D | README.txt | | | 194 | ------------------------------------------------------------------------------- |
| D | TODO | | | 57 | --------------------------------------------------------- |
| A | TODO.md | | | 81 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| M | doc/jaromail-manual.org | | | 2 | ++ |
| M | src/zlibs/addressbook | | | 5 | +++-- |
| M | src/zlibs/email | | | 5 | +++++ |
10 files changed, 397 insertions(+), 335 deletions(-)
diff --git a/ChangeLog.md b/ChangeLog.md
@@ -0,0 +1,91 @@
+# JaroMail ChangeLog
+
+## 1.3.1
+### 13 December 2013
+
+More fixes to OSX usage for editor and attachments, changes to
+local keyring hashing, slight refactoring of packaging and install
+scripts.
+
+## 1.3
+### 5 December 2013
+
+Major fixes for the new OSX Application packaging implying a
+rather important refactoring: during its operation JaroMail will
+not write into $WORKDIR anymore, but only into $MAILDIR, where
+most user generated files are now moved.
+
+Includes bugfixes for the build on Fedora.
+
+## 1.2
+### 14 September 2013
+
+Several usability improvements and bugfixes both for usage on
+GNU/Linux and Apple/OSX systems. The latter has now a different
+distribution format for JaroMail as a self-contained app bundle.
+
+Bugfixes for: backup mechanism, gnupg wrapper, file attachments,
+whitelisting, HTML mail rendering.
+
+New features include a native keyring mechanism to store account
+informations in a single-pass symmetric encrypted file.
+Minor updates to the documentation.
+
+## 1.1
+### 18 October 2012 - codename: Slick bastard
+
+Lots of bugfixes, code cleanups and usability improvements are
+paving the way for some new powerful features.
+
+The addressbook system has been enhanced to permit editing of the
+entries in white and blacklist, plus import and export of VCards
+is now possible.
+
+The use of GnuPG in Mutt is fixed, along with performance
+and usability improvements also to search.
+
+Vim is now used as default editor, configured to properly format
+emails with paragraph justification.
+
+More improvements were done also to the management of multiple
+accounts, mailbox filtering, maildir merge and backup.
+
+## 1.0
+### 18 June 2012 - codename: E-Data addict
+
+Software development went forward in a rather passionate way,
+mostly motivated by the author's need to backup his rather big
+archive of e-mails. So this release's focus is on stability,
+search and backup features and a rather deep refactoring of the
+codebase.
+
+Mairix has been added as an integrated search engine.
+
+Backup is possible also using search expressions (see manual)
+
+Some new modules in statistics implement jquery reports.
+
+Code is modularized in pre-compiled zsh modules.
+
+Extensive testing has proven the whole setup to be stable and
+ready for production use, hence the 1.0 release.
+
+## 0.9
+### 06 May 2012 - codename: The rush of the unemployed
+
+After getting recently unemployed because of European austerity
+cuts (and because of not working in a bank), Jaromil followed up
+with a full pijama coding session that lasted about a week,
+hammering out most issues that make now this software enter BETA
+stage, while starting to use it for real.
+
+This is the first public release of Jaro Mail, it comes with a
+User Manual and lots of usability fixes over the previous, it was
+tested on GNU and OSX operating systems.
+
+## 0.1
+### 29 May 2012 - Initial release
+
+After about a dozen years of development and use by its own author, Jaromail is released to the public as an e-mail and mailinglist console setup.
+
+To find out what name to give to the software, Jaromil asked his friend and PhD colleague Max Kazemzadeh how it should be called and Max, an hilarious chap who always has a joke ready, replied: Jaro Mail!
diff --git a/ChangeLog.txt b/ChangeLog.txt
@@ -1,82 +0,0 @@
-Jaro Mail 1.3.1 - 13 December 2013
- More fixes to OSX usage for editor and attachments, changes to
- local keyring hashing, slight refactoring of packaging and install
- scripts.
-
-Jaro Mail 1.3 - 5 December 2013
- Major fixes for the new OSX Application packaging implying a
- rather important refactoring: during its operation JaroMail will
- not write into $WORKDIR anymore, but only into $MAILDIR, where
- most user generated files are now moved.
-
- Includes bugfixes for the build on Fedora.
-
-Jaro Mail 1.2 - 14 September 2013
- Several usability improvements and bugfixes both for usage on
- GNU/Linux and Apple/OSX systems. The latter has now a different
- distribution format for JaroMail as a self-contained app bundle.
-
- Bugfixes for: backup mechanism, gnupg wrapper, file attachments,
- whitelisting, HTML mail rendering.
-
- New features include a native keyring mechanism to store account
- informations in a single-pass symmetric encrypted file.
- Minor updates to the documentation.
-
-Jaro Mail 1.1 - 18 October 2012 - Slick bastard
-
- Lots of bugfixes, code cleanups and usability improvements are
- paving the way for some new powerful features.
-
- The addressbook system has been enhanced to permit editing of the
- entries in white and blacklist, plus import and export of VCards
- is now possible.
-
- The use of GnuPG in Mutt is fixed, along with performance
- and usability improvements also to search.
-
- Vim is now used as default editor, configured to properly format
- emails with paragraph justification.
-
- More improvements were done also to the management of multiple
- accounts, mailbox filtering, maildir merge and backup.
-
-Jaro Mail 1.0 - 18 June 2012 - E-Data addict
-
- Software development went forward in a rather passionate way,
- mostly motivated by the author's need to backup his rather big
- archive of e-mails. So this release's focus is on stability,
- search and backup features and a rather deep refactoring of the
- codebase.
-
- Mairix has been added as an integrated search engine.
-
- Backup is possible also using search expressions (see manual)
-
- Some new modules in statistics implement jquery reports.
-
- Code is modularized in pre-compiled zsh modules.
-
- Extensive testing has proven the whole setup to be stable and
- ready for production use, hence the 1.0 release.
-
-Jaro Mail 0.9 - 06 May 2012 - The rush of the unemployed
-
- After getting recently unemployed because of European austerity
- cuts (and because of not working in a bank), Jaromil followed up
- with a full pijama coding session that lasted about a week,
- hammering out most issues that make now this software enter BETA
- stage, while starting to use it for real.
-
- This is the first public release of Jaro Mail, it comes with a
- User Manual and lots of usability fixes over the previous, it was
- tested on GNU and OSX operating systems.
-
-
-Jaro Mail 0.1 - 29 May 2012 - Initial release
-
- After a dozen years of development and use, Jaromil releases his
- own e-mail and mailinglist desktop setup.
-
- While doing so, J. asked his friend and PhD colleague Max
- Kazemzadeh how he should call it, and Max replied: Jaro Mail! :^D
diff --git a/KNOWN_BUGS.md b/KNOWN_BUGS.md
@@ -0,0 +1,13 @@
+# Known bugs for Jaro Mail
+
+## 1.3.1
+
+locking release time problems occurring often on `jaro send`
+
+```
+[!] forced removal of lock left by pid 8851: msmtp.mail.dyne.org.12Mar14.22032
+/dev/shm/tmp.jaromail.jrml/msmtp.mail.dyne.org.12Mar14.22032: fatal: could not lstat: No such file or directory
+```
+
+When occurring, first mail in queue is sent, next one not.
+
diff --git a/README.md b/README.md
@@ -0,0 +1,202 @@
+
+ oo oo dP
+ 88
+ dP .d8888b. 88d888b. .d8888b. 88d8b.d8b. .d8888b. dP 88
+ 88 88' `88 88' `88 88' `88 88'`88'`88 88' `88 88 88
+ 88 88. .88 88 88. .88 88 88 88 88. .88 88 88
+ 88 `88888P8 dP `88888P' dP dP dP `88888P8 dP dP
+ 88~ooooooooooooooooooooooooooooooooooooooooooooooooooooo
+ odP your humble and faithful electronic postman
+
+*A commandline tool to easily and privately handle your e-mail*
+
+Latest Version: **1.3.1**
+
+Website: http://dyne.org/software/jaro-mail
+
+# INTRODUCTION
+
+JaroMail is an integrated suite of interoperable tools for GNU/Linux
+and Apple/OSX to manage e-mail communication in a private and efficient
+way, without relying too much on on-line services, in fact encouraging
+users to store e-mail locally.
+
+Rather than reinventing the wheel, JaroMail reuses existing free and
+open source tools working since more than 10 years:
+
+* ZShell :: scripting language
+* Mutt :: Mail User Agent
+* Fetchmail :: Mail Transport Agent
+* Procmail :: Filtering Agent
+* MSmtp :: the mini SMTP
+* Mairix :: search engine
+* ABook :: addressbook
+* Elinks :: HTML rendering
+
+A round-up on JaroMail features follows:
+
+* Minimalistic interface with automatic threading
+* Targets intensive usage of mailinglists
+* Does whitelisting and integrates addressbooks
+* Can do search and backup using easy expressions
+* Automatically generates filter rules for procmail and sieve
+* Computes and shows statistics on mail traffic
+* Secure password storage (GPG native, OSX and Gnome keyrings)
+* Stores e-mails locally in a reliable format (Maildir)
+* Defers connections, all operations run off-line
+* Checks SSL server certificates (imap, smtp)
+* Supports strong encryption messaging (GnuPG)
+* Is multi platform: GNU/Linux/BSD, Apple/OSX
+* Old school, used by its author for the past 15 years
+
+# INSTALL
+
+**Apple/OSX** users can simply drag JaroMail into /Applications
+When started JaroMail opens a Terminal window preconfigured with its
+environment, to activate it for any terminal add this to `~/.profile`:
+```
+export PATH=/Applications/JaroMail.app/Contents/Resources/jaro/bin:$PATH
+```
+
+**GNU/Linux** users can run `make` to install all needed components (done automatically, requires root) and compile auxiliary tools. Once compiled then `make install` will put JaroMail in `/usr/local`.
+
+The dependencies to be installed on the system for JaroMail are
+* build: `bison flex make autoconf automake sqlite3 libgnome-keyring-dev`
+* run: `procmail fetchmail msmtp mutt mairix pinentry abook wipe`
+
+Bare in mind **you need to read the Manual**: this software is not
+graphical, it is not meant to be intuitive, does not contains eyecandies (except for stats on mail traffic). JaroMail is operated via Terminal, configured in plain text and overall made by geeks for geeks.
+
+# USAGE instructions
+
+See the commandline help:
+```
+ jaro -h
+```
+When in doubt, make sure you read the User's Manual, it is important.
+
+Download the PDF: https://files.dyne.org/jaromail/jaromail-manual.pdf
+
+Or browse online the latest version:
+https://github.com/dyne/JaroMail/blob/master/doc/jaromail-manual.org
+
+# DEVELOPERS
+
+All revisioned in Git, see: https://github.com/dyne/JaroMail
+
+Pull requests and patches welcome, for an overview of current plans see [TODO](TODO.md)
+
+Our chat channel is **#dyne** on https://irc.dyne.org
+
+Make sure to idle in that channel, answers take some time to come.
+
+We are all idling artists.
+
+# DONATE
+
+Money donations are very welcome and well needed.
+
+By donating you will encourage further development.
+
+ https://www.dyne.org/donate
+
+# ACKNOWLEDGEMENTS
+
+The JaroMail software and user's manual is conceived, designed and put together with a substantial amount of ZShell scripts and some C code by Denis Roio aka [Jaromil](http://jaromil.dyne.org).
+
+JaroMail makes use of many external components to work and here below there is a non-inclusive list of those, with authors and contributors.
+
+## Mutt
+
+The Mutt sourcecode included is maintained by Antonio Radici
+<antonio@dyne.org> who is also the original maintainer of the Debian
+package. Here below the list of Mutt authors:
+
+```
+ Copyright (C) 1996-2007 Michael R. Elkins <me@cs.hmc.edu>
+ Copyright (C) 1996-2002 Brandon Long <blong@fiction.net>
+ Copyright (C) 1997-2008 Thomas Roessler <roessler@does-not-exist.org>
+ Copyright (C) 1998-2005 Werner Koch <wk@isil.d.shuttle.de>
+ Copyright (C) 1999-2009 Brendan Cully <brendan@kublai.com>
+ Copyright (C) 1999-2002 Tommi Komulainen <Tommi.Komulainen@iki.fi>
+ Copyright (C) 2000-2004 Edmund Grimley Evans <edmundo@rano.org>
+ Copyright (C) 2006-2008 Rocco Rutte <pdmef@gmx.net>
+```
+
+## Mairix
+
+The Mairix search engine is licensed GNU GPL v2, made by:
+
+```
+ Copyright (C) Richard P. Curnow 2002,2003,2004,2005,2006,2007,2008
+ Copyright (C) Sanjoy Mahajan 2005
+ Copyright (C) James Cameron 2005
+ Copyright (C) Paul Fox 2006
+```
+
+With contributions by: Anand Kumria, André Costa, Andreas Amann, Andre
+Costa, Aredridel, Balázs Szabó, Bardur Arantsson, Benj. Mako Hill,
+Chris Mason, Christoph Dworzak, Christopher Rosado, Chung-chieh Shan,
+Claus Alboege, Corrin Lakeland, Dan Egnor, Daniel Jacobowitz, Dirk
+Huebner, Ed Blackman, Emil Sit, Felipe Gustavo de Almeida, Ico
+Doornekamp, Jaime Velasco Juan, James Leifer, Jerry Jorgenson, Joerg
+Desch, Johannes Schindelin, Johannes Weißl, John Arthur Kane, John
+Keener, Jonathan Kamens, Josh Purinton, Karsten Petersen, Kevin
+Rosenberg, Mark Hills, Martin Danielsson, Matthias Teege, Mikael
+Ylikoski, Mika Fischer, Oliver Braun, Paramjit Oberoi, Paul Fox, Peter
+Chines, Peter Jeremy, Robert Hofer, Roberto Boati, Samuel Tardieu,
+Sanjoy Mahajan, Satyaki Das, Steven Lumos, Tim Harder, Tom Doherty,
+Vincent Lefevre, Vladimir V. Kisil, Will Yardley, Wolfgang
+Weisselberg.
+
+## Procmail
+
+Procmail was originally designed and developed by Stephen R. van den
+Berg. The Procmail library collection we are including is developed
+and maintained by Jari Aalto.
+
+## MSmtp
+
+MSmtp is developed and maintained by Martin Lambers.
+
+The RFC 822 address parser (fetchaddr) is originally written by
+Michael Elkins for the Mutt MUA.
+
+## ABQuery
+
+The gateway to Apple/OSX addressbook (ABQuery) was written by Brendan
+Cully and just slightly updated for our distribution.
+
+## Stats modules
+We are also including some (experimental, still) modules for statistical
+visualization using JQuery libraries:
+
+```
+Timecloud is Copyright (C) 2008-2009 by Stefan Marsiske
+TagCloud version 1.1.2 (c) 2006 Lyo Kato <lyo.kato@gmail.com>
+ExCanvas is Copyright 2006 Google Inc.
+jQuery project is distributed by the JQuery Foundation under the
+ terms of either the GNU General Public License (GPL) Version 2.
+The Sizzle selector engine is held by the Dojo Foundation and is
+ licensed under the MIT, GPL, and BSD licenses.
+JQuery.sparkline 2.0 is licensed under the New BSD License
+Visualize.JQuery by Scott Jehl Copyright (c) 2009 Filament Group
+```
+
+# Disclaimer
+
+ JaroMail is Copyright (C) 2010-2014 Denis Roio <jaromil@dyne.org>
+
+ This source code is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Public License as published by
+ the Free Software Foundation; either version 3 of the License, or
+ (at your option) any later version.
+
+ This source code is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ Please refer to the GNU Public License for more details.
+
+ You should have received a copy of the GNU Public License along with
+ this source code; if not, write to:
+ Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
diff --git a/README.txt b/README.txt
@@ -1,194 +0,0 @@
-
- oo oo dP
- 88
- dP .d8888b. 88d888b. .d8888b. 88d8b.d8b. .d8888b. dP 88
- 88 88' `88 88' `88 88' `88 88'`88'`88 88' `88 88 88
- 88 88. .88 88 88. .88 88 88 88 88. .88 88 88
- 88 `88888P8 dP `88888P' dP dP dP `88888P8 dP dP
- 88~ooooooooooooooooooooooooooooooooooooooooooooooooooooo
- odP your humble and faithful electronic postman v 1.3.1
-
-A commandline tool to easily and privately handle your e-mail
-
-Shine up you Mutt setup! For the latest information see:
-
- http://jaromail.dyne.org
-
-* INTRODUCTION
-
-Jaro Mail is an integrated suite of interoperable tools for GNU/Linux
-and Apple/OSX to manage e-mail communication in a private and efficient
-way, without relying too much on on-line services, in fact encouraging
-users to store e-mail locally.
-
-Rather than reinventing the wheel, Jaro Mail reuses existing free and
-open source tools working since more than 10 years:
-
-- Mutt :: Mail User Agent
-- Fetchmail :: Mail Transport Agent
-- Procmail :: Filtering Agent
-- MSmtp :: the mini SMTP
-- Mairix :: search engine
-- ABook :: addressbook
-- Z Shell :: scripting language
-- Elinks :: HTML rendering
-
-A round-up on Jaro Mail features follows:
-
-- Minimalistic interface with automatic threading
-- Targets intensive usage of mailinglists
-- Does whitelisting and integrates addressbooks
-- Can do search and backup by expressions
-- Automatically generates filter rules (procmail and sieve)
-- Computes and shows statistics on mail traffic (experimental)
-- Secure password storage (native, OSX and Gnome keyrings)
-- Stores e-mails locally in a reliable format (maildir)
-- Provides advanced maildir management tools
-- Defers connections for off-line operations
-- Checks SSL server certificates (imap, smtp)
-- Supports strong encryption messaging (GnuPG)
-- Is multi platform: GNU/Linux/BSD, Apple/OSX
-- Old school, used by its author for the past 10 years
-
-* INSTALL
-
-Apple/OSX users can simply drag JaroMail into /Applications
-
-Bare in mind you need to read the Manual: this software is not
-graphical, yet has a high productive potential.
-JaroMail is operated via Terminal, configured in plain text and overall
-made by geeks for geeks. Beware.
-When started JaroMail opens a Terminal window preconfigured with its
-environment, to activate it for any terminal add this to ~/.profile:
-export PATH=/Applications/JaroMail.app/Contents/Resources/jaro/bin:$PATH
-
-
-
-GNU/Linux users can use the build/build-gnu.sh script to install
-dependencies and build all necessary binaries. This is still dirty, it
-will likely never be really packaged by zealots into their distros,
-but works well for those who use it. It might get better in some
-future. After build, use the ./install.sh script to put JaroMail in
-$HOME/Mail or use an argument to install it in some other location.
-
-
-Jaro Mail is completely reentrant: if you install it in multiple
-locations you can have completely separated setups, with multiple
-identities and different filters.
-
-* USAGE instructions
-
-See the commandline help:
-
- jaro -h
-
-When in doubt, make sure you read the User's Manual, it is important.
-
-Download the PDF https://files.dyne.org/jaromail/jaromail-manual.pdf
-
-Or browse online the latest version
-https://github.com/dyne/JaroMail/blob/master/doc/jaromail-manual.org
-
-
-* DEVELOPERS
-
-All revisioned in Git, see https://github.com/dyne/JaroMail
-
-Pull requests and patches welcome.
-
-Our chat channel is #dyne on https://irc.dyne.org
-
-Make sure to idle in that channel, answers take some time.
-
-We are all idling artists.
-
-
-* DONATE
-
-Money donations are very welcome and well needed
-they will encourage further development.
-
- https://www.dyne.org/donate
-
-
-
-* ACKNOWLEDGEMENTS
-
-JaroMail is conceived, designed and put together with a substantial
-amount of ZShell scripts and some C code by Denis Roio aka Jaromil
-
-The Mutt sourcecode included is maintained by Antonio Radici
-<antonio@dyne.org> who is also the original maintainer of the Debian
-package. Here below the list of Mutt authors:
-
- Copyright (C) 1996-2007 Michael R. Elkins <me@cs.hmc.edu>
- Copyright (C) 1996-2002 Brandon Long <blong@fiction.net>
- Copyright (C) 1997-2008 Thomas Roessler <roessler@does-not-exist.org>
- Copyright (C) 1998-2005 Werner Koch <wk@isil.d.shuttle.de>
- Copyright (C) 1999-2009 Brendan Cully <brendan@kublai.com>
- Copyright (C) 1999-2002 Tommi Komulainen <Tommi.Komulainen@iki.fi>
- Copyright (C) 2000-2004 Edmund Grimley Evans <edmundo@rano.org>
- Copyright (C) 2006-2008 Rocco Rutte <pdmef@gmx.net>
-
-The Mairix search engine is licensed GNU GPL v2, made by:
-
- Copyright (C) Richard P. Curnow 2002,2003,2004,2005,2006,2007,2008
- Copyright (C) Sanjoy Mahajan 2005
- Copyright (C) James Cameron 2005
- Copyright (C) Paul Fox 2006
-
-With contributions by: Anand Kumria, André Costa, Andreas Amann, Andre
-Costa, Aredridel, Balázs Szabó, Bardur Arantsson, Benj. Mako Hill,
-Chris Mason, Christoph Dworzak, Christopher Rosado, Chung-chieh Shan,
-Claus Alboege, Corrin Lakeland, Dan Egnor, Daniel Jacobowitz, Dirk
-Huebner, Ed Blackman, Emil Sit, Felipe Gustavo de Almeida, Ico
-Doornekamp, Jaime Velasco Juan, James Leifer, Jerry Jorgenson, Joerg
-Desch, Johannes Schindelin, Johannes Weißl, John Arthur Kane, John
-Keener, Jonathan Kamens, Josh Purinton, Karsten Petersen, Kevin
-Rosenberg, Mark Hills, Martin Danielsson, Matthias Teege, Mikael
-Ylikoski, Mika Fischer, Oliver Braun, Paramjit Oberoi, Paul Fox, Peter
-Chines, Peter Jeremy, Robert Hofer, Roberto Boati, Samuel Tardieu,
-Sanjoy Mahajan, Satyaki Das, Steven Lumos, Tim Harder, Tom Doherty,
-Vincent Lefevre, Vladimir V. Kisil, Will Yardley, Wolfgang
-Weisselberg.
-
-Procmail was originally designed and developed by Stephen R. van den
-Berg. The Procmail library collection we are including is developed
-and maintained by Jari Aalto.
-
-MSmtp is developed and maintained by Martin Lambers.
-
-The RFC 822 address parser (fetchaddr) is originally written by
-Michael Elkins for the Mutt MUA.
-
-The gateway to Apple/OSX addressbook (ABQuery) was written by Brendan
-Cully and just slightly updated for our distribution.
-
-We are also including some (experimental, still) modules for statistical
-visualization using JQuery libraries:
-
-Timecloud is Copyright (C) 2008-2009 by Stefan Marsiske
-TagCloud version 1.1.2 (c) 2006 Lyo Kato <lyo.kato@gmail.com>
-ExCanvas is Copyright 2006 Google Inc.
-jQuery project is distributed by the JQuery Foundation under the
- terms of either the GNU General Public License (GPL) Version 2.
-The Sizzle selector engine is held by the Dojo Foundation and is
- licensed under the MIT, GPL, and BSD licenses.
-JQuery.sparkline 2.0 is licensed under the New BSD License
-Visualize.JQuery by Scott Jehl Copyright (c) 2009 Filament Group
-
-# JaroMail is Copyright (C) 2010-2013 Denis Roio <jaromil@dyne.org>
-#
-# This source code is free software; you can redistribute it and/or
-# modify it under the terms of the GNU Public License as published by
-# the Free Software Foundation; either version 3 of the License, or
-# (at your option) any later version.
-#
-# This source code is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-# Please refer to the GNU Public License for more details.
-#
-# You should have received a copy of the GNU Public License along with
-# this source code; if not, write to:
-# Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
diff --git a/TODO b/TODO
@@ -1,57 +0,0 @@
-
- Contribute code or donate to complete this TODO:
- https://dyne.org/donate
-
-* Solve imap idle timeout on Mutt
- peek command should use fetchmail --idle instead of mutt -f imaps
- this way we can also implement desktop notifications
-
-* Outbox as maildir
- also multiple outboxes for different send programs
- for example anonymous/ for the mixmaster queue
-
-* Anonymizer
- + Built-in support for Mixmaster
-
-* Substitute procmail with a simple C filter
- we just filter From, To:, CC: and mailman headers
- a small C program using sqlite3 should be enough
-
-* Import of addresses from GnuPG keyring
-
-* TBT
- time based text, all included in html mails
-
-* Install
- + Full integration with the Tomb process creation
- + integrate install/setup command in jaro
-
-* Mouse enable MUA
- mutt or mu in debian?
- + Find out how to make mouse selection work
-
-* Speedmail or Quickmail
- write down a mail from commandline and send it right away (if online)
- doesn't uses Mutt to generate the mail body
- but might read Mutt.txt configuration for headers and such
-
-* WIP Stats
- + Have some fancy statistics
- use timecloud for a jquery visualization
- + include anu arg's mailinglist statistics
-
-* REJECTED Local Bayesian learning spam filter (bogofilter)
-
-* DONE GTD
- + Integration with org-remember via org-protocol
- or maybe just to taskwarrior
- : Solved implementing our own system: the simple remember folder
-
-* DONE Filtering
- filter out bounces in some zz.bounces - header:
-: Sender: mailman-bounces@
-
-* DONE Maildirs
- + Remove duplicates from maildirs (garbage collection)
- + Backup system with expiration date
-
diff --git a/TODO.md b/TODO.md
@@ -0,0 +1,81 @@
+
+# TODO notes for Jaro Mail
+
+ Contribute code or donate to complete this TODO
+ https://dyne.org/donate
+
+
+## Peek to open imap folders with reverse Date ordering
+ when open, imap folders should list emails without threading
+ this is really intended for a peek
+
+## CC: detection
+ filter in known/ also emails sent to private addresses in cc:
+
+## Resident indexing
+ Mairix search now re-indexes all mailfolder before search
+ split this into two operations: index (to refresh) and search
+ most times we search for old stuff which might be already indexed
+
+ MAYBE: add possibility to re-index after fetch
+
+ CAVEAT: progressive indexing in Mairix does not work,
+ must start a new one every time
+
+## Sieve filters for first level naming of mailinglists
+ consolidate the use of first level naming of filtered maildirs
+ (a la newsgroups) and use it also for sieve filters so that imap
+ folders will be created to contain those.
+
+ the peek function then should be started up with a list of those
+ folders so that imap can be peeked with the same hierarchy of
+ downloaded emails.
+
+## Solve imap idle timeout on Mutt
+ peek command should use fetchmail --idle instead of mutt -f imaps
+ this way we can also implement desktop notifications
+
+ PLAN: use isync and open local maildirs
+
+## Mixmaster
+ basically is an almost finished implementation, only thing
+ missing is to clear out the header handling between jaromail and mutt
+
+## Multiple outboxes
+ handle different send programs
+ for example anonymous/ for the mixmaster queue
+
+## Substitute procmail with a simple C filter
+ we just filter From, To:, CC: and mailman headers
+
+ a small C program using sqlite3 should be enough
+
+## Investigate integration with Mailpile's frontend
+
+## Import of addresses from GnuPG keyring
+
+## TBT
+ time based text, all included in html mails
+
+## Install
+ * Full integration with the Tomb process creation
+ * integrate install/setup command in jaro
+
+## Mouse enable MUA
+ mutt or mu in debian?
+ * Find out how to make mouse selection work
+
+## Speedmail or Quickmail
+ write down a mail from commandline and send it right away (if online)
+ doesn't uses Mutt to generate the mail body
+ but might read Mutt.txt configuration for headers and such
+
+## WIP Stats
+ * Moar some fancy statistics
+
+ use timecloud for a jquery visualization
+
+ * include anu arg's mailinglist statistics
+
+
+
diff --git a/doc/jaromail-manual.org b/doc/jaromail-manual.org
@@ -271,6 +271,8 @@ e-mail is selected on the index: the sender indicated in the From:
field will be downgraded to the very bottom of your priorities, closes
to spam than the rest, the most infamous *zz.blacklist/* folder.
+To remove addresses from the blacklist, use *jaro abook blacklist* which will open the addressbook editor where you can delete, add and modify entries.
+
** Addressbook
What we call addressbook here basically consists of both the whitelist
diff --git a/src/zlibs/addressbook b/src/zlibs/addressbook
@@ -462,11 +462,12 @@ EOF
abookrc=$TMPDIR/abookrc.$datestamp.$RANDOM
cat <<EOF > $abookrc
set autosave=true
-set emailpos=35
-set extra_column=-1
set mutt_command=jaro
set sort_field=name
EOF
+# new abook supports also:
+# set emailpos=35
+# set extra_column=-1
func "ready to launch abook."
diff --git a/src/zlibs/email b/src/zlibs/email
@@ -64,12 +64,17 @@ queue() {
else
# there are some mails to be sent in the old format outbox
# preserve them while migrating to the new format
+ # this code is less interesting, since it handles an old
+ # format in JaroMail
tmppp=$TMPDIR/jaro-outbox-migration-$RANDOM
mkdir -p $tmppp
mv $MAILDIRS/outbox/* $tmppp/
rmdir $MAILDIRS/outbox
maildirmake $MAILDIRS/outbox
mkdir -p $MAILDIRS/outbox/send
+ # here we devince two useful arrays:
+ # bodies: the list of mail bodies to send
+ # corresponding to files with same name and extension .msmtp
bodies=(`find $tmppp -type f -name '*.mail'`)
rcpt=(`find $tmppp -type f -name '*.msmtp'`)
for i in ${bodies}; do mv $i $MAILDIRS/outbox/new/; done
