IGNORE

LICENSE.md

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+   protected by copyright and related or neighboring rights ("Copyright and
+   Related Rights"). Copyright and Related Rights include, but are not
+   limited to, the following:
+
+i. the right to reproduce, adapt, distribute, perform, display,
+communicate, and translate a Work;
+ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+likeness depicted in a Work;
+iv. rights protecting against unfair competition in regards to a Work,
+subject to the limitations in paragraph 4(a), below;
+v. rights protecting the extraction, dissemination, use and reuse of data
+in a Work;
+vi. database rights (such as those arising under Directive 96/9/EC of the
+European Parliament and of the Council of 11 March 1996 on the legal
+protection of databases, and under any national implementation
+thereof, including any amended or successor version of such
+directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+world based on applicable law or treaty, and any national
+implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+   of, applicable law, Affirmer hereby overtly, fully, permanently,
+   irrevocably and unconditionally waives, abandons, and surrenders all of
+   Affirmer's Copyright and Related Rights and associated claims and causes
+   of action, whether now known or unknown (including existing as well as
+   future claims and causes of action), in the Work (i) in all territories
+   worldwide, (ii) for the maximum duration provided by applicable law or
+   treaty (including future time extensions), (iii) in any current or future
+   medium and for any number of copies, and (iv) for any purpose whatsoever,
+   including without limitation commercial, advertising or promotional
+   purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+   member of the public at large and to the detriment of Affirmer's heirs and
+   successors, fully intending that such Waiver shall not be subject to
+   revocation, rescission, cancellation, termination, or any other legal or
+   equitable action to disrupt the quiet enjoyment of the Work by the public
+   as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+   be judged legally invalid or ineffective under applicable law, then the
+   Waiver shall be preserved to the maximum extent permitted taking into
+   account Affirmer's express Statement of Purpose. In addition, to the
+   extent the Waiver is so judged Affirmer hereby grants to each affected
+   person a royalty-free, non transferable, non sublicensable, non exclusive,
+   irrevocable and unconditional license to exercise Affirmer's Copyright and
+   Related Rights in the Work (i) in all territories worldwide, (ii) for the
+   maximum duration provided by applicable law or treaty (including future
+   time extensions), (iii) in any current or future medium and for any number
+   of copies, and (iv) for any purpose whatsoever, including without
+   limitation commercial, advertising or promotional purposes (the
+   "License"). The License shall be deemed effective as of the date CC0 was
+   applied by Affirmer to the Work. Should any part of the License for any
+   reason be judged legally invalid or ineffective under applicable law, such
+   partial invalidity or ineffectiveness shall not invalidate the remainder
+   of the License, and in such case Affirmer hereby affirms that he or she
+   will not (i) exercise any of his or her remaining Copyright and Related
+   Rights in the Work or (ii) assert any associated claims and causes of
+   action with respect to the Work, in either case contrary to Affirmer's
+   express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+a. No trademark or patent rights held by Affirmer are waived, abandoned,
+surrendered, licensed or otherwise affected by this document.
+b. Affirmer offers the Work as-is and makes no representations or
+warranties of any kind concerning the Work, express, implied,
+statutory or otherwise, including without limitation warranties of
+title, merchantability, fitness for a particular purpose, non
+infringement, or the absence of latent or other defects, accuracy, or
+the present or absence of errors, whether or not discoverable, all to
+the greatest extent permissible under applicable law.
+c. Affirmer disclaims responsibility for clearing rights of other persons
+that may apply to the Work or any use thereof, including without
+limitation any person's Copyright and Related Rights in the Work.
+Further, Affirmer disclaims responsibility for obtaining any necessary
+consents, permissions or other rights required for any use of the
+Work.
+d. Affirmer understands and acknowledges that Creative Commons is not a
+party to this document and has no duty or obligation with respect to
+this CC0 or use of the Work.

appa.adoc

@@ -1,15 +1,16 @@
-
 [[attribute-appendix, Appendix A, Attributes]]
 
 [appendix]
 == Attributes
 
 All CF attributes are listed here except for those that are used to describe grid mappings and mesh topologies.
-See Appendix F for the grid mapping attributes, and Appendix K for mesh topology attributes.
+See <<appendix-grid-mappings>> for the grid mapping attributes, and <<appendix-mesh-topology-attributes>> for mesh topology attributes.
 
 The "Type" values are **S** for string, **N** for numeric, and **D** for the type of the data variable.
 Each attribute may be used in any of the ways shown in its "Use" entry.
-**G** indicates it can appear as a global attribute, and **Gr** as a group attribute; if use of an attribute is restricted to certain kinds of variables this is indicated as follows: **C** for variables containing coordinate data, **D** for data variables, **M** for geometry container variables, **Do** for domain variables, **BI** and **BO** for boundary variables (see <<cell-boundaries>> for the distinction between **BI** and **BO**), and **-** for variables with some other purpose.
+**G** indicates it can appear as a global attribute, and **Gr** as a group attribute.
+For variable attributes, the possible values of "Use" are: **C** for variables containing coordinate data, **D** for data variables, **M** for geometry container variables, **Do** for domain variables, **BI** and **BO** for boundary variables (see <<cell-boundaries>> for the distinction between **BI** and **BO**), **A** for an aggregation variable, and **-** for variables with some other purpose.
+CF does not prohibit any of these attributes from being attached to variables of different kinds from those listed as their "Use" in this table, but their meanings are not defined by CF if they are used in these other ways.
 "Links" indicates the location of the attribute"s original definition (first link) and sections where the attribute is discussed in this document (additional links as necessary).
 
 [[table-attributes]]
@@ -37,6 +38,18 @@ Attribute
 If both **`scale_factor`** and **`add_offset`** attributes are present, the data are first scaled before the offset is added.
 In cases where there is a strong constraint on dataset size, it is allowed to pack the coordinate variables (using add_offset and/or scale_factor), but this is not recommended in general.
 
+| **`aggregated_data`**
+| S
+| A
+| <<aggregated-data>>
+| Records the aggregation instructions that define how to create an aggregation variable's aggregated data.
+
+| **`aggregated_dimensions`**
+| S
+| A
+| <<aggregated-dimensions>>
+| Identifies the dimensions of an aggregation variable's aggregated data.
+
 | **`ancillary_variables`**
 | S
 | D
@@ -76,8 +89,9 @@ In cases where there is a strong constraint on dataset size, it is allowed to pa
 | **`cf_role`**
 | S
 | C, BI
-| <<coordinates-metadata>>, and <<mesh-topology-variables>> 
-| Identifies the roles of variables that identify features in discrete sampling geometries; and the roles of mesh topology and location index set variables.
+| <<coordinates-metadata>>
+| Identifies the roles of variables that identify features in discrete sampling geometries.
+Identifies the roles of mesh topology and location index set variables (see <<appendix-mesh-topology-attributes>>).
 
 | **`climatology`**
 | S
@@ -373,6 +387,3 @@ In cases where there is a strong constraint on dataset size, it is allowed to pa
 | link:$$https://www.unidata.ucar.edu/software/netcdf/docs/attribute_conventions.html$$[NUG Appendix A, "Attribute Conventions"]
 | Smallest and largest valid values of a variable.
 |===============
-
-
-

appb.adoc

@@ -1,4 +1,3 @@
-
 [[standard-name-table-format, Appendix B, Standard Name Table Format]]
 
 [appendix]
@@ -26,20 +25,25 @@ Next is the **`standard_name_table`** itself, which is bracketed by the tags **`
 The content (delimited by the `<standard_name_table>` tags) consists of, in order,
 
 ----
+  <version_number>Version number here ... </version_number>
+  <conventions>Conventions string here ... </conventions>
+  <first_published>Datetime of first publication to the website ... </first_published>
+  <last_modified>Datetime stamp here ... </last_modified>
   <institution>Name of institution here ... </institution>
   <contact>E-mail address of contact person ... </contact>
 ----
 
-followed by a sequence of **`entry`** elements which may optionally be followed by a sequence of **`alias`** elements.
+where the "Conventions string" is  composed of the fixed string **`CF-StandardNameTable-`** immediately followed by the version number.
+
+Next follows a sequence of **`entry`** elements which may optionally be followed by a sequence of **`alias`** elements.
 The **`entry`** and **`alias`** elements take the following forms:
 
 ----
   <entry id="an_id">
       Define the variable whose standard_name attribute has the value "an_id".
   </entry>
   <alias id="another_id">
-      Provide alias for a variable whose standard_name attribute has the
-        value "another_id".
+      Provide alias for a variable whose standard_name attribute has the value "another_id".
   </alias>
 ----
 
@@ -81,13 +85,25 @@ Each **`alias`** element contains a single element:
   </alias>
 ----
 
+In exceptional cases the **`alias`** element may contain two elements:
+
+----
+  <alias id="an_id">
+    <entry_id>Identifier of a defining entry ... </entry_id>
+    <entry_id>Identifier of another defining entry ... </entry_id>
+  </alias>
+----
+
+
 [[name-table-three-entries-ex]]
 [caption="Example B.1. "]
 .A name table containing three entries
 ====
 ----
   <?xml version="1.0"?>
   <standard_name_table>
+    <version_number>83</version_number>
+    <conventions>CF-StandardNameTable-83</conventions>
     <institution>Program for Climate Model Diagnosis and Intercomparison</institution>
     <contact>[email protected]</contact>
     <entry id="surface_air_pressure">
@@ -113,6 +129,7 @@ Each **`alias`** element contains a single element:
     </alias>
   </standard_name_table>
 ----
+
 The definition of a variable with the **`standard_name`** attribute **`surface_air_pressure`** is found directly since the element with **`id="surface_air_pressure"`** is an **`entry`** element which contains the definition.
 
 The definition of a variable with the **`standard_name`** attribute mean_sea_level_pressure is found indirectly by first finding the element with the **`id="mean_sea_level_pressure"`**, and then, since this is an alias element, by searching for the element with **`id="air_pressure_at_sea_level"`** as indicated by the value of the **`entry_id`** tag.

appc.adoc

@@ -1,4 +1,3 @@
-
 [[standard-name-modifiers, Appendix C, Standard Name Modifiers]]
 
 [appendix]