Re: RFC archival format, was: Re: More liberal draft formatting standards required

Doug Otis <doug.mtview@gmail.com> Tue, 14 July 2009 09:22 UTC

Return-Path: <doug.mtview@gmail.com>
X-Original-To: ietf@core3.amsl.com
Delivered-To: ietf@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 1089928C275 for <ietf@core3.amsl.com>; Tue, 14 Jul 2009 02:22:10 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.599
X-Spam-Level:
X-Spam-Status: No, score=-2.599 tagged_above=-999 required=5 tests=[BAYES_00=-2.599]
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 1+geKLR7vmrv for <ietf@core3.amsl.com>; Tue, 14 Jul 2009 02:22:08 -0700 (PDT)
Received: from mail-pz0-f198.google.com (mail-pz0-f198.google.com [209.85.222.198]) by core3.amsl.com (Postfix) with ESMTP id B7F1F28C17B for <ietf@ietf.org>; Tue, 14 Jul 2009 02:22:08 -0700 (PDT)
Received: by pzk36 with SMTP id 36so3318485pzk.29 for <ietf@ietf.org>; Tue, 14 Jul 2009 02:20:51 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:in-reply-to:subject :x-priority:references:message-id:content-type :content-transfer-encoding:mime-version:date:cc:x-mailer; bh=d+eaf3zJhJrgZlFn6jHfzyFWvvjVrfWJaI/kmrYqAmg=; b=VhlK8fUkuEjPwYBsx+YenY7jtgBTWoekVk/NWS6vr+34ppdUUpQZI1O8ucQQZIVdMV v6oIknyuKPxc5QAuahCqoDv5jnzUij6BTOuHDril7bDv2EanXcRGS2b1wRxVR/4rtVXy U3cz/C+jeyyH5AQU/LKfZCzju3VUb/7JpuSGo=
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:in-reply-to:subject:x-priority:references:message-id :content-type:content-transfer-encoding:mime-version:date:cc :x-mailer; b=AvwLzywGMsDYyskDAA7Zs+XNpK8zuGI46zVg+uE6zMcSTuY7ybRsEUr1WlWFh3HWgQ WxM09oWHLVjiLGDxWrx6ium37D2J3BZeFp7s4LRyGAQ/vTdgFDliF4zT7tzMpKhO55nr 9fWbcsDM5HgVyva+zUC4MwH+cDq9eB+XMaCsY=
Received: by 10.115.95.13 with SMTP id x13mr10332990wal.64.1247563251787; Tue, 14 Jul 2009 02:20:51 -0700 (PDT)
Received: from ?192.168.2.42? (64-142-13-68.dsl.static.sonic.net [64.142.13.68]) by mx.google.com with ESMTPS id n40sm10555470wag.30.2009.07.14.02.20.50 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 14 Jul 2009 02:20:51 -0700 (PDT)
From: Doug Otis <doug.mtview@gmail.com>
To: Doug Ewell <doug@ewellic.org>
In-Reply-To: <B7CD7229A9CC4A61AFA0C8194E59D016@DGBP7M81>
Subject: Re: RFC archival format, was: Re: More liberal draft formatting standards required
X-Priority: 3
References: <01ACD6EF5D2742A1832D0D585B2185F4@DGBP7M81><410BE357-1AE2-4E60-AB97-ED449A821DBF@mail-abuse.org><7CBFBEC8464443A695EB3636E4E41604@DGBP7M81> <86ljmt63fn.fsf@betla.izb.knu.ac.kr> <E5D652AAB53B42699B4890D9B43DD946@DGBP7M81> <6D09C7E5-007A-46D3-8302-8682C1473B60@mail-abuse.org> <B7CD7229A9CC4A61AFA0C8194E59D016@DGBP7M81>
Message-Id: <E601A15A-23E3-4239-A1E7-0DAD2B912780@gmail.com>
Content-Type: text/plain; charset="US-ASCII"; format="flowed"; delsp="yes"
Content-Transfer-Encoding: 7bit
Mime-Version: 1.0 (Apple Message framework v935.3)
Date: Tue, 14 Jul 2009 02:20:49 -0700
X-Mailer: Apple Mail (2.935.3)
Cc: ietf@ietf.org
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 14 Jul 2009 09:22:10 -0000

On Jul 13, 2009, at 7:58 PM, Doug Ewell wrote:
> Why on Earth would someone use Visual Basic within Word to write a  
> utility to convert Microsoft Word ***XML*** documents to an IETF- 
> acceptable format, when there are much better tools for processing  
> XML?

For a third-party application to interpret the changing Word document  
format, even in XML form, would require extensive and ongoing  
support.  This support would go well beyond what is currently needed  
to interpret the simpler xml2rfc structures.  Using Word input files  
alone is likely to represent an effort few could afford to support.

>  Why would someone not specifically write such a utility to ignore  
> or reject any Word document containing executable code?

Use of the bundled program language that operates at an object level  
can hide underlying format changes and avoid the related support  
effort.  Using the bundled programming language likely represents the  
_only_ practical method for directly utilizing Word input files, as  
was suggested.  IMHO, this was a logical conclusion.

> This, on the other hand, from Iljitsch van Beijnum <iljitsch at  
> muada dot com>:
>
>> This solves the problem that converting anything else into XML2RFC  
>> a reverse lossy process: XML2RFC needs more than what other formats  
>> can supply so automatic conversion (from, for instance, Word) is  
>> impossible.
>
> is a genuinely useful and productive counterargument against the  
> whole "word2rfc" concept.

Disagree.  The goal would be to generate RFC and ID documents.   
Requiring XML2RFC intermediaries negates the benefit of using Word.   
Beyond security concerns related to relying upon the bundled program  
language, not having this feature supported in OSX or Unix represents  
yet another concern.  Iljitsch view of XML2RFC intermediaries is not  
practical, but Word2rfc is not impossible when the bundled program  
language is used.  It can be done, but it would not be wise.


On Jul 13, 2009, at 1:10 PM, Julian Reschke wrote:
> The "experimental" version (http://xml.resource.org/ 
> experimental.html) is as stable as predecessor versions; the main  
> reason it hasn't been released is that the authors (IMHO) expected  
> more boilerplate changes to occur.
>
> And what exactly do you mean by "cryptic entries"?

There was little documentation for what would satisfy the nit checker  
a few months ago.  It was a challenge to know what was needed for the  
rfc structure.  The needed ipr parameter appeared rather cryptic.

> I think the right approach is to either help maintaining the TCL  
> code, or to rewrite xml2rfc in a different language.


To support the generation of MHTML, as some have suggested, the  
logical intermediary format seems to be XSLT (for defining xml2rfc  
constructs).

http://tools.ietf.org/html/rfc2557
http://people.dsv.su.se/~jpalme/ietf/mhtml.html

IMHO, pre-processors with roff might offer simpler and cleaner inputs,  
especially for the vision impaired.  A post process could then  
generate simpler MHTML formats.

-Doug