Macintosh-SW
/
syncfiles
mirror of https://github.com/depp/syncfiles.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README to reflect changes

This commit is contained in:
Dietrich Epp 2022-03-15 16:27:52 -04:00
parent f94a65d245
commit 7c5699b508
1 changed files with 3 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
gen/README.md
View File

@ -1,11 +1,7 @@
# Character Conversion Tables
# Character Conversion Data Generator
Used by SyncFiles.
This program generates the tables necessary to convert from UTF-8 to Mac OS Roman.
This program generates the tables necessary to convert between UTF-8 and various historical Mac OS character sets. Not all character sets are currently supported.
The conversion process is entirely table-driven. The table maps a (state, input) pair to a (state, output) pair. The initial state is 0. A transition to state 0 is considered invalid.
A transition may have _both_ a state and output. This means that the input may be translated in different ways depending on the bytes that follow. The translation code prefers the longest path through the state table that results in an output.
The table is compressed with PackBits to reduce its size by a factor of 22x.
Right now, the table format is not quite finalized, so the output is not checked in to version control. This means that you have to run this program in order to generate the data and compile SyncFiles. It is planned to check the data files in, making this step unnecessary.