Merge from vendor branch BINUTILS:
[dragonfly.git] / bin / ed / test / README
1 # $FreeBSD: src/bin/ed/test/README,v 1.7 1999/08/27 23:14:17 peter Exp $
2 # $DragonFly: src/bin/ed/test/README,v 1.2 2003/06/17 04:22:50 dillon Exp $
3
4 The files in this directory with suffixes `.t', `.d', `.r' and `.err' are
5 used for testing ed.  To run the tests, set the ED variable in the Makefile
6 for the path name of the program to be tested (e.g., /bin/ed), and type
7 `make'.  The tests do not exhaustively verify POSIX compliance nor do
8 they verify correct 8-bit or long line support.
9
10 The test file suffixes have the following meanings:
11 .t    Template - a list of ed commands from which an ed script is
12       constructed
13 .d    Data - read by an ed script
14 .r    Result - the expected output after processing data via an ed
15       script.
16 .err  Error - invalid ed commands that should generate an error
17
18 The output of the tests is written to the two files err.o and scripts.o.
19 At the end of the tests, these files are grep'ed for error messages,
20 which look like:
21         *** The script u.ed exited abnormally ***
22 or:
23         *** Output u.o of script u.ed is incorrect ***
24
25 The POSIX requirement that an address range not be used where at most
26 a single address is expected has been relaxed in this version of ed.
27 Therefore, the  following scripts  which test for compliance with this
28 POSIX rule exit abnormally:
29 =-err.ed
30 a1-err.ed
31 i1-err.ed
32 k1-err.ed
33 r1-err.ed