[tap] Bikeshed: TAP document vs. TAP stream

Salve J Nilsen <sjn@pvv.org> Tue, 02 March 2010 15:52 UTC

Return-Path: <sjn@pvv.ntnu.no>
X-Original-To: tap@core3.amsl.com
Delivered-To: tap@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id E7C343A8B70 for <tap@core3.amsl.com>; Tue, 2 Mar 2010 07:52:38 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.6
X-Spam-Level:
X-Spam-Status: No, score=-2.6 tagged_above=-999 required=5 tests=[BAYES_00=-2.599, NO_RELAYS=-0.001]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id tirn7jRj5iI4 for <tap@core3.amsl.com>; Tue, 2 Mar 2010 07:52:38 -0800 (PST)
Received: from decibel.pvv.ntnu.no (decibel.pvv.ntnu.no [IPv6:2001:700:300:1900::1:2]) by core3.amsl.com (Postfix) with ESMTP id 8F25128C170 for <tap@ietf.org>; Tue, 2 Mar 2010 07:52:37 -0800 (PST)
Received: from sjn by decibel.pvv.ntnu.no with local (Exim 4.69) (envelope-from <sjn@pvv.ntnu.no>) id 1NmUOg-00052Y-ES for tap@ietf.org; Tue, 02 Mar 2010 16:52:34 +0100
Date: Tue, 02 Mar 2010 16:52:34 +0100
From: Salve J Nilsen <sjn@pvv.org>
X-X-Sender: sjn@decibel.pvv.ntnu.no
To: The TAP Crowd <tap@ietf.org>
Message-ID: <alpine.DEB.1.00.1003021642090.2167@decibel.pvv.ntnu.no>
User-Agent: Alpine 1.00 (DEB 882 2007-12-20)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format="flowed"; charset="US-ASCII"
Subject: [tap] Bikeshed: TAP document vs. TAP stream
X-BeenThere: tap@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: Test Anything Protocol WG discussions <tap.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/tap>, <mailto:tap-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/tap>
List-Post: <mailto:tap@ietf.org>
List-Help: <mailto:tap-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tap>, <mailto:tap-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 02 Mar 2010 15:52:39 -0000

Hey folks

Just did a quick "Google ranking" of the use of "document" vs. 
"stream":

   http://www.google.com/search?q=Perl+%22TAP+document%22
   http://www.google.com/search?q=Perl+%22TAP+stream%22

"Document" gives 110-ish hits and "stream" about 370 hits. Should we 
try to standardize on "stream" in the TAP spec?

I'm just raising this issue because I think "TAP document" sounds a 
litte weird to say after having looked at the output of "make test" 
enough times. It always seemed to me like a stream of data than a 
fixed document. "Stream" is also closer to the "protocol" paradigm 
than "document", IMO.

Sorry about the bikeshedding, but clarity and consistency is also 
nice to have. :)

So, what do people think? Should the TAP spec use "stream" instead of 
"document" where "document" is used now?

stream++


- Salve

-- 
#!/usr/bin/perl
sub AUTOLOAD{$AUTOLOAD=~/.*::(\d+)/;seek(DATA,$1,0);print#  Salve Joshua Nilsen
getc DATA}$"="'};&{'";@_=unpack("C*",unpack("u*",':4@,$'.#     <sjn@foo.no>
'2!--"5-(50P%$PL,!0X354UC-PP%/0\`'."\n"));eval "&{'@_'}";   __END__ is near! :)