From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Nikolaus Rath Newsgroups: gmane.emacs.devel Subject: Re: Documentation of nnoo.el Date: Sun, 12 Jul 2015 11:22:28 -0700 Message-ID: <87lhels0bf.fsf@vostro.rath.org> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1436725364 15380 80.91.229.3 (12 Jul 2015 18:22:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 12 Jul 2015 18:22:44 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jul 12 20:22:44 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZELti-000828-BI for ged-emacs-devel@m.gmane.org; Sun, 12 Jul 2015 20:22:42 +0200 Original-Received: from localhost ([::1]:51600 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZELth-00072G-H3 for ged-emacs-devel@m.gmane.org; Sun, 12 Jul 2015 14:22:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55867) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZELta-000727-JP for emacs-devel@gnu.org; Sun, 12 Jul 2015 14:22:38 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZELtW-0001FZ-88 for emacs-devel@gnu.org; Sun, 12 Jul 2015 14:22:34 -0400 Original-Received: from ebox.rath.org ([2600:3c01::f03c:91ff:fe69:db07]:44406) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZELtW-0001FR-1s for emacs-devel@gnu.org; Sun, 12 Jul 2015 14:22:30 -0400 Original-Received: from vostro ([192.168.12.4] helo=vostro.rath.org) by ebox.rath.org with esmtps (TLSv1.2:DHE-RSA-AES256-GCM-SHA384:256) (Exim 4.80) (envelope-from ) id 1ZELtU-0005TG-Ko for emacs-devel@gnu.org; Sun, 12 Jul 2015 18:22:28 +0000 Original-Received: by vostro.rath.org (Postfix, from userid 1000) id 4144DEC5D4F; Sun, 12 Jul 2015 11:22:28 -0700 (PDT) Mail-Copies-To: never Mail-Followup-To: emacs-devel@gnu.org In-Reply-To: (Lars Magne Ingebrigtsen's message of "Sun, 12 Jul 2015 19:55:49 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.4 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2600:3c01::f03c:91ff:fe69:db07 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:187831 Archived-At: On Jul 12 2015, Lars Magne Ingebrigtsen wrote: > Stefan Monnier 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 --=20 GPG encrypted emails preferred. Key id: 0xD113FCAC3C4E599F Fingerprint: ED31 791B 2C5C 1613 AF38 8B8A D113 FCAC 3C4E 599F =C2=BBTime flies like an arrow, fruit flies like a Banana.=C2= =AB