Re: gnus-registry flags API

[Reiner Steib <reinersteib+gmane@imap.cc>]

On Wed, Dec 19 2007, Ted Zlatanov wrote:

> On Tue, 25 Sep 2007 11:26:08 -0500 Ted Zlatanov <tzz@lifelogs.com> wrote: 
>
> TZ> The frontend functionality I would like:
>
> TZ> - set a flag for an article (this should be a simple function a user can
> TZ> call from a group or message buffer, which grabs the message ID and uses
> TZ> the gnus-registry API afterwards)
>
> TZ> - indicate the article flags somehow (fringe or status line maybe?)
>
> TZ> - add summary line formatting support for arbitrary flags
>
> TZ> Any suggestions or contributions (especially the three items above) are
> TZ> welcome.  Please review and criticize the code if you can, I haven't
> TZ> done Emacs Lisp in a bit :)
>
> I added the essential functions (first on the list) in CVS, now we need
> a status line / summary line integration for these.  

We need documentation in the manual for this as well as for
`gnus-registry.el' in general.  The only hits for "registry" in the
manual are in the context of spam*.el.

BTW: I'd like to switch from `nnmail-split-fancy-with-parent' to
`gnus-registry-split-fancy-with-parent'.  Is there a conversion
function from `nnmail-message-id-cache-file' to
`gnus-registry-cache-file'?

> Note that the MARK here is really any Lisp symbol, so
> 'hello-there-flag and 'goodbye-here-but-I-like-verbosity-flag are
> OK.  Go wild.
>
> gnus-registry-mark-article ARTICLE &optional MARK REMOVE
>
> - if ARTICLE is nil, use current article

When used interactively, the current article should be the default
too.  Now it insists on "Please enter a number.".  Maybe `article'
should be optional?

I did `M-: (gnus-registry-mark-article nil) RET' without initializing
the registry.  AFAICS, this is a no-op -- at least no
~/.gnus.registry.eld was created.  It should probably signal an error.

> - if MARK is nil, use gnus-registry-flag-default (you don't want that,
>   it's boring)

When called interactively, it should prompt for flags with completion.
At least the Mozilla labels ("Important" "Work" "Personal" "To do"
"Later" <http://www.mozilla.org/mailnews/specs/labels/>) should be
offered by default.  The user may add additional flags to this list
and also set arbitrary flags.

> - if REMOVE is t, remove MARK from the flags
>
> gnus-registry-article-marks ARTICLE: get list of marks for the article
>
> - if ARTICLE is nil, use current article

Same remark as for `rs-gnus-summary-line-label-alist'.

> Let me know if you find bugs or inconsistencies.  I am especially
> curious how these should integrate with the other Gnus summary
> functions, and if they should take prefix arguments, etc.

It should accept Gnus' standard process/prefix convention.

Bye, Reiner.
-- 
       ,,,
      (o o)
---ooO-(_)-Ooo---  |  PGP key available  |  http://rsteib.home.pages.de/