Re: Hooks for moving an article and for setting it expirable

[Eric Abrahamsen <eric@ericabrahamsen.net>]

Christopher Culver <crculver@christopherculver.com> writes:

> Christopher Culver <crculver@christopherculver.com> writes:
>> The problem now is that I have no idea what type gnus-data-header
>> returns. Emacs' describe-function is not helpful. Is it a string
>> equivalent to the header portion of the maildir file? Is it a key-values
>> list, and if so, what the keys?
>
> Printing the object to a buffer, I see that gnus-data-header returns an
> array (vector table), where the article number is the first item (index
> 0). So, now I can work with this. But it is a pity that it is not
> documented.

In gnus-sum.el there are a series of `gnus-data-*' functions for working
with the data vector, there's a `gnus-data-number', for instance. Of
course, all that does is take the car of the vector! But if you're doing
more than that, it's probably better to use the pre-made functions.

It's true, there's not a lot of documentation in this area, either in
the manual or the docstrings. Have you read the Gnus Reference Guide
section of the info manual? It's fairly well hidden -- I only recently
found it, in the Appendices section -- but it explains some of the
internals. Not the data vector, though. There's also a
`gnus-with-article' macro, but that actually edits the article, and then
replaces the old one with the newly edited version.

Eric