Re: Documentation of nnoo.el

[Nikolaus Rath <Nikolaus@rath.org>]

On Jul 12 2015, Lars Magne Ingebrigtsen <larsi@gnus.org> wrote:
> Stefan Monnier <monnier@iro.umontreal.ca> writes:
>
>> nnoo.el is in dire need of some documentation.
>>
>> Could someone add a little bit of:
>> - something in Commentary: describing which are the main entry points
>>   and how to use them,
>> - a docstring for nnoo-definition-alist describing precisely its format,
>> - a description of the MAP arg to defvoo,
>> - ...
>
> Well, there's the "Writing New Back Ends" node in the Gnus manual.  I
> think it should cover most of the basics?

Judging from that documentation, nnoo is only about inheritance, so that
you don't have to redefine identical functions if you want to re-use an
existing backend.

It doesn't explain at all what e.g. nnoo-change-server is good for, or
that nnoo also manages per-server state (which it seems to do, but I'm
not sure).

Best,
-Nikolaus

-- 
GPG encrypted emails preferred. Key id: 0xD113FCAC3C4E599F
Fingerprint: ED31 791B 2C5C 1613 AF38 8B8A D113 FCAC 3C4E 599F

             »Time flies like an arrow, fruit flies like a Banana.«