From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Adding testing information to CONTRIBUTE Date: Thu, 05 Mar 2015 18:41:54 +0200 Message-ID: <83zj7ro0q5.fsf@gnu.org> References: <1425553346.2108.2@mail.samertm.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1425573756 15344 80.91.229.3 (5 Mar 2015 16:42:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 5 Mar 2015 16:42:36 +0000 (UTC) Cc: stephen_leake@stephe-leake.org, emacs-devel@gnu.org To: Samer Masterson Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Mar 05 17:42:14 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 1YTYqk-000655-9S for ged-emacs-devel@m.gmane.org; Thu, 05 Mar 2015 17:42:14 +0100 Original-Received: from localhost ([::1]:52866 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YTYqj-0000cU-Jp for ged-emacs-devel@m.gmane.org; Thu, 05 Mar 2015 11:42:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59530) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YTYqV-0000YN-W5 for emacs-devel@gnu.org; Thu, 05 Mar 2015 11:42:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YTYqS-0000KW-QP for emacs-devel@gnu.org; Thu, 05 Mar 2015 11:41:59 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:38432) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YTYqS-0000KF-JM for emacs-devel@gnu.org; Thu, 05 Mar 2015 11:41:56 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0NKQ00K00ZCGC100@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Thu, 05 Mar 2015 18:41:54 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NKQ00KRUZPU4HB0@a-mtaout20.012.net.il>; Thu, 05 Mar 2015 18:41:54 +0200 (IST) In-reply-to: <1425553346.2108.2@mail.samertm.com> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.166 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:183672 Archived-At: > Date: Thu, 05 Mar 2015 03:02:26 -0800 > From: Samer Masterson > Cc: stephen_leake@stephe-leake.org > > As a new contributor, I have no idea how to run or write tests for Emacs, which > means I end up testing my patches manually and miss bugs. I could try to learn > how Emacs uses tests on my own, but it would benefit future new contributors if > we added a section on testing to CONTRIBUTE. > > Here is what I would want to see: > - How to write tests, with a pointer to an internal Emacs package that has > idiomatic and comprehensive tests. > - How to run tests on the entire tree and on individual files. > - A pointer to an info page on the testing framework/pattern that most internal > Emacs packages use. Most of this is described in ert.info, which I presume you've read. I agree that CONTRIBUTE should mention that manual (right near the place that it mentions "Tips" and "GNU Emacs Internals").