From 3948484cf56b6ac311be048f5132fae5090f5ecb Mon Sep 17 00:00:00 2001
From: Scott Mcdermott <scott@smemsh.net>
Date: Sat, 17 Jul 2021 17:28:16 -0700
Subject: [PATCH] docs: Document TW #2536

---
 ChangeLog         |  3 +++
 NEWS              |  5 +++++
 doc/man/task.1.in | 21 +++++++++++++++++++++
 3 files changed, 29 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 5a2268a4f..b3f2aa8c0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -72,6 +72,9 @@
            Thanks to Pablo Vizcay.
 - TW #2530 Taskwarrior 2.5.3 time based filtering regression
            Thanks to Matthias Tafelmeier.
+- TW #2536 Feature: inclusive range-end attribute modifier 'by' so 'end of'
+           named dates can be filtered inclusively
+           Thanks to Scott Mcdermott
 
 ------ current release ---------------------------
 
diff --git a/NEWS b/NEWS
index 1c5c4e817..da984106b 100644
--- a/NEWS
+++ b/NEWS
@@ -22,6 +22,11 @@ New Features in Taskwarrior 2.6.0
     functionality.
   - The `task import` command can now accept annotations with missing entry
     values. Current time will be assumed.
+  - The new 'by' filter attribute modifier compares using '<=' rather than '<'
+    as 'before' uses.  This allows the last second of the day to match with
+    'due.by:eod', which it would not otherwise.  It also works with
+    whole units like days, e.g. 'add test due:2021-07-17' would not match
+    'due.before:tomorrow' (on the 16th), but would match 'due.by:tomorrow'.
 
 
 New Commands in Taskwarrior 2.6.0
diff --git a/doc/man/task.1.in b/doc/man/task.1.in
index dbdb41102..90e92cfce 100644
--- a/doc/man/task.1.in
+++ b/doc/man/task.1.in
@@ -55,6 +55,7 @@ More filter examples:
   task                                      <command> <mods>
   task 28                                   <command> <mods>
   task +weekend                             <command> <mods>
+  task +bills due.by:eom                    <command> <mods>
   task project:Home due.before:today        <command> <mods>
   task ebeeab00-ccf8-464b-8b58-f7f2d606edfb <command> <mods>
 
@@ -819,6 +820,8 @@ Attribute modifiers improve filters.  Supported modifiers are:
 .br
 .B  after      (synonyms over, above)
 .br
+.B  by
+.br
 .B  none
 .br
 .B  any
@@ -866,6 +869,24 @@ modifier is the inverse of the
 .I before
 modifier.
 
+The
+.I by
+modifier is the same as 'before', except it also includes the moment in
+question.  For example:
+
+    task add test due:eoy
+
+will be found when using the inclusive filter 'by':
+
+    task due.by:eoy
+
+but not when the non-inclusive filter 'before' is used:
+
+    task due.before:eoy
+
+this applies equally to other named dates such as 'eom', 'eod', etc; the
+modifier compares using '<=' rather than '<' like 'before' does.
+
 The
 .I none
 modifier requires that the attribute does not have a value.  For example: