5.0.0: Split long query lines; inline comments; detect unexpanded template text

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

⚠️ Important The meaning of a final backslash (\) at the end of a line in a Tasks code block has changed.

If your vault has any lines in Task blocks that end in \ please make the following kind of change:

Old instruction	Use this instruction instead
description includes something\	description includes something\\

---

Main changes

Here are the most notable user-visible changes.

🎉 Long query lines can now be split with backslashes by @sbliven in #2330

• See page Line Continuations
• Here is a before-and-after example image from the documentation (which now uses syntax-highlighting in some examples, for readability):
  
  

🎉 Publicise inline comments mechanism by @sbliven in #2330

• This has been enabled by the recent Placeholders mechanism
• See section Inline Comments.

🎉 Prevent misleading date searches with template text by @claremacrae in #2331

• All the built-in date searches now refuse to run if they detect any unexpanded template text in the filter.
• This resolves a notable source of confusion seen in Support queries.
• See section Troubleshooting Daily Agenda queries.

💪 Fixes

• Edit Task modal warns if no date set for recurrence by @DanielTMolloy919 in #2316

  • See section Recurring tasks must have at least one date
    
    

• Double backslashes in line continuations no longer require next line to be blank by @claremacrae in 82c1abb

---

📖 Documentation

📖 New pages:

• Getting Started/Statuses:
  • Recurring Tasks and Custom Statuses
• Queries:
  • Line Continuations
• Support and Help:
  • Known Limitations
  • Breaking Changes

📖 New sections:

• Comments:
  • Inline Comments
• Recurring Tasks:
  • Recurring tasks must have at least one date
  • Recurrence rule lost if highest priority date is invalid
• Tasks Emoji Format:
  • Limitations of Tasks Emoji Format

The changes...

• Add new page 'Known Limitations' by @claremacrae in #2325
• Remove duplicate "path includes" in current file How To by @lukefernandez in #2327
• Wrap long lines in custom filter and group samples by @claremacrae in #2338
• Add new help page 'Breaking Changes' by @claremacrae in #2339
• Advertise line continuation characters in docs by @claremacrae in #2346
• Finish Line Continuation and Inline Comments docs by @claremacrae in #2347
• Colour the code in custom filter & group samples by @claremacrae in #2348
• Add Recurring Tasks's 'Known Issues' to 'Known Limitations by @claremacrae in #2350
• Mermaid status diagrams now machine-generated by @claremacrae in #2351
• Add page 'Recurring Tasks and Custom Statuses' by @claremacrae in #2352
• Major enhancements to 'Recurring Tasks' docs by @claremacrae in #2359
• Refine the wording of the warning in Edit Task modal by @claremacrae in #2360

---

🛠️ Behind the scenes

• test: Prevent IDEs from stripping spaces from test by @claremacrae in #2336
• refactor: Divide up regex in line continuation code by @claremacrae in #2337

---

New Contributors

• @DanielTMolloy919 made their first contribution in #2316
• @lukefernandez made their first contribution in #2327
• @sbliven made their first contribution in #2330

ℹ️ Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 4.9.0...5.0.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae