From a44667dce47afd200d990910f8e8a966276be756 Mon Sep 17 00:00:00 2001 From: Stefano Lattarini Date: Thu, 30 Jun 2011 20:05:25 +0200 Subject: docs, tests: synchronize examples from docs to tests * tests/README (Writing test cases): Give suggestions on how to keep test cases and examples in the documentation synchronized. * doc/automake.texi: Improve or fix existing testcase-referencing comments, and add many new ones. * HACKING (Administrivia): Suggest to test complex examples and idioms from the manual. * tests/specflg8.test: Improve synchronization with the example in the manual. * tests/output11.test:Likewise. * tests/txinfo21.test:Likewise. * tests/interp.test: Likewise. Since we are at it, and enable the `errexit' shell flag, do related changes, and add trailing `:'command. * tests/amhello-cflags.test: New test. * tests/amhello-cross-compile.test: Likewise. * tests/amhello-binpkg.test: Likewise. * tests/tests-environment-backcompat: Likewise. * tests/parallel-tests-log-compiler-example.test: Likewise. * tests/Makefile.am (TESTS): Update. --- HACKING | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'HACKING') diff --git a/HACKING b/HACKING index a3e37f066..334d74cfa 100644 --- a/HACKING +++ b/HACKING @@ -20,6 +20,10 @@ * If somebody reports a new bug, mention his name in the ChangeLog entry and in the test case you write. Put him into THANKS. +* When documenting a non-trivial idiom or example in the manual, be + sure to add a test case for it, and to reference such test case from + a proper Texinfo comment. + * The correct response to most actual bugs is to write a new test case which demonstrates the bug. Then fix the bug, re-run the test suite, and check everything in. @@ -240,7 +244,8 @@ ----- -Copyright (C) 2003, 2007, 2008, 2010 Free Software Foundation, Inc. +Copyright (C) 2003, 2007, 2008, 2010, 2011 Free Software Foundation, +Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by -- cgit v1.2.1