mbox.protocol proposed patch

[Fabrice Ménard-2]

Hi,

The purpose of this (very) tiny patch is to not confuse khelpcenter if there
is no documentation for that protocol.

Best regards,
--
Fabrice Ménard

--- kdepimlibs/kioslave/mbox/mbox.protocol.old 2009-11-04 14:59:54.000000000 +0100
+++ kdepimlibs/kioslave/mbox/mbox.protocol 2009-11-04 15:00:03.000000000 +0100
@@ -10,5 +10,4 @@ makedir=false
 deleting=false
 Icon=mail-folder-inbox
 maxInstances=2
-DocPath=
 Class=:local

_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

Fabrice Ménard wrote:

> Hi,
>
> The purpose of this (very) tiny patch is to not confuse khelpcenter if
> there is no documentation for that protocol.

Please commit (or write the documentation =;) )

Cheers,

Bertjan

_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

[Burkhard Lück]

Am Donnerstag 05 November 2009 18:10:33 schrieb Bertjan Broeksema:
> Fabrice Ménard wrote:
> > Hi,
> >
> > The purpose of this (very) tiny patch is to not confuse khelpcenter if
> > there is no documentation for that protocol.
>
> Please commit (or write the documentation =;) )
>
With this patch I get still this error message in khelpcenter:

"There is no documentation available for /index.html."

So that is no solution, please write a few sentences about mbox and I will
markup it as docbook article.

--
Burkhard Lück
_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

Hi,

I just realized that the commit was in the mbox kioslave, which is somewhat
unrelated to the akonadi resource. probably it should be ported to libmbox.

Anyways, a couple of lines (Feel free to ask for clarification if needed):

== snip ==
The mbox file format is an simple but rather inefficient way to store email
messages. All messages are appended after each other in the same file
separated by a special separator line. This gets especially expensive when
you have many emails in the same file. This resource is provided mostly for
backwards compatibility.
== /snip ==

Burkhard Lück wrote:

> Am Donnerstag 05 November 2009 18:10:33 schrieb Bertjan Broeksema:
>> Fabrice Ménard wrote:
>> > Hi,
>> >
>> > The purpose of this (very) tiny patch is to not confuse khelpcenter if
>> > there is no documentation for that protocol.
>>
>> Please commit (or write the documentation =;) )
>>
> With this patch I get still this error message in khelpcenter:
>
> "There is no documentation available for /index.html."
>
> So that is no solution, please write a few sentences about mbox and I will
> markup it as docbook article.
>

_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

[Burkhard Lück]

Am Donnerstag 05 November 2009 19:55:20 schrieb Bertjan Broeksema:

> Hi,
>
> I just realized that the commit was in the mbox kioslave, which is somewhat
> unrelated to the akonadi resource. probably it should be ported to libmbox.
>
> Anyways, a couple of lines (Feel free to ask for clarification if needed):
>
> == snip ==
> The mbox file format is an simple but rather inefficient way to store email
> messages. All messages are appended after each other in the same file
> separated by a special separator line. This gets especially expensive when
> you have many emails in the same file. This resource is provided mostly for
> backwards compatibility.
> == /snip ==
>

Thanks, docbook commited.

And now to the last missing documentation for a protocol in kdepimlibs:

"Sieve is a language that can be used to create filters for emails on imap
servers.

The sieve protocol...

"
Please add the missing info.

--
Burkhard Lück
_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

On Friday 06 November 2009 07:10:30 Burkhard Lück wrote:
> And now to the last missing documentation for a protocol in kdepimlibs:
>
> "Sieve is a language that can be used to create filters for emails on imap
> servers.
>
> The sieve protocol...
>
> "

well, it can be any server not just imap servers. Sure there's no folder's on
pop but redirect/deletes still work in sieve scripts.

s/imap servers/the server/

suggest

"Sieve is a protocol that is used to manage filters for email. The filters are
stored and run on the email server."
_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

[Burkhard Lück]

Am Freitag 06 November 2009 05:43:23 schrieb Daniel Black:

> On Friday 06 November 2009 07:10:30 Burkhard Lück wrote:
> > And now to the last missing documentation for a protocol in kdepimlibs:
> >
> > "Sieve is a language that can be used to create filters for emails on
> > imap servers.
> >
> > The sieve protocol...
> >
> > "
>
> well, it can be any server not just imap servers. Sure there's no folder's
>  on pop but redirect/deletes still work in sieve scripts.
>
> s/imap servers/the server/
>
> suggest
>
> "Sieve is a protocol that is used to manage filters for email. The filters
>  are stored and run on the email server."

Used this for the article, thanks.

--
Burkhard Lück
_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

[Ingo Klöcker]

On Thursday 05 November 2009, Bertjan Broeksema wrote:

> Hi,
>
> I just realized that the commit was in the mbox kioslave, which is
> somewhat unrelated to the akonadi resource. probably it should be
> ported to libmbox.
>
> Anyways, a couple of lines (Feel free to ask for clarification if
> needed):
>
> == snip ==
> The mbox file format is an simple but rather inefficient way to store
> email messages. All messages are appended after each other in the
> same file separated by a special separator line. This gets especially
> expensive when you have many emails in the same file. This resource
> is provided mostly for backwards compatibility.
> == /snip ==

"resource" isn't really the correct term. I propose to scratch the last
sentence. Support for the mbox format is important for migrating mail
from one mail client to the other because it is supported by almost all
mail clients.

AFAIK, the mbox kioslave was used exclusively by the mailbox watcher
korn which was never ported to KDE 4. I wonder whether it is still used
nowadays. But since a kioslave is basically public API we will probably
not be able to get rid of it before KDE 5.


Regards,
Ingo

> Burkhard Lück wrote:
> > Am Donnerstag 05 November 2009 18:10:33 schrieb Bertjan Broeksema:
> >> Fabrice Ménard wrote:
> >> > Hi,
> >> >
> >> > The purpose of this (very) tiny patch is to not confuse
> >> > khelpcenter if there is no documentation for that protocol.
> >>
> >> Please commit (or write the documentation =;) )
> >
> > With this patch I get still this error message in khelpcenter:
> >
> > "There is no documentation available for /index.html."
> >
> > So that is no solution, please write a few sentences about mbox and
> > I will markup it as docbook article.
>
> _______________________________________________
> KDE PIM mailing list kde-pim@...
> https://mail.kde.org/mailman/listinfo/kde-pim
> KDE PIM home page at http://pim.kde.org/

_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/

[Burkhard Lück]

Am Freitag 06 novembre 2009 21:19:48 schrieb Ingo Klöcker:

> On Thursday 05 November 2009, Bertjan Broeksema wrote:
> > Hi,
> >
> > I just realized that the commit was in the mbox kioslave, which is
> > somewhat unrelated to the akonadi resource. probably it should be
> > ported to libmbox.
> >
> > Anyways, a couple of lines (Feel free to ask for clarification if
> > needed):
> >
> > == snip ==
> > The mbox file format is an simple but rather inefficient way to store
> > email messages. All messages are appended after each other in the
> > same file separated by a special separator line. This gets especially
> > expensive when you have many emails in the same file. This resource
> > is provided mostly for backwards compatibility.
> > == /snip ==
>
> "resource" isn't really the correct term. I propose to scratch the last
> sentence.

Done, thanks

--
Burkhard Lück
_______________________________________________
KDE PIM mailing list kde-pim@...
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/