Correct out-of-date passages in the man pages - #4200
Merged
djmitche merged 3 commits intoSep 25, 2026
Merged
Conversation
Document the exit status of _get for invalid references and missing values, describe sow/som/soq/soy as the start of the current period, and update the 'or' example now that the command line filter is parenthesized before it is combined with the report filter. Add an example of where parentheses are still needed. Closes #4196
They appear in the man page and the zsh and fish completions, but Taskwarrior no longer recognizes them. 'sow' and 'eow' already cover the current week, so remove them rather than add a third notion of week. Also state which day each remaining week-relative date falls on. Closes #3628
The entry only said that it sets the day a week starts, which suggests that sow, eow and the WEEK virtual tag follow it. They don't: they always use a Monday to Sunday week. weekstart only changes the calendar layout, week numbers and the meaning of week dates.
djmitche
approved these changes
Sep 25, 2026
djmitche
left a comment
Member
There was a problem hiding this comment.
Thanks for these fixes!
I want to clarify for those following along that these represent changes that have occurred sometime in the last ~5 years, and for which documentation wasn't properly updated. 3.0.0 was released during that 5-year period, but these changes weren't specifically associated with that release.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Several passages in task(1) and taskrc(5) no longer match what Taskwarrior 3.5.0 does.
_getexits with 2 for an invalid DOM reference. A missing value prints nothing and exits with 0; the page said both exit with 1.sow,som,soqandsoyare the start of the current period, not the next one.orexample said the command line filter needs parentheses to combine correctly with the report filter. Taskwarrior now adds them itself. The section now explains that, and gives an example where parentheses are still needed, when mixingandandor.socwandeocwwere never recognised in 3.x, but they were still in the man page and the zsh and fish completions. I removed them, as discussed in 2.6.X: 'eocw' and 'socw' are invalid #3628, and the week headings now say which day each date falls on.soww/eowwrefer to the next work week when used on a Sunday.weekstartonly changes the calendar layout, week numbers and week dates such as2026-W02. The taskrc(5) entry now says that it does not affectsow,eowor theWEEKvirtual tag.I checked each change against the source and the 3.5.0 binary with an empty database.
The
_getchange documents current behaviour. #4196 left open whether a missing value exiting with 0 is intended. If it's a bug, this paragraph should change with the fix.The website's DOM page had the same
tag.<name>problem reported in #4196, and it's fixed separately in GothenburgBitFactory/tw.org#1465.Closes #4196
Closes #3628