Likley final editorial changes for P802.1Qcz publication (#1449)

* Revision statement and copyright updates for draft 2.5 * Changes for Qcw d2.0 comment disposition * Changes to address SA ballot comments on draft d2-1 * additional editorial updates for d2-2 * Fixed remaining 802.3 canonical format description sentences * Formatting changes for d2.2 * Editorial changes requested by IEEE staff editors for publication of 802.1Qcz-2023 * Additional description changes suggested by IEEE editorial staff
YangModels · Jul 13, 2023 · ebb7d51 · ebb7d51
1 parent 6c64eba
commit ebb7d51
Show file tree

Hide file tree

Showing 18 changed files with 578 additions and 430 deletions.
diff --git a/standard/ieee/draft/802.1/Qcj/ieee802-dot1q-lldp-pbbn-aa-tlv.yang b/standard/ieee/draft/802.1/Qcj/ieee802-dot1q-lldp-pbbn-aa-tlv.yang
diff --git a/standard/ieee/draft/802.1/Qcj/ieee802-dot1q-types.yang b/standard/ieee/draft/802.1/Qcj/ieee802-dot1q-types.yang
diff --git a/standard/ieee/draft/802.1/Qcw/ieee802-dot1q-psfp-bridge.yang b/standard/ieee/draft/802.1/Qcw/ieee802-dot1q-psfp-bridge.yang
@@ -23,14 +23,14 @@ module ieee802-dot1q-psfp-bridge {
     
     E-mail: STDS-802-1-CHAIRS@IEEE.ORG";
   description
-    "This module provides management of 802.1Q bridge components that
-    support Per Stream Filtering and Policing (PSFP).
+    "This module provides management of IEEE Std 802.1Q bridge
+    components that support Per Stream Filtering and Policing (PSFP).
     
     Copyright (C) IEEE (2023).
     
     This version of this YANG module is part of IEEE Std 802.1Q; see the
     standard itself for full legal notices.";
-  revision 2023-03-08 {
+  revision 2023-07-04 {
     description
       "Published as part of IEEE Std 802.1Qcw-2023.
       

diff --git a/standard/ieee/draft/802.1/Qcw/ieee802-dot1q-psfp.yang b/standard/ieee/draft/802.1/Qcw/ieee802-dot1q-psfp.yang
@@ -29,14 +29,14 @@ module ieee802-dot1q-psfp {
     
     E-mail: STDS-802-1-CHAIRS@IEEE.ORG";
   description
-    "This module provides management of 802.1Q bridge components that
-    support Per Stream Filtering and Policing (PSFP).
+    "This module provides management of IEEE Std 802.1Q bridge
+    components that support Per Stream Filtering and Policing (PSFP).
     
     Copyright (C) IEEE (2023).
     
     This version of this YANG module is part of IEEE Std 802.1Q; see the
     standard itself for full legal notices.";
-  revision 2023-03-16 {
+  revision 2023-07-04 {
     description
       "Published as part of IEEE Std 802.1Qcw-2023.
       

diff --git a/standard/ieee/draft/802.1/Qcw/ieee802-dot1q-types.yang b/standard/ieee/draft/802.1/Qcw/ieee802-dot1q-types.yang
@@ -26,7 +26,7 @@ module ieee802-dot1q-types {
     
     This version of this YANG module is part of IEEE Std 802.1Q; see the
     standard itself for full legal notices.";
-  revision 2023-03-16 {
+  revision 2023-07-04 {
     description
       "Published as part of IEEE Std 802.1Qcw-2023.
       
@@ -38,7 +38,7 @@ module ieee802-dot1q-types {
       IEEE Std 802 Overview and Architecture: 
       IEEE Std 802-2014.";
   }
-  revision 2023-01-24 {
+  revision 2023-07-03 {
     description
       "Published as part of IEEE Std 802.1Qcz-2023.";
     reference
@@ -71,7 +71,7 @@ module ieee802-dot1q-types {
   identity c-vlan {
     base dot1q-vlan-type;
     description
-      "An 802.1Q Customer VLAN, using the 81-00 EtherType";
+      "An 802.1Q Customer VLAN, using the 81-00 EtherType.";
     reference
       "5.5 of IEEE Std 802.1Q";
   }
@@ -466,7 +466,7 @@ module ieee802-dot1q-types {
       key "pcp";
       description
         "This map associates the priority code point field found in the VLAN
-        to a priority and drop eligible value based upon the priority code
+        with a priority and drop eligible value based upon the priority code
         point selection type.";
       leaf pcp {
         type pcp-selection-type;
@@ -478,8 +478,8 @@ module ieee802-dot1q-types {
       list priority-map {
         key "priority-code-point";
         description
-          "This map associated a priority code point value to priority and
-          drop eligible parameters.";
+          "This map associates a priority code point value with priority
+          and drop eligible parameters.";
         leaf priority-code-point {
           type priority-type;
           description
@@ -513,9 +513,9 @@ module ieee802-dot1q-types {
     list pcp-encoding-map {
       key "pcp";
       description
-        "This map associated the priority and drop-eligible parameters to
-        the priority used to encode the PCP of the VLAN based upon the
-        priority code point selection type.";
+        "This map associates the priority and drop-eligible parameters
+        with the priority used to encode the PCP of the VLAN based upon
+        the priority code point selection type.";
       leaf pcp {
         type pcp-selection-type;
         description
@@ -526,8 +526,8 @@ module ieee802-dot1q-types {
       list priority-map {
         key "priority dei";
         description
-          "This map associated the priority and drop-eligible parameters to
-          the priority code point field of the VLAN tag.";
+          "This map associates the priority and drop-eligible parameters
+          with the priority code point field of the VLAN tag.";
         leaf priority {
           type priority-type;
           description
@@ -625,9 +625,9 @@ module ieee802-dot1q-types {
   }
   grouping traffic-class-table-grouping {
     description
-      "The Traffic Class Table models the operations that can be performed
-      on, or inquire about, the current contents of the Traffic Class Table
-      (8.6.6) for a given Port.";
+      "The Traffic Class Table models the operations that can be
+      performed on, or can inquire about, the current contents of the
+      Traffic Class Table (8.6.6) for a given Port.";
     reference
       "12.6.3, 8.6.6 of IEEE Std 802.1Q";
     list traffic-class-map {
@@ -836,10 +836,9 @@ module ieee802-dot1q-types {
               }
             }
             description
-              "containing a control element for each outbound Port,
-              specifying that a frame with a destination MAC address, and in
-              the case of VLAN Bridge components, VID that meets this
-              specification.";
+              "A control element for each outbound Port, specifying that
+              a frame with a destination MAC address, and in the case of
+              VLAN Bridge components, VID that meets this specification.";
             reference
               "8.8.1 of IEEE Std 802.1Q";
           }
@@ -917,10 +916,9 @@ module ieee802-dot1q-types {
               }
             }
             description
-              "containing a control element for each outbound Port,
-              specifying that a frame with a destination MAC address, and in
-              the case of VLAN Bridge components, VID that meets this
-              specification.";
+              "A control element for each outbound Port, specifying that
+              a frame with a destination MAC address, and in the case of
+              VLAN Bridge components, VID that meets this specification.";
             reference
               "8.8.4 of IEEE Std 802.1Q";
           }
@@ -937,10 +935,9 @@ module ieee802-dot1q-types {
               }
             }
             description
-              "containing a control element for each outbound Port,
-              specifying that a frame with a destination MAC address, and in
-              the case of VLAN Bridge components, VID that meets this
-              specification.";
+              "A control element for each outbound Port, specifying that
+              a frame with a destination MAC address, and in the case of
+              VLAN Bridge components, VID that meets this specification.";
             reference
               "8.8.5 of IEEE Std 802.1Q";
           }
@@ -962,10 +959,9 @@ module ieee802-dot1q-types {
               }
             }
             description
-              "Containing a control element for each outbound Port,
-              specifying that a frame with a destination MAC address, and in
-              the case of VLAN Bridge components, VID that meets this
-              specification.";
+              "A control element for each outbound Port, specifying that
+              a frame with a destination MAC address, and in the case of
+              VLAN Bridge components, VID that meets this specification.";
             reference
               "8.8.7 of IEEE Std 802.1Q";
           }
@@ -982,10 +978,9 @@ module ieee802-dot1q-types {
               }
             }
             description
-              "Containing a control element for each outbound Port,
-              specifying that a frame with a destination MAC address, and in
-              the case of VLAN Bridge components, VID that meets this
-              specification.";
+              "A control element for each outbound Port, specifying that
+              a frame with a destination MAC address, and in the case of
+              VLAN Bridge components, VID that meets this specification.";
             reference
               "8.8.3 of IEEE Std 802.1Q";
           }

diff --git a/standard/ieee/draft/802.1/Qcz/ieee802-dot1q-ats-bridge.yang b/standard/ieee/draft/802.1/Qcz/ieee802-dot1q-ats-bridge.yang
@@ -29,18 +29,18 @@ module ieee802-dot1q-ats-bridge {
     
     E-mail: stds-802-1-chairs@ieee.org";
   description
-    "This module provides management of 802.1Q bridge components that
-    support Asynchronous Traffic Shaping (ATS).
+    "This module provides management of IEEE 802.1Q Bridge components
+    that support Asynchronous Traffic Shaping (ATS).
     
     Copyright (C) IEEE (2023).
     
     This version of this YANG module is part of IEEE Std 802.1Q; see the
     standard itself for full legal notices.";
-  revision 2023-01-24 {
+  revision 2023-07-03 {
     description
       "Published as part of IEEE Std 802.1Qcz-2023.";
     reference
-      "IEEE Std 802.1Qcz-2023, Bridges and Bridged Networks - Congesiton
+      "IEEE Std 802.1Qcz-2023, Bridges and Bridged Networks - Congestion
       Isolation.";
   }
   augment "/if:interfaces/if:interface/dot1q:bridge-port" {
@@ -59,7 +59,7 @@ module ieee802-dot1q-ats-bridge {
         uses ats:ats-parameters;
         container scheduler {
           description
-            "Enapsulates ATS scheduler nodes.";
+            "This container encapsulates ATS scheduler nodes.";
           leaf scheduler-ref {
             type leafref {
               path

diff --git a/standard/ieee/draft/802.1/Qcz/ieee802-dot1q-ats.yang b/standard/ieee/draft/802.1/Qcz/ieee802-dot1q-ats.yang
@@ -26,8 +26,8 @@ module ieee802-dot1q-ats {
     
     E-mail: stds-802-1-chairs@ieee.org";
   description
-    "This module provides management of 802.1Q bridge components that
-    support Asynchronous Traffic Shaping (ATS).
+    "This module provides management of IEEE 802.1Q Bridge components
+    that support Asynchronous Traffic Shaping (ATS).
     
     References in this YANG module to IEEE Std 802.1Q are to IEEE Std 
     802.1Q-2022 as amended by IEEE Std 802.1Qcz-2023.
@@ -36,7 +36,7 @@ module ieee802-dot1q-ats {
     
     This version of this YANG module is part of IEEE Std 802.1Q; see the
     standard itself for full legal notices.";
-  revision 2023-01-24 {
+  revision 2023-07-03 {
     description
       "Published as part of IEEE Std 802.1Qcz-2023.";
     reference
@@ -66,22 +66,22 @@ module ieee802-dot1q-ats {
         "A counter of frames discarded by ATS scheduler instances
         associated with the Bridge Port.";
       reference
-        "12.31.7.3 of IEEE Std 802.1Q";
+        "12.31.7.2 of IEEE Std 802.1Q";
     }
   }
   grouping ats-parameters {
     description
-      "System specific onfiguration for ATS includes:
+      "System specific configuration for ATS includes:
        a) ATS schedulers
        b) ATS scheduler groups";
     container schedulers {
       description
-        "This container comprises all nodes related to an ATS schedulers.";
+        "This container comprises all nodes related to ATS schedulers.";
       list scheduler-instance-table {
         key "scheduler-instance-id";
         description
           "Each list entry comprises a set of parameters that defines a
-          single ATS scheduler instance, as detailed in Table 12-33.";
+          single ATS scheduler instance, as detailed in Table 12-38.";
         reference
           "12.31.5 of IEEE Std 802.1Q";
         leaf scheduler-instance-id {
@@ -110,7 +110,7 @@ module ieee802-dot1q-ats {
             "The committed burst size parameter of this ATS scheduler
             instance.";
           reference
-            "12.31.5.3, 8.6.5.6 of IEEE Std 802.1Q";
+            "12.31.5.2, 8.6.5.6 of IEEE Std 802.1Q";
         }
         leaf scheduler-group-ref {
           type leafref {
@@ -124,12 +124,12 @@ module ieee802-dot1q-ats {
           }
           mandatory true;
           description
-            "A reference to the scheduler group (12.32.5) associated with
-            this ATS scheduler instance. Multiple ATS scheduler instances
-            can be associated to one scheduler group, as detailed in
-            8.6.5.6.";
+            "A reference to the scheduler group (12.31.5.4) associated
+            with this ATS scheduler instance. Multiple ATS scheduler
+            instances can be associated to one scheduler group, as
+            detailed in 8.6.5.6.";
           reference
-            "12.31.6 of IEEE Std 802.1Q";
+            "12.31.5.4, 8.6.5.6 of IEEE Std 802.1Q";
         }
       }
       leaf max-scheduler-instances {
@@ -158,7 +158,7 @@ module ieee802-dot1q-ats {
             "A unique index identifying this ATS scheduler group
             instance.";
           reference
-            "12.31.6, 8.6.5.6 of IEEE Std 802.1Q";
+            "12.31.6.1, 8.6.5.6 of IEEE Std 802.1Q";
         }
         leaf max-residence-time {
           type uint32;
@@ -168,7 +168,7 @@ module ieee802-dot1q-ats {
             "The maximum residence time parameter of the ATS scheduler
             group.";
           reference
-            "8.6.11.2.13, 8.6.5.6 of IEEE Std 802.1Q";
+            "12.31.6.2, 8.6.5.6 of IEEE Std 802.1Q";
         }
       }
       leaf max-scheduler-group-instances {
@@ -190,7 +190,7 @@ module ieee802-dot1q-ats {
           description
             "Each list entry comprises the timing characteristics of a
             reception Port transmission Port pair, as detailed in Table
-            12-36.";
+            12-41.";
           reference
             "12.31.8, 8.6.11 of IEEE Std 802.1Q";
           leaf reception-port {
@@ -277,7 +277,7 @@ module ieee802-dot1q-ats {
       uses ats:ats-parameters;
       container scheduler {
         description
-          "Enapsulates ATS scheduler nodes.";
+          "This container encapsulates ATS scheduler nodes.";
         leaf scheduler-ref {
           type leafref {
             path

diff --git a/standard/ieee/draft/802.1/Qcz/ieee802-dot1q-congestion-isolation-bridge.yang b/standard/ieee/draft/802.1/Qcz/ieee802-dot1q-congestion-isolation-bridge.yang
@@ -29,14 +29,14 @@ module ieee802-dot1q-congestion-isolation-bridge {
     
     E-mail: stds-802-1-chairs@listserv.ieee.org";
   description
-    "This module provides management of 802.1Q bridge components that
-    support Congestion Isolation.
+    "This module provides management of IEEE 802.1Q Bridge components
+    that support Congestion Isolation.
     
     Copyright (C) IEEE (2023).
     
     This version of this YANG module is part of IEEE Std 802.1Q; see the
     standard itself for full legal notices.";
-  revision 2023-01-24 {
+  revision 2023-07-03 {
     description
       "Published as part of IEEE Std 802.1Qcz-2023.";
     reference
@@ -45,7 +45,7 @@ module ieee802-dot1q-congestion-isolation-bridge {
   }
   feature congestion-isolation-bridge {
     description
-      "Feature Congestion Indication in Bridges";
+      "Feature Congestion Isolation in Bridges";
   }
   augment "/dot1q:bridges/dot1q:bridge/dot1q:component" {
     if-feature "congestion-isolation-bridge";