Skip to content
Richard Stein edited this page Mar 10, 2020 · 1 revision

LaTeXTools version 4

In the motivation to allow incompatibles changes, cleanup old resources, and add new features we started the development of a new version a while ago. See #1101 for the discussion about it.

Incompatible changes

A major version update is the best opportunity for incompatible changes. In this regard changed a few things, which may collide with other packages. These changes will have no impact if you didn't customize the corresponding fields and hopefully only a small migration impact if you did.

Dropping support for Sublime Text 2

With the release of Sublime Text 3 and the start of the development of Sublime Text 4, we are removing the code base for the compatibility with Sublime Text 2 and older Sublime Text 3 versions. It is still possible to install a fixed older version of LaTeXTools there.

Renaming of commands

In the development of LaTeXTools the commands have been named by the individual developers and no common naming schema has been established. To avoid potential naming collusions with other plugins the names are prefixed with latextools_. If you defined your own commands or keybindings you may need to adapt them.

How to migrate the commands?

We developed a command to migrate the LaTeXTools keybindings, you may also use for your keybindings. If you execute an deprecated keybinding, you will get a warning box, which allows you to temporary enable the old keybindings for the current session. If you see that box please, you may check your keybindings to migrate them the following way:

  1. The following steps only works if you have PackageDev installed, because the command visibility is limited to specific syntaxes
  2. Open your keybindings Preferences > Key Bindings
  3. (Recommended) Backup/Copy the keybindings to a different file
  4. Press C-shift-p to open the command palette
  5. Execute the LaTeXTools: Find deprecated commands instruction
  6. A popup will appear for each outdated command and replace the name, check and execute the replacement

Prefix of view and project settings

Similar to the commands, we also enforced a prefix of the shared settings, which are the view and project settings. If you have defined a settings on the project level you will need to prefix the settings with latextools.. This also included the TEXroot setting, please see TODO.

New features

  • TODO