Re: backend stuff for the manual

[prj@po.cwru.edu (Paul Jarc)]

Kai.Grossjohann@CS.Uni-Dortmund.DE (Kai Großjohann) wrote:
> What do you think of the following paragraph?

I like it.

>| The result data from this function should be all groups that were

Maybe "should include all groups"?  Just to be a bit less
contradictory with the note that follows.

>| in the active buffer format.  (It is okay for this function to return
>| `too many' groups; some backends might find it cheaper to return the
>| full list of groups, rather than just the new groups.  But don't do this
>| for backends with too many groups.)

Maybe also add a note about how to predict whether there are "too
many" groups:

If the user controls the server's list of groups (as with mail
backends), then there are likely to be few groups.  If the user does
not control the server's list of groups (as with NNTP), then there are
likely to be many groups that aren't of interest.

Or maybe not.


paul