From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Samer Masterson Newsgroups: gmane.emacs.devel Subject: Adding testing information to CONTRIBUTE Date: Thu, 05 Mar 2015 03:02:26 -0800 Message-ID: <1425553346.2108.2@mail.samertm.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="=-K0LCaQzHdXRTlWSNdeDO" X-Trace: ger.gmane.org 1425553487 14624 80.91.229.3 (5 Mar 2015 11:04:47 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 5 Mar 2015 11:04:47 +0000 (UTC) Cc: stephen_leake@stephe-leake.org To: Emacs developers Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Mar 05 12:04:34 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 1YTTZw-00079s-8P for ged-emacs-devel@m.gmane.org; Thu, 05 Mar 2015 12:04:32 +0100 Original-Received: from localhost ([::1]:51007 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YTTZv-0004dM-5a for ged-emacs-devel@m.gmane.org; Thu, 05 Mar 2015 06:04:31 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50792) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YTTYB-0001NH-9T for emacs-devel@gnu.org; Thu, 05 Mar 2015 06:02:44 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YTTY5-0005gc-CS for emacs-devel@gnu.org; Thu, 05 Mar 2015 06:02:43 -0500 Original-Received: from ec2-52-0-7-12.compute-1.amazonaws.com ([52.0.7.12]:50391 helo=samertm.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YTTY5-0005gK-60 for emacs-devel@gnu.org; Thu, 05 Mar 2015 06:02:37 -0500 Original-Received: from [10.1.10.16] (c-98-210-154-226.hsd1.ca.comcast.net [98.210.154.226]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by samertm.com (Postfix) with ESMTPSA id 8250142D22; Thu, 5 Mar 2015 11:02:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=samertm.com; s=mail; t=1425553341; bh=TVFRKG9lGY9Zr5dydqncFVGkfLPbaxYGwZw6mXQWxnE=; h=Date:From:Subject:To:Cc:From; b=sKvbVpkIgWcnGBfoAzst9Vl6C3syXoxd+oQ2GbBU5pRmLxyxknA0yXklsGF0PpB/R mVIi5Q1h+Ubhhqzt0J71Q50W+MZfhiH9yHqnQJqNFaqy+qY3dDwNwEyb4oHKVMYO8G Pvh761i0ZptFR/ObCr9geIZx1yqduqFMfPy4DB4E= X-Mailer: geary/0.9.1 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 52.0.7.12 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:183664 Archived-At: --=-K0LCaQzHdXRTlWSNdeDO Content-Type: text/plain; charset=utf-8; format=flowed Hey list, 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. Would anyone be interested in working on this? cc'ing Stephen Leake because he lead the most recent major changes to CONTRIBUTE. -samer --=-K0LCaQzHdXRTlWSNdeDO Content-Type: text/html; charset=utf-8 Hey list,

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.

Would anyone be interested in working on this? cc'ing Stephen Leake because he lea d the most recent major changes to CONTRIBUTE.

-samer
--=-K0LCaQzHdXRTlWSNdeDO--