# HG changeset patch # User Christian Brabandt # Date 1452201305 -3600 # Node ID 9d67399f49c65fd1498de9765a84a52bc457e116 # Parent 391d31ceb300c75c3c7d6bdd346721fc2f3374da commit https://github.com/vim/vim/commit/6602af7fe069246dbcf419c3e904a78b60e7d4dc Author: Bram Moolenaar Date: Thu Jan 7 22:01:01 2016 +0100 patch 7.4.1060 Problem: Instructions for writing tests are outdated. Solution: Mention Make_all.mak. Add steps for new style tests. diff --git a/src/testdir/README.txt b/src/testdir/README.txt --- a/src/testdir/README.txt +++ b/src/testdir/README.txt @@ -1,20 +1,41 @@ This directory contains tests for various Vim features. -If it makes sense, try to add a new test to an already existing file. You may -want to separate it from other tests in that file using :" (that's an Ex -command comment). +If it makes sense, add a new test method to an already existing file. You may +want to separate it from other tests with comment lines. The numbered tests are older, we have switched to named tests. -And the newest way of testing is to use assert functions, see test_assert.vim -for an example. + +And then you can chose between a new style test, which is a Vim script, or an +old style test, which uses Normal mode commands. Use a new style test if you +can. + -To add a new test: -1) Create test_.in and test_.ok files. -2) Add them to all Makefiles (Make*) in alphabetical order (search for an - existing test_file.out to see where to add the new one). -3) Use make test_.out to run a single test file in src/testdir/. +TO ADD A NEW STYLE TEST: + +1) Create a test_.vim file. +2) Add test_.vim to NEW_TESTS in Make_all.mak in alphabetical order. +3) Use make test_.res to run a single test in src/testdir/. + Use make test_ to run a single test in src/. 4) Also add an entry in src/Makefile. -Keep in mind that the files are used as if everything was typed. -A line break is like pressing Enter. If that happens on the last line you'll -hear a beep. +What you can use (see test_assert.vim for an example): +- Call assert_equal(), assert_true() and assert_false(). +- Use try/catch to check for exceptions. +- Use alloc_fail() to have memory allocation fail. This makes it possible to + to check memory allocation failures are handled gracefully. You need to + change the source code to add an ID to the allocation. Update LAST_ID_USED + above alloc_id() to the highest ID used. + + +TO ADD AN OLD STYLE TEST: + +1) Create test_.in and test_.ok files. +2) Add test_.out to SCRIPTS_ALL in Make_all.mak in alphabetical order. +3) Use make test_.out to run a single test in src/testdir/. + Use make test_ to run a single test in src/. +4) Also add an entry in src/Makefile. + +Keep in mind that the files are used as if everything was typed: +- To add comments use: :" (that's an Ex command comment) +- A line break is like pressing Enter. If that happens on the last line + you'll hear a beep! diff --git a/src/version.c b/src/version.c --- a/src/version.c +++ b/src/version.c @@ -742,6 +742,8 @@ static char *(features[]) = static int included_patches[] = { /* Add new patch number below this line */ /**/ + 1060, +/**/ 1059, /**/ 1058,