tap docs: we don't support pragma or version directives (yet)

* doc/automake.texi (Incompatibilities with other TAP parsers
and drivers): Document that limitation.  Normalize an unrelated
"TODO" item.

diff --git a/ChangeLog b/ChangeLog
index 80e516393d99b00c2141fde90742a83a6f1c6805..6036f422bad7827b9fa1c3eb12d34e606043cfb3 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2011-08-05  Stefano Lattarini  <stefano.lattarini@gmail.com>
+
+       tap docs: we don't support pragma or version directives (yet)
+       * doc/automake.texi (Incompatibilities with other TAP parsers
+       and drivers): Document that limitation.  Normalize an unrelated
+       "TODO" item.
+
 2011-08-05  Stefano Lattarini  <stefano.lattarini@gmail.com>
 
        tap: new option to change the string designating TAP diagnostic

diff --git a/doc/automake.texi b/doc/automake.texi
index 254e98ca0d4d1736a0cc91466dff8881cbe7cf18..c63742d3be1d32ce9b524f459cd25905552bc344 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -9772,13 +9772,16 @@ the test script it occurs into.  This doesn't follows TAP specifications,
 but on the other hand it maximizes compatibility (and code sharing) with
 the ``hard error'' concept of the default @option{parallel-tests} driver.
 @item
+The @code{version} and @code{pragma} directives are not supported.
+@item
 The @option{--diagnostic-string} option of out driver allows to modify
 the string that introduces TAP diagnostic from the default value
 of ``@code{#}''.  The standard TAP protocol has currently no way to
 allow this, so if you use it your diagnostic will be lost to more
 compliant tools like @command{prove} and @code{Test::Harness}
 @item
-@emph{TODO}: there's surely something else ...
+And there are probably some other small and yet undiscovered
+incompatibilities, especially in corner cases or with rare usages.
 @end itemize
 
 @node Links and external resources on TAP