Skip to content

Commit f8a87c0

Browse files
committed
Add remaining, to be consolidated FAQs
1 parent 17954f8 commit f8a87c0

File tree

193 files changed

+4754
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

193 files changed

+4754
-0
lines changed

content/support/faq/faq.101.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: Filter only pending tasks
6+
7+
I thought about using a virtual tag, but there is nothing like `+PENDING`.
8+
9+
I have lots of recurring tasks that I want to delete in batch, but `task <taskname>` returns the completed ones, too and I don’t want to delete these.
10+
11+
A: A `+PENDING` virtual tag is a good idea. It would make a nice feature request.
12+
13+
A: Please try
14+
15+
```
16+
task status:pending all
17+
```
18+
19+
A: It is worth noting that most reports already have a filter that already includes `status:pending`, but the `all` report used here as an example has no filter, which makes it useful as an example like this.

content/support/faq/faq.102.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
### Q: How can I filter by project for the timesheet command?
6+
7+
As far as I can tell, `task timesheet` has no way to filter which projects are reported on.
8+
The obvious `task proj: projname timesheet` doesn't work.
9+
10+
A: Sorry, the timesheet command does not support filters, and I think it should.
11+
This would make a good feature request.

content/support/faq/faq.103.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: Why are virtual tags better than direct attribute comparisons?
6+
7+
(Great question copied from support email)
8+
9+
For example, why should I do this:
10+
11+
$ task +WEEK list
12+
Instead of:
13+
14+
$ task due.after:sow and due.before:eow list
15+
It's shorter, but is it better?
16+
17+
A: It's better because it is fewer character to type, and therefore less prone to error.
18+
But it is identical.

content/support/faq/faq.104.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How does `task log Do something` affect done/delete ratio?
6+
7+
A: "task log Did something" would create the task and mark it completed in one step.
8+
9+
It would affect your done/deleted ratio by adding one to the "done" (completed) pile.

content/support/faq/faq.105.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How can I find the parent of a recurring task if no child is left?
6+
7+
A: I think he means to find the recurring task if there are not any children with status pending.
8+
9+
A: You can use the following to list all the parents:
10+
11+
task all status:recurring
12+
You can add more search terms as usual. For example, to find the recurring task to change your brita water filter:
13+
14+
task all status:recurring brita

content/support/faq/faq.106.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How can I denotate all annotations at once?
6+
Neither
7+
```
8+
task denotate "*" 123
9+
```
10+
nor
11+
```
12+
task denotate * 123
13+
```
14+
work for the task with id 123.
15+
16+
A: There is currently to way to remove annotations in bulk other than using:
17+
18+
```
19+
task <taskid> edit
20+
```
21+
and removing all the annotation lines.
22+
23+
You could also write a helper script to remove all annotations.
24+
Using the export command will make it easier to parse.

content/support/faq/faq.107.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How can I track my 'not to be done' list?
6+
7+
A: As far as I know taskwarrior has no status that represents "not to be done".
8+
In practice most people simply delete tasks that are no longer valid.
9+
10+
Still, you can use existing functionality to provide such feature.
11+
12+
One possibility is to set the task waiting till the end of days:
13+
14+
```
15+
task add wait:someday Buy a private spaceship
16+
```
17+
18+
Technically this would be waiting until 1/18/2038, but you get the idea.
19+
20+
An alternative would be to create a project that holds all your "not to be done" tasks and that is never displayed in your default reports:
21+
22+
```
23+
task add proj:wontdo "Do yesterday's dinner"
24+
```
25+
26+
and then simply add:
27+
28+
```
29+
default.command=next proj.not:wontdo
30+
```
31+
32+
to your .taskrc file, or any variation using your preferred report.
33+
34+
Then when you want to see these tasks, a simple:
35+
36+
```
37+
task all proj:wontdo
38+
```
39+
40+
will do.
41+
42+
Another possibility is to create a TAG and explicitly filter based on presence or absence of said TAG:
43+
44+
```
45+
task add +wontdo "Travel back in time to tell myself I was wrong"
46+
```
47+
48+
and apply the same principle to the default command in .taskrc:
49+
50+
```
51+
default.command=next -wontdo
52+
```
53+
54+
Given all these possibilities, choose the one that you find easier to use and best suits you.
55+
56+
PS: There may be better ways to specify default options.
57+
I need to dig into that subject myself.

