[aXSL-commit] SF.net SVN: axsl:[3333] trunk/axsl/axsl-00-dev/doc/we b/dtds/0.1/en/axsl-dictionary.dtd

[<vic...@us...>]

Revision: 3333
          http://sourceforge.net/p/axsl/code/3333
Author:   victormote
Date:     2026-07-22 13:48:49 +0000 (Wed, 22 Jul 2026)
Log Message:
-----------
Change element "word-group" to "ambiguous-word", for clarity.

Modified Paths:
--------------
    trunk/axsl/axsl-00-dev/doc/web/dtds/0.1/en/axsl-dictionary.dtd

Modified: trunk/axsl/axsl-00-dev/doc/web/dtds/0.1/en/axsl-dictionary.dtd
===================================================================
--- trunk/axsl/axsl-00-dev/doc/web/dtds/0.1/en/axsl-dictionary.dtd	2026-07-21 10:45:08 UTC (rev 3332)
+++ trunk/axsl/axsl-00-dev/doc/web/dtds/0.1/en/axsl-dictionary.dtd	2026-07-22 13:48:49 UTC (rev 3333)
@@ -52,8 +52,9 @@
 information to select the correct usage.
 If such information is not provided, applications should fall back to use the
 first usage listed.
-4. Parsers should throw an exception for "word-group" elements whose contents do
-not have identical spellings.
+4. Parsers should throw an exception for "ambiguous-word" elements whose
+contents do not have identical spellings, or whose contents are not in fact
+ambiguous.
 5. Parsers should throw an exception for "word" elements that have the same
 semantics.
 
@@ -101,7 +102,7 @@
     "./axsl-parts-of-speech.dtd">
 %aXSL-Parts-of-Speech-DTD;
 
-<!ENTITY % Boolean "(true|false)">
+<!ENTITY % boolean "(true|false)">
 
 
 <!--
@@ -121,7 +122,7 @@
 -->
 <!ELEMENT axsl-dictionary (import-adhoc-dictionary*,
   import-standard-dictionary*,
-  (section | w | word-group | phrase | word-placeholder)*)>
+  (section | w | ambiguous-word | phrase | word-placeholder)*)>
 <!--
 1. id: Used to allow one dictionary to point to another. It is an error for
 more than one dictionary document to have the same id, although that must
@@ -212,7 +213,7 @@
 -->
 <!ELEMENT resource-location EMPTY>
 <!ATTLIST resource-location
-  parsed %Boolean; #REQUIRED
+  parsed %boolean; #REQUIRED
   url CDATA #REQUIRED
 >
 
@@ -219,7 +220,7 @@
 
 <!-- Artificial subdivision for human navigation purposes. -->
 <!ELEMENT section
-(section | w | word-group | phrase | word-placeholder)* >
+(section | w | ambiguous-word | phrase | word-placeholder)* >
 <!ATTLIST section
   description CDATA #IMPLIED
 >
@@ -226,29 +227,26 @@
 
 
 <!--
-Optional element containing two or more words that have identical spelling, but
-that have different semantics.
-Currently the only semantic difference contemplated is a difference in
+Groups two or more words that have identical spelling, but whose hyphenation
+points are different.
+Parsers should throw an exception for ambiguous-word elements whose contents do
+not have identical spellings, and for elements that do not have different
 hyphenation.
-Parsers should throw an exception for word-group elements whose contents do not
-have identical spellings.
-However, parsers and processors should handle word-group as optional.
-It exists only for the benefit of the dictionary author.
 -->
-<!ELEMENT word-group (w, w+) >
+<!ELEMENT ambiguous-word (w, w+) >
 
 <!--
 A valid word in this language.
-By "word" is meant a sequence of characters whose semantics are unique.
-By "semantics" here is meant that the content of the enclosed "text" element is
+By "word" is meant a sequence of characters whose spelling and hyphenation is
 unique.
 For purposes of this dictinary, differences of meaning, pronunciation, and
 part of speech are not considered, i.e. these differences can exist and the
 word is still considered to be the same word.
-As an example of different words with the same spelling, the English word
-"record" can be a noun, hyphenated "rec-ord", or a verb, hyphenated "re-cord".
-These should be treated as different words in this dictionary, but could both be
-placed inside the same word-group.
+Words having the same spelling, but different hyphenation, should each be in
+their own "w" element, and those elements should be placed inside an
+"ambiguous-word" element.
+An example of such a word is the English word "record," which can be a noun,
+hyphenated "rec-ord", or a verb, hyphenated "re-cord".
 -->
 <!ELEMENT w (t, (abbrev | contraction | (%parts-of-speech;))?, comment?)>
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.