Unhandle those keys that belong to the map "starter" but not

[m17n/m17n-db.git] / FORMATS / Dir.txt

diff --git a/FORMATS/Dir.txt b/FORMATS/Dir.txt
index 0b5a0f9..0105c6b 100644 (file)
--- a/FORMATS/Dir.txt
+++ b/FORMATS/Dir.txt
@@ -16,21 +16,24 @@ initialization time.  The plist format of this file is as follows:
 @verbatim
 MDB-DIR ::= DEFINITION *
 
-DEFINITION ::= '(' TAG0 [ TAG1 [ TAG2 [ TAG3 ] ] ] FILE ')'
+DEFINITION ::= '(' TAG0 [ TAG1 [ TAG2 [ TAG3 ] ] ] FILE [ VERSION ]')'
 
 TAGn ::= SYMBOL
 
 FILE ::= MTEXT
+
+VERSION ::= MTEXT
 @endverbatim
 
 If TAG0 is neither `charset' nor `char-table', and TAGn (n > 0) is a
 symbol `*', FILE can contain a wildcard charater, and all files
 matching FILE accoding to the rules used by the shell are the target
-of database files.  In that case, each file must contain a plist
-element providing the actual TAGn values by the form:
+of database files.  In that case, each file must contain
+SELF-DEFINITION which is a plist element providing the actual TAGn
+values by the form:
 
 @verbatim
-'(' TAG0 TAG1 TAG2 TAG3 ')'
+SELF-DEFINITION ::= '(' TAG0 TAG1 TAG2 TAG3 [ VERSION ] ')'
 @endverbatim
 
 For instance, if a database directory contains these files:
@@ -38,11 +41,9 @@ For instance, if a database directory contains these files:
 @verbatim
 zh-py.mim:
 (input-method zh py)
-...
 
 ko-han2.mim:
 (input-method ko han2)
-...
 @endverbatim
 
 these lines in "mdb.dir":
@@ -58,6 +59,10 @@ can be shortened to this single line:
 (input-method * "*.mim")
 @endverbatim
 
+VERSION is a required version number of the m17n library.  The format
+is "XX.YY.ZZ" where XX is a major version number, YY is a minor
+version number, and ZZ is a patch level.
+
 */
 
 /*