Adapt It version 6.10.1 update

(This article was originally published in May 2020)

Feature changes and new features in 6.10.1

  • Improved the display pile spacing when inserting a placeholder using one of the two Insert Placeholder tool bar buttons. Previously inserting a placeholder pile sometimes did not widen the pile sufficiently for a longer multi-word translation text under that source “…” placeholder. This could result in a temporary overwriting of part of the longer translation text by the following pile in the display.
  • When moving the phrasebox by Enter/Tab key press, the phrasebox would stop at a previously inserted placeholder location thinking the placeholder was a ‘hole’. This was unhelpful as it would also remove the previously entered translation text under that placeholder. This behavior has been changed in 6.10.1 so that adapted placeholders are no longer considered ‘holes’ or stopping points.
  • A long-time user with a very large knowledge base reported that the program had slowed down so much that it became almost unusable. Investigation showed that the problem was due to the Guesser function getting bogged down. To solve this problem, we’ve made the Guesser default to being OFF (previously it defaulted to being ON). To avoid the slow-down in the future, the Guesser now defaults to being OFF for each new session of Adapt It and after a project is closed or the application shut down. If a user wants to use the Guesser it must now be turned ON for each working session of Adapt It.
  • The Find and Find-and-Replace dialogs now inform the user when the end of the document is reached, and give the user the option of continuing those functions in an earlier part of a document, if they were initiated in a later part of the document.
  • [Carried over from the previous limited distribution version 6.10.0]. This version also should be fully compatible with all current versions of Paratext including Paratext 9 when Adapt It and Paratext are set up to collaborate together. See the HTML file Help_for_Administrators.htm from the Administrator menu, or from the Adapt It website at: for more information and details.
  • [Carried over from the limited version 6.10.0]. 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.
  • [Carried over from the limited version 6.10.0] this version is also compliant with the USFM 3.0 new attribute marker features. Additionally the app does not show metadata with attributes in the GUI, but auto-restores 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).
  • [Carried over from the limited version 6.10.0] email reporting of problem reports or feedback using the Help menu options now default to transferring the email data to the users default email program on the user’s computer. The secure SSL sending of problem reports/feedback is disabled in this version due to issues on the server.
  • [Carried over from the limited version 6.10.0] 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.
  • [Carried over from the limited version 6.10.0] Many improvements have been made to the parser of input source text; including changes for robust handling of USFM3.
  • [Carried over from version 6.10.0] 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.
  • [Carried over from version 6.10.0] Adapt It does a better job at handling the ( or [ or { characters immediately following a word, provided the text following these is terminated by the matching ) or ] or }. This allows for grammatical information to be typed into a target text as well as when backtranslating words and phrases.
  • [Carried over from version 6.10.0] In the View menu of Preferences, the default setting of whether or not to keep the phrase box mid-screen 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.1 update

  • For those who customarily use the Tab key to move the focus around to various controls within dialogs and other input areas of the program, and then use the Enter key to select a button such as OK or Cancel, they have reported that the phrase box would suddenly advance forward to the next ‘hole’ in the document which might be a long way down in a document that was previously mostly adapted. That unhelpful behavior of a run-on phrasebox, should now be fixed when a user dismisses a message box or a dialog by use of the Enter key.
  • A potential crash was fixed in situations where a merger was at the end of a document, and the Edit Source Text dialog was used to add additional text to the end of the document. The crash would happen when ending the vertical edit session. This has been fixed.
  • [Carried over from version 6.10.0] The source text parser within Adapt It had several changes made to remove misparsing errors in some complex USFM2 or USFM3 markup scenarios.
  • [Carried over from version 6.10.0] 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.
  • [Carried over from version 6.10.0] Fixed infinite loop hanging of the Import Edited Source Text feature, when the document is short – less than 80 words long.
  • [Carried over from version 6.10.0] 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.1 Debian packages are available in i386 and amd64 architectures for Ubuntu Trusty, Xenial, Bionic, and Eoan. Ubuntu Focal and later are only available in the amd64 architecture. 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
deb xenial main
deb bionic main
deb eoan main

deb focal main

Note: 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.1 will automatically replace any previously installed Adapt It WX (Unicode) version from 4.0.0 through 6.10.1 (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 prepare a Problem Report or a Feedback Report and transfer it to your default email client from within Adapt It (where you can send it to us) – see the Help menu. Using the Help menu form will help you to make a better report. 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:


Adapt It version 6.10.1 now available