-The character set is in the file `charset-15.txt'. When you enter new
-characters, they are added there. If you do this, please email me
-your charset file (ijackson@chiark.greenend.org.uk) so that I can
-include your contributions in future versions. This will also let me
-check that they seem right :-).
+Now that you have read this document, you should rerun your OCR job
+with the --edit-charset option. You probably want to supply --same as
+well, to avoid having to wait for it to page through and recapture all
+the screenshots. So, this time,
+ ./ypp-commodities --edit-charset --same
+and in future, just always run it with the --edit-charset option.
+
+With --edit-charset, when the OCR finds characters it does not
+understand, it will put up an OCR resolution query window. This will
+display the part of the text it is having trouble with, showing where
+it has got to, and allow you to edit the character set dictionary it
+uses for recognising the text.
+
+The process is subtle and it is important to understand the way the
+machinery works, and the possible mistakes you can make, before
+answering the program. So *Please read this documentation*, which
+explains the meaning of the entries you make.
+
+Be sure to check or specify the dictionary to which the new glyph
+should be added. Normally the default will be the Word dictionary
+which is right if the match failure is a new word starting with l or I
+(see above). You will need to change this to the Upper or Lower
+dictionary for new ligatures. You should not need to add new Digits.
+
+Also, the character set updates you make will by default be submitted
+to my server so that they can be checked by me and shared with other
+users. See README.privacy.
+
+If you need help please ask me (ijackson@chiark.greenend.org.uk, or
+Aristarchus on Midnight in game if I'm on line, or ask any pirate of
+the crew Special Circumstances if they happen to know where I am
+and/or can get in touch).