erabo/spiegel-keyman
1
0
Fork 0
mirror of https://github.com/keymanapp/keyman.git synced 2026-08-13 12:19:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 20

spec(core): ldml: Drop padding 🙀

Browse source 
- only guarantee is 32 bit alignment
- also note a cross ref TODO for #7533

For: #7987
This commit is contained in:
Steven R. Loomis 2023-01-09 15:08:11 -06:00
parent e4799d2498
commit fbbed6d970
1 changed files with 5 additions and 20 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
core/src/ldml/C7043_ldml.md
View file

@ -27,10 +27,7 @@ Draft spec PR: <https://github.com/unicode-org/cldr/pull/1847>
- Data is divided into several sections. The very first section is the `'sect'`
section which is the table of contents.
- All sections, including the first, begin on a 128-bit boundary with zero
padding as needed.
- All variable length sections have the variable part begin on a 128-bit
boundary, with zero padding as needed.
- All sections, including the first, are padded to a 32-bit boundary.
- All sections begin with a 32-bit (four character) section identifier, and a
32-bit section size.
- Other than the `sect` table itself, the rest of the sections follow in binary
@ -73,7 +70,6 @@ See [C7043.2.11](#c7043211-tran-finl-and-bksptransforms).
| 0 | 32 | ident | `elem` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of element string entries |
|12 | 32 | reserved | padding |
Then for each element string:
@ -119,7 +115,6 @@ See [C7043.2.11](#c7043211-tran-finl-and-bksptransforms).
| 0 | 32 | ident | `keys` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of keys |
|12 | 32 | reserved | reserved |
The keys are sorted in binary order based on the `vkey` and `mod` fields.
@ -136,7 +131,7 @@ For each key:
etc.). It is resolved because the `vkeyMap` from LDML has already been
applied. If this is 256 or above, it is a custom touch layout vkey generated
by the compiler.
- `mod`: TODO define this. 0 for no modifiers.
- `mod`: TODO-LDML define this. 0 for no modifiers. #7533
- `flags`: Flags is a 32-bit bitfield defined as below:
| Bit position | Meaning | Description |
@ -153,7 +148,6 @@ For each key:
| 0 | 32 | ident | `loca` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of locales |
|12 | 32 | reserved| padding |
`count` is always ≥1, because a keyboard always has a primary locale identifier.
@ -198,7 +192,6 @@ be present, as the source format requires at least one name.
| 0 | 32 | ident | `name` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of names |
|12 | 32 | reserved| padding |
Note that `count` is always ≥1, as the source format requires at least one name.
@ -218,7 +211,6 @@ not defined here.
| 0 | 32 | ident | `ordr` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of reorders |
|12 | 32 | reserved | padding |
For each reorder item:
@ -240,7 +232,6 @@ All strings are stored in the Strings section.
| 0 | 32 | ident | `strs` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of strings |
|12 | 32 | reserved | Padding |
Then for each string:
@ -278,7 +269,6 @@ table has the ident `finl`, and the backspaces table has the ident `bksp`.
| 0 | 32 | ident | `tran` / `finl` / `bksp` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of transforms |
|12 | 32 | reserved | padding |
The transforms are sorted in binary order based on the `from` field.
@ -310,7 +300,6 @@ For each transform:
| 0 | 32 | ident | `vkey` |
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Number of vkeys |
|12 | 32 | reserved| padding |
The keys are sorted in binary order based on the `vkey` field.
@ -337,8 +326,7 @@ Represents layers on the keyboard.
|12 | 32 | layerCount | int: number of layer entries |
|16 | 32 | rowCount | int: number of row entries |
|20 | 32 | keyCount | int: number of key entries |
|24 | 64 | reserved | padding |
|32 | var | lists | layer list sub-table |
|24 | var | lists | layer list sub-table |
| - | var | layers | layers sub-table |
| - | var | rows | rows sub-table |
| - | var | keys | keys sub-table |
@ -404,7 +392,6 @@ There are `keyCount` total key entries.
| 4 | 32 | size | int: Length of section |
| 8 | 32 | count | int: Total number of disp elements |
|12 | 32 | baseCharacter | str: If non-null, default base. |
|16 | 128 | reserved | padding (future displayOptions) |
The default `baseCharacter` is U+25CC, if `baseCharacter` is null.
@ -426,8 +413,7 @@ Entries are sorted in a binary codepoint sort on the `to` field.
| 8 | 32 | keyCount | int: Number of keys |
|12 | 32 | flicksCount | int: Number of flick lists |
|16 | 32 | flickCount | int: Number of flick elements |
|20 | 96 | reserved | padding |
|32 | var | keys | keys sub-table |
|20 | var | keys | keys sub-table |
| - | var | flicks | flick lists sub-table |
| - | var | flick | flick elements sub-table |
@ -540,6 +526,5 @@ The strings order are significant. There is not a 'null' string at the end of e
## TODO-LDML: various things that need to be completed here or fixed in-spec
> * UnicodeSets
> * spec: reference to `after` in reorders; various other @after refs
> * spec: ABNT2 key has hex value 0xC1 (even if kbdus.dll doesn't produce that)
> * `keys.key.mod`: TODO define this. 0 for no modifiers.
> * `keys.key.mod`: TODO define this. 0 for no modifiers. #7533