[abnf-discuss] Core-07, confused about <> and []
Doug Royer <douglasroyer@gmail.com> Sun, 13 November 2016 21:23 UTC
Return-Path: <douglasroyer@gmail.com>
X-Original-To: abnf-discuss@ietfa.amsl.com
Delivered-To: abnf-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D4B81129655 for <abnf-discuss@ietfa.amsl.com>; Sun, 13 Nov 2016 13:23:38 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.7
X-Spam-Level:
X-Spam-Status: No, score=-2.7 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
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 Jh5JeB16xxyV for <abnf-discuss@ietfa.amsl.com>; Sun, 13 Nov 2016 13:23:37 -0800 (PST)
Received: from mail-it0-x22c.google.com (mail-it0-x22c.google.com [IPv6:2607:f8b0:4001:c0b::22c]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id C20D212967D for <abnf-discuss@ietf.org>; Sun, 13 Nov 2016 13:23:30 -0800 (PST)
Received: by mail-it0-x22c.google.com with SMTP id q124so74958290itd.1 for <abnf-discuss@ietf.org>; Sun, 13 Nov 2016 13:23:30 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=to:from:subject:organization:message-id:date:user-agent :mime-version; bh=PkWJ44ONWvM+y3oCM7Gux4UyOc9K6LSr3JaUyC0VkCw=; b=rdXBsNHTj983q7v+d8gSOp2M0jzauhlV7wCuRXWO95BqDYCpzSKhKf4uUdluTMXZua KRSKvlu4sixH56RqLnMqQxb+UxiRpNQ0+GxOR5mJI9zDjy53j0etGndhww7sX8me33zS B2Pbm6O95nhA75Y4pgsZ9DYoJXE4baV4W6NtrUEOruLmC/EAphTEeGPmcWrE7U8Oi2QU 5xypa9cGVuRLXirjqw5k8ykkM1Y3iNE8QlGQ6QswFGgZPBMdTx+2fbDz5cUMPbJOUgua +lVhPVImIbMGgD2g5FT2aaTgjnUcJBSz6YgYluVcqIDuuqfLHI6Pc/5jucKC/3D754dK VnEA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:to:from:subject:organization:message-id:date :user-agent:mime-version; bh=PkWJ44ONWvM+y3oCM7Gux4UyOc9K6LSr3JaUyC0VkCw=; b=a1Bi+s6L/aaH54nHftNInw47+2ou9UbLg7bJ3VNy8LrIP27+wbx9Tsv5rHoInNM2jl oNxIKVVpf+HH50odSkUL1/gN5nIRcZvTaMFwRG/hfWjYvLiT1u/Z0V/Kjln6LURjxd7I VTvX9bjcx/rXwSalhMu/g6SY9XTrawYAVDLbr4UARccmX1s54qPPGq3WkBGN5/kVqL3K kyn2d/ovdaiPHx0IX27ac4YdcA9nv7npOM8tBFAo7pD+1XoXBRlPqSQOD9kmLtNHU9sU t2pUpW4Xg/5mnN+EqP6hmmIU502Jeu6MtY6a5jDeZVaKGHaFaK5MFliT+zElNIaR3y+u 4g7A==
X-Gm-Message-State: ABUngvfzb1Q4gOfJapSpRfMxJg2b/Z32ozR7+sY5iZPFPCgc6JHUg9kWdgDNCLjxH+ajww==
X-Received: by 10.202.227.16 with SMTP id a16mr5518817oih.202.1479072209867; Sun, 13 Nov 2016 13:23:29 -0800 (PST)
Received: from [192.168.1.4] ([75.174.45.51]) by smtp.googlemail.com with ESMTPSA id b2sm6561637oih.18.2016.11.13.13.23.29 for <abnf-discuss@ietf.org> (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 13 Nov 2016 13:23:29 -0800 (PST)
To: abnf-discuss@ietf.org
From: Doug Royer <douglasroyer@gmail.com>
Organization: http://SoftwareAndServices.NET
Message-ID: <5828D9CF.4040201@gmail.com>
Date: Sun, 13 Nov 2016 14:23:27 -0700
User-Agent: Mozilla/5.0 (X11; Linux i686; rv:43.0) Gecko/20100101 Firefox/43.0 SeaMonkey/2.40
MIME-Version: 1.0
Content-Type: multipart/signed; protocol="application/pkcs7-signature"; micalg="sha-256"; boundary="------------ms080207040502040001060902"
Archived-At: <https://mailarchive.ietf.org/arch/msg/abnf-discuss/g2IpV9guQU6t8l36eb4hDo3egI0>
Subject: [abnf-discuss] Core-07, confused about <> and []
X-BeenThere: abnf-discuss@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: "General discussion about tools, activities and capabilities involving the ABNF meta-language" <abnf-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/abnf-discuss>, <mailto:abnf-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/abnf-discuss/>
List-Post: <mailto:abnf-discuss@ietf.org>
List-Help: <mailto:abnf-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/abnf-discuss>, <mailto:abnf-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 13 Nov 2016 21:23:39 -0000
Great idea! I have found ABNF cross referencing confusing in the past!
---------------------------------------------------------------
In 3. it says in part .... "use the syntax rulename@REF"
Where are the [] or <> ?
It confused me a bit, should it be (as I understand the ABNF)
... rulename@[REF] or rulename@<REF> ?
---------------------------------------------------------------
Later... The <ref-doc> production is a document reference,
Confused me, because ref-doc used '[' ']' and not '<' '>'.
And in a few more places <releref>, <ref-doc>, and <rulename> is used.
Not sure how to change it, it is confusing if the <text> are examples
(which I think they are not), or just used as an emphasis.
Not clear when '<' '>' (ref-path) will be used. "PATH" to me means file
path. Was that the intent? And I do not understand how that relates to a
MIME entity. Examples? When would a file path exist in an RFC, that
contains ABNF?
---------------------------------------------------------------
--
Doug Royer - (http://DougRoyer.US)
DouglasRoyer@gmail.com
714-989-6135