| blob | 6891d46ba492cf955aa937ec173380e03a6f7bce |
3 <head>
11 </head>
12 <body>
16 </div>
19 <ol>
20 <li>
21 <p>
23 </p>
24 </li>
25 <li>
26 <p>
28 </p>
29 </li>
30 <li>
31 <p>
33 </p>
34 </li>
35 <li>
36 <p>
38 </p>
39 </li>
40 <li>
41 <p>
43 </p>
44 </li>
45 <li>
46 <p>
48 </p>
49 </li>
50 <li>
51 <p>
53 </p>
54 </li>
55 </ol>
56 </div>
58 <h1>
60 </h1>
63 </p>
64 <ul>
65 <li>
67 Added build-time checks to atf-c and atf-c++. A binding
68 for atf-sh will come later.
69 </p>
70 </li>
71 <li>
73 Migrated all build-time checks for header files to proper
74 ATF tests. This demonstrates the use of the new feature described
75 above.
76 </p>
77 </li>
78 <li>
80 Added an internal API for child process
81 management.
82 </p>
83 </li>
84 <li>
86 Converted all plain-text distribution documents to a Docbook
87 canonical version, and include pre-generated plain text and HTML
88 copies in
89 the distribution file.
90 </p>
91 </li>
92 <li>
94 Simplified the contents of the
96 canonical
98 some
99 dependency specifications were fixed.
100 </p>
101 </li>
102 <li>
104 Migrated all checks from the
106 to
108 installed.
109 </p>
110 </li>
111 <li>
113 Fixed sign comparison mismatches triggered by
114 the now-enabled
116 </p>
117 </li>
118 <li>
120 Fixed many memory and object leaks.
121 </p>
122 </li>
123 </ul>
124 <h1>
126 </h1>
129 </p>
130 <ul>
131 <li>
133 Make atf-exec be able to kill its child process after a
134 certain period of time; this is controlled through the new -t
135 option.
136 </p>
137 </li>
138 <li>
140 Change atf-sh to use atf-exec's -t option to control the
141 test case's timeouts, instead of doing it internally. Same
142 behavior as
143 before, but noticeably faster.
144 </p>
145 </li>
146 <li>
148 atf-exec's -g option and atf-killpg are gone due to the
149 previous change.
150 </p>
151 </li>
152 <li>
154 Added the atf-check(1) tool, a program that executes a
155 given command and checks its exit code against a known value and
156 allows the
157 management of stdout and stderr in multiple ways. This replaces
158 the
159 previous atf_check function in the atf-sh library and exposes this
160 functionality to both atf-c and atf-c++.
161 </p>
162 </li>
163 <li>
165 Added the ATF_REQUIRE family of macros to the C interface.
166 These help in checking for fatal test conditions. The old
167 ATF_CHECK macros
168 now perform non-fatal checks only. I.e. by using ATF_CHECK, the
169 test case
170 can now continue its execution and the failures will not be
171 reported until
172 the end of the whole run.
173 </p>
174 </li>
175 <li>
177 Extended the amount of ATF_CHECK_* C macros with new ones
178 to provide more features to the developer. These also have their
179 corresponding counterparts in the ATF_REQUIRE_* family. The new
180 macros
181 (listing the suffixes only) are: _EQ (replaces _EQUAL), _EQ_MSG,
182 _STREQ and
183 _STREQ_MSG.
184 </p>
185 </li>
186 </ul>
187 <h1>
189 </h1>
192 </p>
193 <ul>
194 <li>
197 dropped. All the code is now under a 2-clause BSD license
198 compatible with
199 the GNU General Public License (GPL).
200 </p>
201 </li>
202 <li>
204 Added a C-only binding so that binary test programs do not
205 need to be tied to C++ at all. This binding is now known as the
206 atf-c
207 library.
208 </p>
209 </li>
210 <li>
212 Renamed the C++ binding to atf-c++ for consistency with the
213 new atf-c.
214 </p>
215 </li>
216 <li>
218 Renamed the POSIX shell binding to atf-sh for consistency
219 with the new atf-c and atf-c++.
220 </p>
221 </li>
222 <li>
224 Added a -w flag to test programs through which it is
225 possible to specify the work directory to be used. This was
226 possible in
227 prior releases by defining the workdir configuration variable (-v
228 workdir=...), but was a conceptually incorrect mechanism.
229 </p>
230 </li>
231 <li>
233 Test programs now preserve the execution order of test
234 cases when they are given in the command line. Even those
235 mentioned more
236 than once are executed multiple times to comply with the user's
237 requests.
238 </p>
239 </li>
240 </ul>
241 <h1>
243 </h1>
246 </p>
247 <ul>
248 <li>
250 Added two new manual pages, atf-c++-api and atf-sh-api,
251 describing the C++ and POSIX shell interfaces used to write test
252 programs.
253 </p>
254 </li>
255 <li>
257 Added a pkg-config file, useful to get the flags to build
258 against the C++ library or to easily detect the presence of
259 ATF.
260 </p>
261 </li>
262 <li>
264 Added a way for test cases to require a specific
265 architecture and/or machine type through the new 'require.arch' and
266 'require.machine' meta-data properties, respectively.
267 </p>
268 </li>
269 <li>
271 Added the 'timeout' property to test cases, useful to set
272 an upper-bound limit for the test's run time and thus prevent
273 global test
274 program stalls due to the test case's misbehavior.
275 </p>
276 </li>
277 <li>
279 Added the atf-exec(1) internal utility, used to execute a
280 command after changing the process group it belongs to.
281 </p>
282 </li>
283 <li>
285 Added the atf-killpg(1) internal utility, used to kill
286 process groups.
287 </p>
288 </li>
289 <li>
291 Multiple portability fixes. Of special interest, full
293 the Sun
294 Studio 12 C++ compiler.
295 </p>
296 </li>
297 <li>
299 Fixed a serious bug that prevented atf-run(1) from working
300 at all under Fedora 8 x86_64. Due to the nature of the bug, other
301 platforms were likely affected too.
302 </p>
303 </li>
304 </ul>
305 <h1>
307 </h1>
310 </p>
311 <ul>
312 <li>
314 Added XML output support to atf-report. This is
315 accompanied by a DTD for the format's structure and sample XSLT/CSS
316 files
317 to post-process this output and convert it to a plain HTML
318 report.
319 </p>
320 </li>
321 <li>
323 Changed atf-run to add system information to the report it
324 generates. This is currently used by atf-report's XML output only,
325 and is
326 later printed in the HTML reports in a nice and useful summary
327 table. The
328 user and system administrator are allowed to tune this feature by
329 means of
330 hooks.
331 </p>
332 </li>
333 <li>
335 Removed the test cases' 'isolated' property. This was
336 intended to avoid touching the file system at all when running the
337 related
338 test case, but this has not been true for a long while: some
339 control files
340 are unconditionally required for several purposes, and we cannot
341 easily get
342 rid of them. This way we remove several critical and delicate
343 pieces of
344 code.
345 </p>
346 </li>
347 <li>
349 Improved atf-report's CSV output format to include
350 information about test programs too.
351 </p>
352 </li>
353 <li>
355 Fixed the tests that used atf-compile to not require this
356 tool as a helper. Avoids systems without build-time utilities to
357 skip many
358 tests that could otherwise be run. (E.g. NetBSD without the
359 comp.tgz set
360 installed.)
361 </p>
362 </li>
363 <li>
365 Many general cleanups: Fixed many pieces of code marked as
366 ugly and/or incomplete.
367 </p>
368 </li>
369 </ul>
370 <h1>
372 </h1>
375 </p>
376 <ul>
377 <li>
379 Test cases now get a known umask on
380 entry.
381 </p>
382 </li>
383 <li>
385 atf-run now detects many unexpected failures caused by test
386 programs and reports them as bogus tests. atf-report is able to
387 handle
388 these new errors and nicely reports them to the user.
389 </p>
390 </li>
391 <li>
393 All the data formats read and written by the tools have
394 been documented and cleaned up. These include those grammars that
395 define
396 how the different components communicate with each other as well as
397 the
398 format of files written by the developers and users: the Atffiles
399 and the
400 configuration files.
401 </p>
402 </li>
403 <li>
405 Added the atf-version tool, a utility that displays
406 information about the currently installed version of ATF.
407 </p>
408 </li>
409 <li>
411 Test cases can now define an optional cleanup routine to
412 undo their actions regardless of their exit status.
413 </p>
414 </li>
415 <li>
417 atf-report now summarizes the list of failed (bogus) test
418 programs when using the ticker output format.
419 </p>
420 </li>
421 <li>
423 Test programs now capture some termination signals and
424 clean up any temporary files before exiting the program.
425 </p>
426 </li>
427 <li>
429 Multiple bug fixes and improvements all
430 around.
431 </p>
432 </li>
433 </ul>
434 <h1>
436 </h1>
439 </p>
440 <ul>
441 <li>
443 First public version. This was released coinciding with
444 the end of the Google Summer of Code 2007 program.
445 </p>
446 </li>
447 </ul>
448 </div>
449 </body>
450 </html>