[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] CONTRIBUTE - writing tests for understanding internals
From: |
Przemysław Wojnowski |
Subject: |
[PATCH] CONTRIBUTE - writing tests for understanding internals |
Date: |
Tue, 10 Nov 2015 23:48:41 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) |
Hello everybody,
Here's a small patch that adds to CONTRIBUTE that writing tests is a
great way to learn about Emacs Internals, takes a new contributor
through committing process and is valuable to the project.
Please, check if that has been written in English. :-)
>From 6d59909ba6166b0d19a2d690caec52387280e2e7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Wojnowski?= <address@hidden>
Date: Tue, 10 Nov 2015 23:34:01 +0100
Subject: [PATCH] ; * CONTRIBUTE: Add testing to understanding Emacs Internals.
* CONTRIBUTE: Point that writing tests teaches about Emacs Internals and
brings value to the project itself.
---
CONTRIBUTE | 15 ++++++++++-----
1 file changed, 10 insertions(+), 5 deletions(-)
diff --git a/CONTRIBUTE b/CONTRIBUTE
index 2aae251..807e7a3 100644
--- a/CONTRIBUTE
+++ b/CONTRIBUTE
@@ -264,11 +264,16 @@ top-level directory. Most tests are in the directory
** Understanding Emacs Internals.
-The best way to understand Emacs Internals 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.
+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!
The file etc/DEBUG describes how to debug Emacs bugs.
--
2.1.4
- [PATCH] CONTRIBUTE - writing tests for understanding internals,
Przemysław Wojnowski <=
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, John Wiegley, 2015/11/10
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, Eli Zaretskii, 2015/11/10
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, Przemysław Wojnowski, 2015/11/11
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, Eli Zaretskii, 2015/11/11
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, Przemysław Wojnowski, 2015/11/11
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, Eli Zaretskii, 2015/11/11
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, John Wiegley, 2015/11/11
- Re: [PATCH] CONTRIBUTE - writing tests for understanding internals, Eli Zaretskii, 2015/11/11