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

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

Revision: 3328
          http://sourceforge.net/p/axsl/code/3328
Author:   victormote
Date:     2026-07-17 13:03:27 +0000 (Fri, 17 Jul 2026)
Log Message:
-----------
Replace element "import-dictionary" with "import-standard-dictionary" and "import-adhoc-dictionary" and "resource-location".

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-16 17:17:29 UTC (rev 3327)
+++ trunk/axsl/axsl-00-dev/doc/web/dtds/0.1/en/axsl-dictionary.dtd	2026-07-17 13:03:27 UTC (rev 3328)
@@ -41,14 +41,20 @@
 1. Applications are expected to handle the content of multiple axsl-dictionary
 items from multiple sources during processing, so that they can be combined to
 capture the set of words that are valid in a document.
-2. If provided with part-of-speech information as /input/ (i.e. separate from
+2. The order in which various dictionaries are consulted when recognizing words
+is as follows:
+   1. The current dictionary.
+   2. Any imported adhoc dictionaries. Each of these in its own scope 
+   3. Any imported standard dictionaries.
+   4. Any standard dictionaries whose 
+3. If provided with part-of-speech information as /input/ (i.e. separate from
 information in this dictionary), applications are expected to use that
 information to select the correct usage.
 If such information is not provided, applications should fall back to use the
 first usage listed.
-3. Parsers should throw an exception for "word-group" elements whose contents do
+4. Parsers should throw an exception for "word-group" elements whose contents do
 not have identical spellings.
-4. Parsers should throw an exception for "word" elements that have the same
+5. Parsers should throw an exception for "word" elements that have the same
 semantics.
 
 
@@ -95,6 +101,9 @@
     "./axsl-parts-of-speech.dtd">
 %aXSL-Parts-of-Speech-DTD;
 
+<!ENTITY % Boolean "(true|false)">
+
+
 <!--
 Contains one or more axsl-dictionary items.
 This is suitable as a root element for document-specific files that need
@@ -110,29 +119,27 @@
 This is suitable as a root element for files that need to handle only one
 orthography.
 -->
-<!ELEMENT axsl-dictionary (import-dictionary*,
+<!ELEMENT axsl-dictionary (import-adhoc-dictionary*,
+  import-standard-dictionary*,
   (w | word-group | 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
 be enforced at some higher level than an XML editor.
-2. overrides: References the "id" attribute of some other axsl-dictionary,
-allowing this dictionary to logically include the content of another,
-overriding its content as needed.
 
-[The attributes language, script, country, and epoch are intended to match the
-meaning of those terms as used in this article:
+[The attributes language, script, country, defined below are intended to match
+the meaning of those terms as used in this article:
 https://www.w3.org/International/articles/language-tags
-except that "epoch" is a private-use subtag (see below).]
+The attribute "epoch" is a private-use subtag.]
 
-3. language: The 3-character ISO-639 code for the language to which the words
+2. language: The 3-character ISO-639 code for the language to which the words
 belong.
-4. script: The 4-character ISO-15924 code for the script being used.
-5. country: The 3-character ISO-3166 code for the country, if the words in this
+3. script: The 4-character ISO-15924 code for the script being used.
+4. country: The 3-character ISO-3166 code for the country, if the words in this
 dictionary are country-specific.
 If the intent is for this dictionary to contain words that are applicable to
 /any/ country in which "language" is spoken, do not set this attribute.
-6. epoch: A private-use subtag that describes the time period in which the
+5. epoch: A private-use subtag that describes the time period in which the
 dictionary applies.
 This is intended to allow one dictionary that overrides another to designate
 the approximate period in which its content would be considered valid.
@@ -140,7 +147,7 @@
 of "1920".
 See the following for information about private-use subtags:
 https://www.w3.org/International/articles/language-tags/#extension
-7. soft-hyphen-char: The character that is used in this dictionary to denote a
+6. soft-hyphen-char: The character that is used in this dictionary to denote a
 valid hyphenation point.
 Be sure to pick a character that will never occur in the actual spelling of any
 word in the dictionary, except, if that character is the hard hyphen character,
@@ -148,7 +155,7 @@
 other than the actual hard hyphen character.
 For languages where the hyphen character (both hard and soft) is "-", the
 recommended value for this attribute is "-".
-8. hard-hyphen-char: The character that is used in this dictionary to denote a
+7. hard-hyphen-char: The character that is used in this dictionary to denote a
 hard hyphenation point, i.e. where the hyphen is part of the word.
 For example, the English word "absent-minded" contains a hard hyphen.
 Word spellings in this dictionary will need to distinguish between hard and
@@ -169,18 +176,48 @@
 >
 
 <!--
-An optional ancillary dictionary, usually specialized in nature, that is to be effectively imported into this
+An optional standard dictionary, usually specialized in nature, that is to be
+effectively imported into this dictionary.
+This allows document-specific dictionaries to include such specialized items as
+(for example) medical or legal terms, Biblical names, etc.
+Implementations need not actually import these dictionaries, but should behave
+as if they have.
+-->
+<!ELEMENT import-standard-dictionary EMPTY>
+<!--
+1. id: The id of the standard dictionary to be effectively imported into this
+dictionary. This is used to retrieve the dictionary.
+-->
+<!ATTLIST import-standard-dictionary
+  id CDATA #REQUIRED
+>
+
+
+<!--
+An optional ad-hoc dictionary, usually document-specific, that is to be
+effectively imported into this dictonary.
+-->
+<!ELEMENT import-adhoc-dictionary (resource-location+)>
+<!--
+1. id: The id of the adhoc dictionary to be effectively imported into this
 dictionary.
-This allows document-specific dictionaries to include such specialized items as (for example) medical or legal terms,
-Biblical names, etc.
-Implementations need not actually import these dictionaries, but should behave as if they have. 
 -->
-<!ELEMENT import-dictionary EMPTY>
-<!ATTLIST import-dictionary
-  dictionary-id CDATA #REQUIRED
+<!ATTLIST import-adhoc-dictionary
+  id CDATA #REQUIRED
 >
 
+
 <!--
+Describes the location of a resource.
+-->
+<!ELEMENT resource-location EMPTY>
+<!ATTLIST resource-location
+  parsed %Boolean; #REQUIRED
+  url CDATA #REQUIRED
+>
+
+
+<!--
 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

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