diff options
Diffstat (limited to 'app-emacs/regress/metadata.xml')
-rw-r--r-- | app-emacs/regress/metadata.xml | 25 |
1 files changed, 22 insertions, 3 deletions
diff --git a/app-emacs/regress/metadata.xml b/app-emacs/regress/metadata.xml index 7658bf99b319..bb04ad9ca88a 100644 --- a/app-emacs/regress/metadata.xml +++ b/app-emacs/regress/metadata.xml @@ -1,13 +1,32 @@ <?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"> +<!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd"> <pkgmetadata> <maintainer type="project"> <email>gnu-emacs@gentoo.org</email> <name>Gentoo GNU Emacs project</name> </maintainer> <longdescription> - This module provides support for writing and executing regression - tests for Emacs Lisp code. + This module provides support for writing and executing regression tests + for Emacs Lisp code. + + This module makes it easy for Emacs lisp programmers to write + complete, well-documented regression tests and to run them often + during the developement and enhancement processes. + + Here's the idea: + 1. The programmer puts one or more test suites directly in the lisp + file, wrapped inside an "eval-when-compile" special form. This + causes the test suites to be available when .el file is loaded + (or when the buffer is evaluated), but not when the .elc file is + loaded. + + 2. The programmer runs the tests in one of two ways: + a. Interactively, with the M-x regress command. + b. Automatically, every time the file is evaluated, by putting + a small bit of code at the end of the file. + + 3. If there are any regressions, a report is produced detailing the + problems. </longdescription> <stabilize-allarches/> </pkgmetadata> |