From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] CONTRIBUTE - writing tests for understanding internals Date: Tue, 10 Nov 2015 14:58:55 -0800 Message-ID: References: <87twotqxme.fsf@cumego.com> 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 1447196424 22863 80.91.229.3 (10 Nov 2015 23:00:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 10 Nov 2015 23:00:24 +0000 (UTC) Cc: Emacs Developers To: =?utf-8?Q?Przemys=C5=82aw?= Wojnowski Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 11 00:00:18 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 1ZwHt2-0001U3-BX for ged-emacs-devel@m.gmane.org; Tue, 10 Nov 2015 23:59:36 +0100 Original-Received: from localhost ([::1]:36003 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZwHt2-0006LX-Dm for ged-emacs-devel@m.gmane.org; Tue, 10 Nov 2015 17:59:36 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40426) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZwHsX-0006HK-Ha for emacs-devel@gnu.org; Tue, 10 Nov 2015 17:59:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZwHsS-00065m-IY for emacs-devel@gnu.org; Tue, 10 Nov 2015 17:59:05 -0500 Original-Received: from mail-pa0-x232.google.com ([2607:f8b0:400e:c03::232]:33796) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZwHsS-000657-DV for emacs-devel@gnu.org; Tue, 10 Nov 2015 17:59:00 -0500 Original-Received: by padhx2 with SMTP id hx2so10644338pad.1 for ; Tue, 10 Nov 2015 14:58:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:mail-followup-to:mime-version:content-type :content-transfer-encoding; bh=u2P4Sa/d5VK2cKxphIe5SoFHWcMQXD0wiP0Dpf/R5DU=; b=d3R4/+yVzsYyaSU+8DAI7bBrCu0TCQeXE3Eidzw3Wc3511dFF2x9gjE1t/AVJUJBp5 DmWmwmwjawJVWbFOcfFhsH9LjWmm3V/8UCT2U6Brh/28TLNkXeH1pb/f9jwdtm7niEHn vWbxdb//KBmIK6HztbeI6Zb2YNChWAKlIuemuVR67iVL1SkDaJHYUjCBeHy0nAR3W4Gq uRupa8HJ+KKE1HJ+drjTNrsCxoJEi/qqm46BXtM6OSIFUaFWdfs+LfxRLtGlU+c7G97x zMXoGDyV0p0P5wCp0zAE/EY0dPK2UhxRsLNACvEqwKBPKJ4INSmLYyx8N+iuakkZo1I1 /W0A== X-Received: by 10.68.242.105 with SMTP id wp9mr9557888pbc.49.1447196339793; Tue, 10 Nov 2015 14:58:59 -0800 (PST) Original-Received: from Vulcan.attlocal.net (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id tj2sm6122114pab.4.2015.11.10.14.58.58 (version=TLS1 cipher=AES128-SHA bits=128/128); Tue, 10 Nov 2015 14:58:58 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.attlocal.net (Postfix, from userid 501) id A19F210540867; Tue, 10 Nov 2015 14:58:57 -0800 (PST) In-Reply-To: <87twotqxme.fsf@cumego.com> (=?utf-8?Q?=22Przemys=C5=82aw?= Wojnowski"'s message of "Tue, 10 Nov 2015 23:48:41 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (darwin) Mail-Followup-To: =?utf-8?Q?Przemys=C5=82aw?= Wojnowski , Emacs Developers X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:400e:c03::232 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:193991 Archived-At: >>>>> Przemys=C5=82aw Wojnowski writes: +There are at least two good ways to understand Emacs Internal. + +One of them is to read the code, but the nodes "Tips" and "GNU Emacs +Internals" in the Appendix of the Emacs Lisp Reference Manual may also +help. Some source files, such as xdisp.c, have large commentaries +describing the design and implementation in more detail. + +Another way into Emacs Internal is to write tests. This one is more +fun, takes you through Emacs contribution process and increases +Emacs test coverage! Don't think twice! Just some word smithing: There are at least two good ways to start getting familiar with the internals of Emacs: =20=20=20=20 One is to read the code. Some source files, such as xdisp.c, have large commentaries describing the design and implementation in more detail. Another is to visit the nodes "Tips" and "GNU Emacs Internals" in the Appendix of the Emacs Lisp Reference Manual. =20=20=20=20 Yet Another way is to write tests. This can be a lot of fun, introduces you to the Emacs contribution process, and increases Emacs test coverag= e! Don't think twice! If you want to jump in, this is a great way to start. John