Adapt It version 6.10.0 release
30 April 2020

Feature changes and new features in the 6.10.0 release

  • The Insert A Placeholder tool bar button has been replaced by two new buttons in the tool bar: Insert Placeholder To Left of Selection/Phrasebox, and Insert Placeholder to Right of Selection/PhraseBox. The insertion of placeholders has been made smarter so that the user is no longer asked to tell Adapt It whether a placeholder will associate with what comes before or after it.
  • One user reported that collaboration would not work after updating from Paratext 8 to Paratext 9. Adapt It is now fully compatible with Paratext 9 when set up for collaboration with Paratext. Also some dialogs were updated to recognize/facilitate collaboration with Paratext 9. (Although not recommended, Adapt It also still collaborates successfully with Paratext 7.)
  • Removed the prohibition against removing < and > from the list of punctuation characters. This gives Adapt It more flexibility for handling unusual custom markup. Such removal should not be done without good reason; but now it can be done. For example, if curly quotes are being used for speech markup, and the custom markup in the document uses < and/or > as word-building characters, that would be a scenario where removing the wedges from the punctuation list makes good sense.
  • Made the app compliant with USFM 3.0’s new attribute marker features.
  • Made the app not show metadata with attributes in the GUI, but auto-restoring them to the document when the document is being exported to Paratext or Bibledit in a collaboration; or when, out of a collaboration, the user requests an export of the source text (as USFM). The idea behind this change is as follows: attributes metadata in the content of some USFM3 standard format markers is a nuisance if seen in Adapt It, but Paratext needs that stuff, so what Paratext needs is hidden away automatically so the user is not bothered by it when adapting; but it (magically) reappears in the data being sent to Paratext in a collaboration – because it’s only Paratext that needs it – as it’s publication-related stuff. Note: when the restored metadata appears in the Paratext (or Bibledit) target text project, any adaptable content within that metadata will not have been translated. The onus is then on the user doing any necessary translating of that kind of metadata content, manually within the collaborating Paratext project that accepts the target text.
  • There is now a check box on the “Choose a Document” page of the wizard and also on the “Get Source Text From Editor” dialog. This check box has the label: “Make diagnostic logfile during document creation and opening”. This check box can be ticked after selecting a document (or book/chapter during collaboration). This will cause Adapt It to log information about the source phrases/words being processed during document creation/opening. This check box is unticked by default, since the logging process takes longer for document creation/opening, but the logged information in the log file can be useful for debugging purposes, if Adapt It encounters a crash during document creation/opening. If you experience a program crash during document creation/opening, please tick that check box to create a log file, and send it as an email attachment to the Adapt It developers. Log files are stored in the _LOGS_EMAIL_REPORTS subfolder of the “Adapt It Unicode Work” folder. A similar check box used to be located on the View tab page of the Preferences dialog, but that Preferences page was difficult to access especially when collaborating with Paratext or Bibledit, so the check box was moved to the dialogs where documents/books are selected for creation/opening.
  • Email reporting of problem reports or feedback using the Help menu options now defaults to sending the email data to the users default email program. The secure SSL sending of problem reports/feedback is disabled in this version due to issues on the server.
  • Many improvements have been made to the parser of input source text; including changes for robust handling of USFM3.
  • The names of some of the command bar button icons have been shortened. Long names were a nuisance because not many buttons could be seen in the command bar if the names were unnecessarily long. Now more large-size buttons will fit.
  • Adapt It does a better job at handling ( or [ or { immediately following a word, provided the text following these is terminated by the matching ) or ] or }. This allows grammatical information to be typed into a target text as well as backtranslating the words and phrases.
  • In the View menu of Preferences, the default has whether or not to keep the phrase box midscreen has been changed to “don’t do so”. It defaults to keeping the strips stationary and the phrasebox moves down the page until it gets to the last line, and then the app scrolls the window down and repositions the phrasebox near the top. This setting makes adapting more pleasant, the strips don’t dance round as much, and it works better when the view is projected on a screen for several people to watch what is happening.

Bug Fixes in the 6.10.0 update

  • The source text parser within Adapt It had several changes made to remove misparsing errors in some complex USFM2 or USFM3 markup scenarios.
  • Fixed a rare coincidence where the document is being deleted at the instant an automatic save is requested by an internal timer. When this happened, the document was lost – unless a document backup was available. The problem now cannot happen.
  • Fixed infinite loop hanging of the Import Edited Source Text feature, when the document is short – less than 80 words long.
  • Fixed infinite loop hanging problem that could happen when certain punctuation characters ‘]’ and/or ‘)’ were used at the end of the phrasebox contents.

Windows and Macintosh version downloads are available at:

Linux version 6.10.0 Debian packages are available in i386 and amd64 architectures for Ubuntu Trusty, Xenial, Bionic, Eoan and Focal. There are instructions on how to configure your Linux system to gain access to the SIL repository at:

For Ubuntu Linux, basically you need to download and install the repository’s public key on your machine, and then set up your Software Sources with one of the following settings depending on your Linux distribution:

deb trusty main or
deb xenial main or
deb bionic main or
deb eoan main
deb focal main

The Ubuntu Eoan distribution only has short term support from Canonical. The Trusty, Xenial, Bionic, and Focal distributions are long term service (LTS) distributions which Canonical will support with bug and security fixes for 5 years from their initial release.

If you are using Wasta Linux (14.04, 16.04, 18.04, or 20.04) the software sources for installing and updating Linux software from the repository are already configured, so you can find the latest version of Adapt It in the Software Updater or the Synaptic Package Manager.

Important Note: Installing version 6.10.0 will automatically replace any previously installed Adapt It WX (Unicode) version from 4.0.0 through 6.9.4 (but existing project data is never touched when installing updates).

Adapt It WX is the open source, cross-platform version of Adapt It that is based on the wxWidgets framework (hence the WX in the name).

Please direct bug reports or feedback on the new version to the Adapt It team. On the Adapt It Help menu you can easily send a Problem Report or a Feedback Report directly from within Adapt It (over a secure connection) – see the Help menu. If you cannot use the Help menu’s email reporting functions, you can send a Problem Report or Feedback Report to the Adapt It team using the following email address:

Alternately, you can send an email to one or more of the following team members via their individual email addresses:

Bill Martin      – 
Bruce Waters     –
Erik Brommers    –
Graeme Costin    – (focus on MacOSX)
Kevin Bradford   –
Michael Hore     –
Bob Buss         – (focus on HTML Help system)
Jonathan Marsden –
Adapt It 6.10.0 Now Available