VimTeX 2.12

Another release, another set of updates. Some bug fixes, some improvements to the documentation, and some minor improvements and enhancements. This time, I think the main thing to highlight may be the improved main-file detection (core feature, most people will probably not notice it), as well as some improvements to the cache feature.

Features

• Compiler
  • Improve compileability checker (#2471)
• Completion
  • Support completion for \PassOptionsToClass (#2521)
  • Label completion for \nameref (#2208, #2593)
  • Add "info" item for citation completion (#2606)
• Syntax
  • Support for fixme package (#2494)
  • Support for optidef package (#2495)
  • Support for fontawesome5 package (#2506, #2528, #2530, #2580)
  • Better conceals for spacing cmds (#2594)
  • Support mathtools' \shortintertext (#2586)
• ToC features
  • Support for fixme package (#2497)
  • Adjust ToC help text (#2520)
  • Match %TODO without space (#2546)
• Editing
  • Add maps to surround with environment (#2489)
  • Allow to customize fraction toggle map (#2402)
• Miscellaneous
  • Improve main-file detection (#2557, #2483, #2471, #2558)
  • Allow colon for tex root specifier (#2471)
  • Doc support (K mapping) for usetikzlibrary (#2480)
  • \includeonly in g:vimtex_include_indicators (#2519)
  • Use hardcoded defaults for &shell settings (#2554)
    • This seems necessary to make things work on e.g. MSYS2 on Windows.
  • Option to avoid confirmation for VimtexDocPackage (#2567)
  • Avoid xdotool unless we already use xwin_id (#2569)
  • Improve calculation of current win width for environment folds (#2551)
  • Improve cache backend

Bug Fixes

• Compiler
  • Run custom callbacks in Vim also when continuous mode is off
  • :VimtexCompileSelected should respect build_dir (#2522)
• Syntax
  • Subscript delta does not exist (#2485)
  • Swap defaults for VimtexError and VimtexFatal (#2552)
• Miscellaneous
  • Avoid special utf-8 char for fzf delimiter (#2486)
  • Error in toggle_math (#2488)
  • Minor bug in chktex compiler (#2549)
  • Add &shell reset for neovim's jobstart (#2554)
  • Recognize files with .latex extension (#2571)
  • s:get_main_choose should return full path (#2595)
  • Remove redundant highlight link (#2608)
  • Fix wrong .github/workflows/assets.yml (#2531)

Documentation

• Several adjustments and minor improvements (e.g. #2515, #2537, #2541, #2542)
• Improve main-file detection docs (#2557, #2559)
  • Change wording: "recursive search" to "directory scan" (#2559)
• Improve docs for tex root directive (#2556)
• More discoverable g:vimtex_callback_progpath (#2475)
• Update Yalafi URLs (#1714)
• Update TeXlab url (#2548)
• Mention bibtex-tidy (#2487)
• Make links to GIFs slightly easier to find (#2362, #2492)
• Added short doc for vimtex#env#is_inside (#2501)
• Improve introduction to :help vimtex-completion
• Improve docs for generic compiler interface (#2021)
• Some simplification of latexmk docs (#2523, #2603)
• Fix typo in pdf_mode reference (#2540)
• Mention semantic linebreaker in docs (#2544)
• More consistent path references (#2539)
• Be verbose about what "fold enabled" means (#2547)
• Add note on discouraged lazy loading of VimTeX (#2560)
• Clarify styling for custom cmds (#2574)
• Add FAQ section on SumatraPDF in WSL (#2566)
• Describe how text objects depend on syntax highlighting (#2583)
• Link to new Zathura-macOS recipe for Apple Silicon (#2604, #2605)
• Improve docs on Sioyek on Windows WSL (#2477)
• Expand :help vimtex-faq-treesitter (#2484, #2469)

Acknowledgements

Again there has been several contributions from the community, and as before I would like to give a special thanks to everyone who contributes with PRs: @Freed-Wu (#2528, #2530, #2531), @ejmastnak (#2492, #2605), @JingMatrix (#2411), @aryabhatta-dey (#2469, #2484), @huweiATgithub (#2495), @krishnakumarg1984 (#2515, #2537, #2542, #2548), @PatrBal (#2551), @fauust (#2556), @shuber2 (#2559, #2560), @senesc (#2586), and @tomtomjhj (#2608).