perfsonar-dev - nmwg: r230 - trunk/nmwg/schema/rnc
Subject: perfsonar development work
List archive
- From:
- To: ,
- Subject: nmwg: r230 - trunk/nmwg/schema/rnc
- Date: Mon, 7 May 2007 09:12:04 -0400
Author: swany
Date: 2007-05-07 09:12:03 -0400 (Mon, 07 May 2007)
New Revision: 230
Modified:
trunk/nmwg/schema/rnc/nmbase.rnc
trunk/nmwg/schema/rnc/nmtime.rnc
trunk/nmwg/schema/rnc/nmtopo.rnc
trunk/nmwg/schema/rnc/ping.rnc
Log:
updates to comments
Modified: trunk/nmwg/schema/rnc/nmbase.rnc
===================================================================
--- trunk/nmwg/schema/rnc/nmbase.rnc 2007-05-07 12:50:06 UTC (rev 229)
+++ trunk/nmwg/schema/rnc/nmbase.rnc 2007-05-07 13:12:03 UTC (rev 230)
@@ -1,10 +1,9 @@
# ##############################################################
#
-# File: nmbase.rnc - Main schema definition
-# Version: $Id$
-# Purpose: This is the main relax schema file, it defines
-# the general makeup of an NMWG structured message.
-# Reference: http://books.xmlschemata.org/relaxng/page2.html
+# File: nmbase.rnc - Main schema definition
+# Version: $Id$
+# Purpose: This is the main schema file, it defines the
+# general structure of an NMWG message or store
#
# ##############################################################
@@ -22,8 +21,8 @@
include "filter.rnc"
# ##############################################################
-# Every suitable NMWG document should begin with either a
-# 'store' or 'message' element, in the appropriate namespace.
+# Every NMWG document should begin with either a 'store' or
+# 'message' element
# Patterns are defined for the content of each element.
#
# Example (using message):
@@ -33,11 +32,11 @@
# type="REQUIRED_TYPE"
# xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
#
-# <!-- TBD OPTIONAL PARAMETERS -->
+# <!-- OPTIONAL PARAMETERS -->
#
-# <!-- TBD OPTIONAL (MULTIPLE) METADATA -->
+# <!-- OPTIONAL (MULTIPLE) METADATA -->
#
-# <!-- TBD OPTIONAL (MULTIPLE) DATA -->
+# <!-- OPTIONAL (MULTIPLE) DATA -->
#
# </nmwg:message>
#
@@ -76,13 +75,10 @@
# ##############################################################
-# Metadata is the 'data' that describes physical measurements.
-# Metadata can be a physical address or a geographical location;
-# any form of static, re-usable designation. It is important to
-# note that the subject namespace and parameters namespace MUST
-# match (or the parameters can be a generic NMWG) or bad things
-# will occur.
+# Metadata is the information that describes data. This
+# information doesn't change over time
#
+#
# Example:
#
# <nmwg:metadata id="REQUIRED_ID"
@@ -312,12 +308,15 @@
}
# ##############################################################
-# CommonTime is used as a shortcut that is able to 'factor out'
-# a frequently occurring time range that a bunch of datum (or
-# other) elements might share, thus reducing complexity of XML
-# representation. CommonTime is similar to the other NMWG time
+# CommonTime is used as a shortcut that is able to 'factor out'
+# a frequently occurring time range that a group of datum (or
+# other) elements might share, thus reducing the verbosity of the
+# XML representation. CommonTime is similar to the other NMWG time
# stamps (from nmtime.rnc) in its potential time representations.
#
+# It is unfortunate that it needs to be in this file and not
+# nmtime.rnc, but as it occurs outside the datum, it is here.
+#
# Example:
#
# <nmwg:commonTime type="REQUIRED_TYPE" value="OPTIONAL_VALUE"
@@ -325,11 +324,13 @@
# inclusive="OPTIONAL_INCLUSIVE_FLAG"
# xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
#
-# <!-- TBD OPTIONAL START TIME ELEMENT (USE END TIME OR DURATION) -->
+# <!-- TBD OPTIONAL START TIME ELEMENT (USE END TIME OR
+# DURATION) -->
#
# <!-- TBD OPTIONAL END TIME ELEMENT (ONLY WITH START TIME) -->
#
-# <!-- TBD OPTIONAL TIME VALUE ELEMENT (USE IF NO VALUE ATTRIBUTE) -->
+# <!-- TBD OPTIONAL TIME VALUE ELEMENT (USE IF NO VALUE
+# ATTRIBUTE) -->
#
# <!-- TBD OPTIONAL (MULTIPLE) DATUM ELEMENTS -->
#
Modified: trunk/nmwg/schema/rnc/nmtime.rnc
===================================================================
--- trunk/nmwg/schema/rnc/nmtime.rnc 2007-05-07 12:50:06 UTC (rev 229)
+++ trunk/nmwg/schema/rnc/nmtime.rnc 2007-05-07 13:12:03 UTC (rev 230)
@@ -1,11 +1,9 @@
# ##############################################################
#
-# File: nmtime.rnc - NMWG Time definitions
-# Version: $Id$
-# Purpose: This describes a general time format for
-# representing measurements. It is far from complete,
-# and may be best represented by other methods.
-# Reference: http://books.xmlschemata.org/relaxng/page2.html
+# File: nmtime.rnc - NMWG Time definitions
+# Version: $Id$
+# Purpose: This describes a set of time formats for
+# representing measurements.
#
# ##############################################################
Modified: trunk/nmwg/schema/rnc/nmtopo.rnc
===================================================================
--- trunk/nmwg/schema/rnc/nmtopo.rnc 2007-05-07 12:50:06 UTC (rev 229)
+++ trunk/nmwg/schema/rnc/nmtopo.rnc 2007-05-07 13:12:03 UTC (rev 230)
@@ -1,12 +1,8 @@
# ##############################################################
#
-# File: nmtopo.rnc - Schema to describe topological
-# features to be used in subject
+# File: nmtopo.rnc - Schema to describe topological
# elements.
-# Version: $Id$
-# Purpose: This file lays out some major network topologies
-# used in measurement.
-# Reference: http://books.xmlschemata.org/relaxng/page2.html
+# Version: $Id$
#
# ##############################################################
Modified: trunk/nmwg/schema/rnc/ping.rnc
===================================================================
--- trunk/nmwg/schema/rnc/ping.rnc 2007-05-07 12:50:06 UTC (rev 229)
+++ trunk/nmwg/schema/rnc/ping.rnc 2007-05-07 13:12:03 UTC (rev 230)
@@ -3,10 +3,8 @@
# File: ping.rnc - Specialized schema for the ping
# tool
# Version: $Id$
-# Purpose: Describes specific elements to be used in the
-# representation and handling of ping
-# measurements.
-# Reference: http://books.xmlschemata.org/relaxng/page2.html
+# Purpose: Defines elements to be used in the representation
+# of ping measurements.
#
# ##############################################################
@@ -32,31 +30,7 @@
# ##############################################################
-# Metadata is the 'data' that describes physical measurements.
-# Metadata can be something such as a physical address, or
-# a geographical location; any form of static, re-usable
-# designation. It is important to note that the subject
-# namespace and parameters namespace MUST match (or the parameters
-# can be a generic NMWG) or bad things will occur.
-#
-# Example:
-#
-# <nmwg:metadata id="REQUIRED_ID"
-# metadataIdRef="OPTIONAL_REFERENCE_ID"
-# xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
-#
-# <!-- TBD OPTIONAL SUBJECT -->
-#
-# <!-- TBD OPTIONAL PARAMETERS -->
-#
-# <!-- TBD OPTIONAL EVENTTYPE -->
-#
-# <!-- TBD OPTIONAL KEY -->
-#
-# <!-- ANY OPTIONAL (MULTIPLE) ELEMENT IN ANY NAMESPACE -->
-#
-# </nmwg:metadata>
-#
+# Metadata
# ##############################################################
PingMetadata =
@@ -220,30 +194,7 @@
# ##############################################################
-# CommonTime is used a a shortcut able to 'factor out' a frequently
-# occurring time range that a bunch of datum (or other) elements
-# might share, thus reducing complexity of XML representation.
-# CommonTime is similar to the other NMWG time stamps (from
-# nmtime.rnc) in its potential time representations.
-#
-# Example:
-#
-# <nmwg:commonTime type="REQUIRED_TYPE" value="OPTIONAL_VALUE"
-# duration="OPTIONAL_DURATION"
-# inclusive="OPTIONAL_INCLUSIVE_FLAG"
-# xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
-#
-# <!-- TBD OPTIONAL START TIME ELEMENT (USE END TIME OR DURATION) -->
-#
-# <!-- TBD OPTIONAL END TIME ELEMENT (ONLY WITH START TIME) -->
-#
-# <!-- TBD OPTIONAL TIME VALUE ELEMENT (USE IF NO VALUE ATTRIBUTE) -->
-#
-# <!-- TBD OPTIONAL (MULTIPLE) DATUM ELEMENTS -->
-#
-# <!-- ANY OPTIONAL (MULTIPLE) ELEMENT IN ANY NAMESPACE -->
-# </nmwg:commonTime>
-#
+# CommonTime
# ##############################################################
PingCommonTime =
- nmwg: r230 - trunk/nmwg/schema/rnc, svnlog, 05/07/2007
Archive powered by MHonArc 2.6.16.