content/support/faq/faq.108.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How can I assign a task to a project while creating the task?
6+
For instance I recently did :
7+
8+
```
9+
$ task project:todaysproject add pick up laundry
10+
```
11+
12+
however when I list all tasks it shows that the task is not assigned to a project.
13+
14+
A: The "project:todaysproject", when it appears before the "add" command is ignored.
15+
Try putting the command first:
16+
17+
```
18+
$ task add project:todaysproject pick up laundry
19+
```

content/support/faq/faq.109.md

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How do I remove duplicate UUIDs?
6+
7+
If the command:
8+
9+
```
10+
$ task diag
11+
...
12+
```
13+
14+
states that there are duplicate UUIDs, how do I remove them?
15+
16+
A: As far as I know there is no automated way to deal with duplicate UUIDs.
17+
18+
What follows is what I would do (did) in this situation.
19+
20+
The first thing you should do if task diag identifies one or more tasks with the same UUID is to list those tasks by using the UUID.
21+
If your UUID was 42687c6e-a5c5-45be-a6f5-5c26006abf24 then do:
22+
23+
```
24+
task 42687c6e-a5c5-45be-a6f5-5c26006abf24 info
25+
```
26+
27+
If they are identical it's likely that they got corrupted.
28+
In this situation the only thing left to do is to "get rid" of the duplicates until there is none that is identical.
29+
Read on how to fix them below.
30+
31+
If the matching tasks are different, it's possible that they are still salvageable by assigning a new UUID that is not yet used.
32+
33+
Fixing duplicates:
34+
35+
Because taskwarrior uses UUIDs internally to match tasks, you won't be able to edit one task without affecting the other with same UUID.
36+
In fact the first task found with given UUID will receive all changes.
37+
38+
In general editing your .data files by hand is not recommended.
39+
This is probably the one and only exception.
40+
41+
With that said, make a backup of all the files in your $HOME/.task folder.
42+
Then open all your .data files in a text editor (gedit, vim, emacs... not openoffice or such), search for the UUID using the editor's find function.
43+
44+
In the case that the tasks are identical, simply remove one of them by deleting the whole line, until there are no more duplicates.
45+
Save and run task diag again for confirmation.
46+
47+
If on the other hand tasks are different, first find a UUID that is not taken.
48+
Start by incrementing or decrementing the rightmost number.
49+
Then confirm that no such UUID exists by running:
50+
51+
```
52+
task NEW-UUID all
53+
```
54+
55+
Once you are positive, change the UUID of one of the duplicate tasks by replacing it with the NEW-UUID.
56+
57+
Repeat until no more duplicates exist.
58+
59+
Wrapping up
60+
61+
Now, if these duplicates have already been synced, you will also need to correct the database on taskd as well as on other clients.
62+
63+
Taskd should have mechanisms in place to prevent creating tasks with duplicate UUIDs.
64+
This information requires confirmation.
65+
66+
As far as I know the duplicate UUID problem cannot be solved by manually crafting entries in the backlog.data file.
67+
68+
I never had to go this far, but I can only envision a road with a lot of pain!

content/support/faq/faq.110.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: "Taskwarrior - FAQ"
3+
---
4+
5+
Q: How to set 'wait' until one day before 'due'?
6+
Construction:
7+
8+
```
9+
task 1 modify wait:due-1days
10+
```
11+
12+
unfortunately doesn't work.
13+
14+
A: Currently date expressions are not supported.
15+
This means instead of:
16+
17+
```
18+
wait:due-1days
19+
```
20+
21+
You have to calculate 'due-1days' yourself.
22+
23+
Beginning with taskwarrior 2.4.0, date expressions will be supported, and exactly what you described will just work.
24+
Additionally, algebraic expressions will be supported in several places.
25+
Here is an example from the dev branch, using the new 'calc' command:
26+
27+
```
28+
$ task calc 20140430 - 1days
29+
2014-04-29T00:00:00
30+
```

0 commit comments

Comments
 (0)