Re: [Json] [apps-discuss] merge-patch in APPSA and i-json in JSON

Paul Hoffman <paul.hoffman@vpnc.org> Thu, 10 July 2014 00:59 UTC

Return-Path: <paul.hoffman@vpnc.org>
X-Original-To: json@ietfa.amsl.com
Delivered-To: json@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A21641A002D; Wed, 9 Jul 2014 17:59:30 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.347
X-Spam-Level:
X-Spam-Status: No, score=-1.347 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HELO_MISMATCH_COM=0.553] autolearn=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id wG5HPv3rG3At; Wed, 9 Jul 2014 17:59:29 -0700 (PDT)
Received: from hoffman.proper.com (IPv6.Hoffman.Proper.COM [IPv6:2605:8e00:100:41::81]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 5FAC61A0022; Wed, 9 Jul 2014 17:59:29 -0700 (PDT)
Received: from [10.20.30.90] (50-1-51-60.dsl.dynamic.fusionbroadband.com [50.1.51.60]) (authenticated bits=0) by hoffman.proper.com (8.14.8/8.14.7) with ESMTP id s6A0xQGH025918 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO); Wed, 9 Jul 2014 17:59:27 -0700 (MST) (envelope-from paul.hoffman@vpnc.org)
X-Authentication-Warning: hoffman.proper.com: Host 50-1-51-60.dsl.dynamic.fusionbroadband.com [50.1.51.60] claimed to be [10.20.30.90]
Content-Type: text/plain; charset="iso-8859-1"
Mime-Version: 1.0 (Mac OS X Mail 7.3 \(1878.6\))
From: Paul Hoffman <paul.hoffman@vpnc.org>
In-Reply-To: <4CB92BF6-A5A0-4598-A25F-C3F51E1DFFD5@tzi.org>
Date: Wed, 09 Jul 2014 17:59:25 -0700
Content-Transfer-Encoding: quoted-printable
Message-Id: <7E9AAC20-63CC-48EC-81EE-3F53CB3DEF83@vpnc.org>
References: <13c1732c5d504e84b80cd82e5e8f05ab@BL2PR02MB307.namprd02.prod.outlook.com> <DE7ECD34-F035-46CC-B0B0-571039A86F3F@vpnc.org> <20140708190635.GD6016@mercury.ccil.org> <4CB92BF6-A5A0-4598-A25F-C3F51E1DFFD5@tzi.org>
To: Carsten Bormann <cabo@tzi.org>
X-Mailer: Apple Mail (2.1878.6)
Archived-At: http://mailarchive.ietf.org/arch/msg/json/l-S1rSIsS188NefV4Rp23wgnt_8
Cc: "apps-discuss@ietf.org" <apps-discuss@ietf.org>, "json@ietf.org" <json@ietf.org>
Subject: Re: [Json] [apps-discuss] merge-patch in APPSA and i-json in JSON
X-BeenThere: json@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: "JavaScript Object Notation \(JSON\) WG mailing list" <json.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/json>, <mailto:json-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/json/>
List-Post: <mailto:json@ietf.org>
List-Help: <mailto:json-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/json>, <mailto:json-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 10 Jul 2014 00:59:30 -0000

On Jul 9, 2014, at 10:57 AM, Carsten Bormann <cabo@tzi.org> wrote:

> On 08 Jul 2014, at 21:06, John Cowan <cowan@mercury.ccil.org> wrote:
> 
>> What is meant by "the Key/Value pair" if there is more than one?
>> Are all such pairs to be removed or mutated, or only one of them?
> 
> It may have been intuitively obvious to the authors and reviewers, but may still be worthwhile mentioning in a sentence, that the merge-patch operation is defined at the level of the JSON data model.  Specifically, there is no expectation that merge-patch preserves representation level features such as white space, member ordering etc.

Does the following language work for you?

The MergePatch operation is defined at the level of the JSON data model. Specifically, there is no expectation that the MergePatch operation will preserve representation-level features such as white space, member ordering, and so on. If an object in the target has more than one name/value pair with the same name, the result of the patch operation is unpredictable.

--Paul Hoffman