[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[RCF] parallel-tests: removing the "check-html" target and the .log -> .
[RCF] parallel-tests: removing the "check-html" target and the .log -> .html conversion?
Thu, 05 Jan 2012 19:27:11 +0100
The parallel-tests harness has provided, since the very beginning, built-in
support for the generation of html files from the testcase-created `.log'
As far as I know, the main reason for which this built-in support exists is that
the features it provides were already present in the original "third-party" code
(from EPITA/LRDE and Gostai) from which the initial version of the
But in my opinion, its presence in the automake core has not proved to be such
a good idea in the long term. Here are the two most relevant grips I have with
- The rules for the .log -> .html conversion use the `rst2html' program, which
expects its input formatted as reStructuredText. Now, it is true that
format is simple and unobtrusive enough that most "unformatted" text is also
valid reStructuredText; but unless the `.log' files generated by the test
cases contain deliberate and meaningful reStructuredText directives, the
resulting HTML will have no better structure or presentation than the raw log
file (as a "make check-html" issued in many GNU projects will show). In
in many cases the final presentation will be actually worse.
- The support for the .log -> .html conversion must be documented and tested,
thus adding more overhead to the already-big automake testsuite and manual.
But a quick look at `lib/am/check.am' shows it would be very easy to move
the whole implementation of this conversion into a third-party .am fragment,
which users still interested in HTML output could easily obtain and include
in their Makefile.am files.
So, in conclusion, here is my simple proposal:
1. We deprecate the support for HTML testsuite output in the documentation of
the 1.11.3 release.
2. In the 1.12 release, we remove it from the automake core, providing instead
(in the automake tarball) an "extra" `.am' fragment that can offer a
(and hopefully completely equivalent) functionality.
-*- Notes -*-
 At least a `.log.html' suffix rule, and two higher-level rules `check-html'
 About the inception and implementation of parallel-tests in automake, see
the much instructive discussion at
 This is not an accident, but the consequence of precise design choices; see
 For reference, I attach the `test-suite.html' generated by the automake
testsuite upon an "make html-check".
Description: Text document
- [RCF] parallel-tests: removing the "check-html" target and the .log -> .html conversion?,
Stefano Lattarini <=