From: Michael Albinus <michael.albinus@gmx.de>
Date: Tue, 9 Feb 2016 10:06:14 +0000 (+0100)
Subject: * CONTRIBUTE: Add more examples for $(SELECTOR) make variable.
X-Git-Tag: emacs-25.0.91~40
X-Git-Url: https://code.delx.au/gnu-emacs/commitdiff_plain/815439eadc0ac0fb442be9f1269eadbf37471ff6

* CONTRIBUTE: Add more examples for $(SELECTOR) make variable.
---

diff --git a/CONTRIBUTE b/CONTRIBUTE
index f1f3a3f86f..5a5cb5db5a 100644
--- a/CONTRIBUTE
+++ b/CONTRIBUTE
@@ -267,6 +267,17 @@ you run "make check-expensive" from the top-level directory.  "make
 line. So "make check SELECTOR=nil" is equivalent to "make
 check-expensive".
 
+You could also use predefined selectors of the Makefile. "make
+<filename> SELECTOR='$(SELECTOR_DEFAULT)'" runs all tests for
+<filename>.el(c) except the tests tagged as expensive.
+
+Selectors can be defined with different methods, see (info "(ert)Test
+Selectors") or
+https://www.gnu.org/software/emacs/manual/html_node/ert/Test-Selectors.html
+If your test file contains the tests "test-foo", "test2-foo" and
+"test-foo-remote", and you want to run only the former two tests, you
+could use a regexp: "make <filename> SELECTOR='\"foo$$\"'" .
+
 ** Understanding Emacs Internals.
 
 The best way to understand Emacs Internals is to read the code,