HearThis 2.2.3 removed because of bug

HearThis
#1

A potentially serious issue came to my attention regarding version 2.2.3 of HearThis. I decided to remove that verison from the download server until I can fix the problem. If you have already upgraded to version 2.2.3 and your Scripture data does not use any of these markers:
\r, \iot, \io1, \io2, \io3
then this issue does not affect you and you can continue to use HearThis 2.2.3 with no problems whatsoever. Of those markers, only \r is used in Scripture. the others are used only in introductory material, so if you are only using those markers and you are not recording the introductory material, this problem will not affect you either.
If you are using one of those markers and are using HearThis 2.2.3 to record chapters or introductions that do contain one or more of those markers, you will probably notice what appears to be missing or corrupted data. In fact, none of the clip files was altered, but they may no longer correspond to the block of text they are associated with. Until version 2.2.4 is released with a fix to this problem, you have two choices:

  • Revert to version 2.2.2. This is probably the safest approach. Note that to do this you will have to manually uninstall HearThis 2.2.3 first (using Add or Remove programs).
  • Continue to use 2.2.3 but carefully avoid recording anything in a chapter or introduction that uses one of those markers, unless you are recording the whole thing.

When 2.2.4 is released, it will include an automated data migration to re-align any clip files affected by the change that wa sintroduced in 2.2.3. However, the data migration will not do anything in any chapters or introductions where you have either recorded or manually skipped any blocks using version 2.2.3. This is because it would be impossible to know what - if anything - needs to be cleaned up. Although I hope this will not end up adversely affecting any of our users, I thought it would be best to try to make everyone aware of this. If version 2.2.4 tells you that the data migration was unable to clean up one or more chapters and you need help to try to resolve problems, please reach out to me using this forum, and I will make it a top priority to help you.

#2

There is a new “test” version to address this problem. As a precaution, I recommend a full backup of of all HearThis data files (typically in c:\ProgramData\SIL\HearThis) before installing this version. I plan to release this very soon, but it would be great if I could get a few people willing to test it on a real project first. Please post here if you install and use this version and indicate whether you have any trouble. If you use the \r (parallel passage) marker or any of the table of content markers in your introductions, please look at a couple chapter/introductions where those are used both before installing the new version and after the new version runs its data migration, and confirm that the data migration fixed the problem. Even if you don’t use any of those markers, it would still be helpful to have you run this test version to make sure nothing unexpected happens. (In this case, the data migration should have no noticeable effect - it will just increment an internal version number.)
Please note that if you do try this version, when the new official 2.2.4 version is released, you will need to manually uninstall the test version before installing the official version.
Thanks for your help!

#3

Version 2.2.4 has been released. This release includes a data migration that will re-align clips with the text for any places where the previous release might have caused them to get out of sync. The migration will be performed automatically when a project is opened and should be allowed to run to completion without interrupting it. For most projects it will be fairly fast and you will not notice it, but for large projects with many affected chapters, there might be a slight delay. As a precaution, if possible, we recommend making a backup of all files in C:\ProgramData\SIL\HearThis\ before starting HearThis as a safeguard against any unlikely problems that might occur during the migration. If your Scripture data does not use \r (Parallel passage reference), or any of the Introductory outline styles, you can disregard this, as the migration will not make any changes to your HearThis data files.