From: Kurt Zeilenga <kurt@openldap.org>
Date: Tue, 6 Aug 2002 04:03:13 +0000 (+0000)
Subject: Update string commment with examples.
X-Git-Tag: NO_SLAP_OP_BLOCKS~1274
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=48f72b68629a2b847277210baaf606ac7c5ace7a;p=openldap

Update string commment with examples.
---

diff --git a/servers/slapd/schema_init.c b/servers/slapd/schema_init.c
index aa15dc3312..63b41b2da6 100644
--- a/servers/slapd/schema_init.c
+++ b/servers/slapd/schema_init.c
@@ -29,22 +29,33 @@ Directory String -
 NumericString
   In ASN.1, numeric string is just a string of digits and spaces and
   could be empty.  However, in X.500, all attribute values of numeric
-  string carry a non-empty constraint.  Unfornately, some assertion
-  values are don't carry this constraint (but its unclear how such
-  an assertion could ever be true).  In LDAP, there is one syntax
-  (numericString) not two (numericString with constraint, numericString
-  without constraint).  This should be treated as numericString with
-  non-empty constraint.
+  string carry a non-empty constraint.  For example:
+
+	internationalISDNNumber ATTRIBUTE ::= {
+		WITH SYNTAX InternationalISDNNumber
+		EQUALITY MATCHING RULE numericStringMatch
+		SUBSTRINGS MATCHING RULE numericStringSubstringsMatch
+		ID id-at-internationalISDNNumber }
+	InternationalISDNNumber ::= NumericString (SIZE(1..ub-international-isdn-number))
+
+  Unfornately, some assertion values are don't carry the same constraint
+  (but its unclear how such an assertion could ever be true). In LDAP,
+  there is one syntax (numericString) not two (numericString with constraint,
+  numericString without constraint).  This should be treated as numericString
+  with non-empty constraint.  Note that while someone may have no
+  ISDN number, there are no ISDN numbers which are zero length.
 
   In matching, spaces are ignored.
 
 PrintableString
   In ASN.1, Printable string is just a string of printable characters and
-  can be empty.  In X.500, semantics much like NumericString excepting
-  uses insignificant space handling instead of ingore all spaces.
+  can be empty.  In X.500, semantics much like NumericString (see serialNumber
+  for a like example) excepting uses insignificant space handling instead of
+  ignore all spaces.  
 
 IA5String
-  Basically same as PrintableString.
+  Basically same as PrintableString.  There are no examples in X.500, but
+  same logic applies.  So we require them to be non-empty as well.
 
 ****/