Add remaining, to be consolidated FAQs

content/support/faq/faq.general.001.md

@@ -0,0 +1,17 @@
+---
+title: "Taskwarrior - FAQ"
+topic: "General"
+question: "How do I contribute to documentation?"
+---
+
+Back to the [FAQ](/support/faq)
+
+### Q: How do I contribute to documentation?
+
+I would like to contribute a small change to the documentation.
+In general, how should I go about submitting patches to the documentation?
+I cannot find a Git repository containing the documentation.
+
+A: All our public repositories are listed here: https://github.com/GothenburgBitFactory
+
+Simply clone, modify, and create a pull-request.

content/support/faq/faq.general.002.md

@@ -0,0 +1,13 @@
+---
+title: "Taskwarrior - FAQ"
+topic: "General"
+question: "Are there any plans to create a package for <system>?"
+---
+
+Back to the [FAQ](/support/faq)
+
+### Q: Are there any plans to create a package for <system>?
+
+A: We don't do packaging, the community generally steps up.
+Contact your distro and make a request.
+

content/support/faq/faq.general.003.md

@@ -0,0 +1,18 @@
+---
+title: "Taskwarrior - FAQ"
+topic: "General"
+question: "What is the project's coding style?"
+---
+
+Q: Is there somewhere information about the coding style for the different programming languages used?
+
+A: Make all changes and additions such that they blend in perfectly with the surrounding code, so it looks like only one person worked on the source, and that person is rigidly consistent.
+
+That's the general guideline, but to be more explicit about it, here are some of the rules:
+
+* Use 2 spaces to indent, and no tabs
+* Surround operators, expression terms with a space
+* Stick to an 80 column maximum where possible, although exceptions for readability are fine, if limited
+* No cuddled braces
+
+https://github.com/GothenburgBitFactory/taskwarrior/blob/develop/doc/devel/contrib/coding_style.md

content/support/faq/faq.general.004.md

@@ -0,0 +1,16 @@
+---
+title: "Taskwarrior - FAQ"
+topic: "General"
+question: "Which principles build the foundation for task?"
+---
+
+Back to the [FAQ](/support/faq)
+
+Q: Which principles build the foundation for task?
+
+A:
+* Open source is the best way to write software
+* Open formats like JSON don't restrict users
+* Flexibility with lots of features yields strange and wonderful real-world use-cases
+* Scriptability is good
+* Performance is important

content/support/faq/faq.task.001.md

@@ -4,9 +4,11 @@ topic: "Taskwarrior"
 question: "How do I implement Pomodoro?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I implement Pomodoro?
 
-Taskwarrior currently doesn\'t support the pomodoro technique, not because it doesn\'t have all the necessary features, but because it has no way to notify the user if a given point in time has arrived.
-Remember: most of the time, Taskwarrior isn\'t running.
+Taskwarrior currently doesn't support the pomodoro technique, not because it doesn't have all the necessary features, but because it has no way to notify the user if a given point in time has arrived.
+Remember: most of the time, Taskwarrior isn't running.
 
-You can however use the pomodoro timer or any other timer software (KTeaTimer, Gnome\'s Tea Timer, Gnome\'s pomodoro shell extension, pyStopWatch, or any of the many timers out there), together with taskwarrior to manage and prioritize your ToDo list.
+You can however use the pomodoro timer or any other timer software (KTeaTimer, Gnome's Tea Timer, Gnome's pomodoro shell extension, pyStopWatch, or any of the many timers out there), together with Taskwarrior to manage and prioritize your ToDo list.

content/support/faq/faq.task.002.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I remove an attribute?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I remove an attribute?
 
 Modify the attribute and give it a blank value:
@@ -12,4 +14,4 @@ Modify the attribute and give it a blank value:
 $ task 16 modify due:
 ```
 
-Taskwarrior doesn\'t store blank values, so it deletes the attribute.
+Taskwarrior doesn't store blank values, so it deletes the attribute.

content/support/faq/faq.task.003.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I list tasks that have no project?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I list tasks that have no project?
 
 There are a few ways:

content/support/faq/faq.task.004.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I filter tasks containing words that are also commands?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I filter tasks containing words that are also commands?
 
 I have tasks with descriptions such as:

content/support/faq/faq.task.005.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I hide the change history when using the info report?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I hide the change history when using the `info` report?
 
 You need to turn off journaling, like this:

content/support/faq/faq.task.006.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I list tasks scheduled today?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I list tasks scheduled today?
 
 To filter tasks within a date range:

content/support/faq/faq.task.007.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I bring back a task that I completed or deleted by mistake?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I bring back a task that I completed or deleted by mistake?
 
 Simply changing the `status` of the task to `pending` is enough, Taskwarrior takes care of the rest:

content/support/faq/faq.task.008.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I improve output readability?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I improve output readability?
 
 You can use line breaks which allow blank lines between sort keys.

content/support/faq/faq.task.009.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I set the wait date to be 2 days before the due date?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I set the wait date to be 2 days before the due date?
 
 Taskwarrior can do date math, so use this:

content/support/faq/faq.task.010.md

@@ -4,16 +4,18 @@ topic: "Taskwarrior"
 question: "How do I create a traditional GTD Next Actions list?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I create a traditional GTD Next Actions list?
 
 I am looking to create a custom report that lists all pending tasks without a project and the single most urgent from each project.
 
 The report you describe is not possible as a single custom report because it combines multiple independent filters.
-It could be done as a series of separate reports (one for the project-less, one for each project), but that\'s not convenient.
+It could be done as a series of separate reports (one for the project-less, one for each project), but that's not convenient.
 
 What would be better is to instead write a script that automates all this, pulling together a list of task UUIDs and presenting one result report.
 Like this:
 
 <https://taskwarrior.org/download/gtdnext.sh>
 
-It\'s a bash script, and easily modifiable.
+It's a bash script, and easily modifiable.

content/support/faq/faq.task.011.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do you run a report listing recurring task templates?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 Q: List recurring task templates
 
 How do you run a report listing recurring task templates?

content/support/faq/faq.task.012.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "Why have attribute modifiers rather than the more readable and algebraic form?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: Why have attribute modifiers (`urgency.over:10`) rather than the more readable and algebraic form (`urgency>10`)?
 
 Taskwarrior already supports both forms.
@@ -41,4 +43,4 @@ noword            desc.noword:Hello  desc !~ '\bHello\b'  Boundaried word non-ma
 ...
 ```
 
-See \'man task\', for the `ATTRIBUTE MODIFIERS` and `EXPRESSIONS AND OPERATORS` sections.
+See 'man task', for the `ATTRIBUTE MODIFIERS` and `EXPRESSIONS AND OPERATORS` sections.

content/support/faq/faq.task.013.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I pipe a UUID into another task command?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I pipe a UUID into another task command?
 
 You can use Bash subprocess syntax to achieve this:

content/support/faq/faq.task.014.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I get the UUID of the last task added?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I get the UUID of the last task added?
 
 There is a `LATEST` virtual tag for just this.

content/support/faq/faq.task.015.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I change many due dates using one command?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I change many due dates using one command?
 
 Something come up yesterday and completely derailed my day.
@@ -16,4 +18,4 @@ This will change all overdue tasks to be due today:
 $ task +OVERDUE mod due:today
 ```
 
-Depending on whether you want all overdue tasks or not, you\'ll need to adjust the filter.
+Depending on whether you want all overdue tasks or not, you'll need to adjust the filter.

content/support/faq/faq.task.016.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I search for tasks?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I search for tasks?
 
 There are several ways to search the description and annotations of your tasks.

content/support/faq/faq.task.017.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I create a task that recurs on more than one day of the week?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I create a task that recurs on more than one day of the week?
 
 This is not supported, but you can simulate this by creating multiple tasks due weekly on different days:

content/support/faq/faq.task.018.md

@@ -4,10 +4,12 @@ topic: "Taskwarrior"
 question: "How can I include the time spent on a task in a custom report?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How can I include the time spent on a task in a custom report?
 
 Total active time is not a reportable field.
-It\'s not even a field, it\'s simply aggregated from the `undo.data` file.
+It's not even a field, it's simply aggregated from the `undo.data` file.
 As such it is a faithful account of how long a task was in the active state, but that is not what is needed for time tracking.
 
 Proper time tracking allows for corrections, and mining the `undo.data` file does not permit corrections.

content/support/faq/faq.task.019.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I hide tasks that have unfinished dependencies?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I hide tasks that have unfinished dependencies?
 
 Try

content/support/faq/faq.task.020.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I record a task that is already completed?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I record a task that is already completed?
 
 There are several ways to do this.

content/support/faq/faq.task.021.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I include the recurrence frequency in a report?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I include the recurrence frequency in a report?
 
 Try this command:

content/support/faq/faq.task.022.md

@@ -4,7 +4,9 @@ topic: "Taskwarrior"
 question: "How do I solve \"Taskwarrior was built without GnuTLS support. Sync is not available.\"?"
 ---
 
-### Q: How do I solve \"Taskwarrior was built without GnuTLS support. Sync is not available.\"?
+Back to the [FAQ](/support/faq)
+
+### Q: How do I solve "Taskwarrior was built without GnuTLS support. Sync is not available."?
 
 Install `libgnutls-dev` and rebuild:
 

content/support/faq/faq.task.023.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I get color working?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I get color working?
 
 Try the command:

content/support/faq/faq.task.024.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do I fix this 'libgnutls-deb0.so.28' error?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 ### Q: How do I fix this `libgnutls-deb0.so.28` error?
 
 Upon upgrading from Ubuntu 15.10 to 16.04 I am now seeing the following error message when I try to run Taskwarrior:
@@ -13,7 +15,7 @@ error while loading shared libraries: libgnutls-deb0.so.28: cannot open shared o
 ```
 
 Gnutls was already installed and had been working on my 15.10 installation for some time now.
-I attempted to fix it by uninstalling and reinstalling gnutls, but it still doesn\'t work.
+I attempted to fix it by uninstalling and reinstalling gnutls, but it still doesn't work.
 
 Your Taskwarrior was built using a version of GnuTLS that is no longer installed.
 If you built Taskwarrior from source, then rebuild.

content/support/faq/faq.task.025.md

@@ -4,6 +4,8 @@ topic: "Taskwarrior"
 question: "How do you delete a recurring task?"
 ---
 
+Back to the [FAQ](/support/faq)
+
 Q: Delete a recurring task template
 
 How do you delete a recurring task?

content/support/faq/faq.task.026.md

@@ -0,0 +1,23 @@
+---
+title: "Taskwarrior - FAQ"
+topic: "Taskwarrior"
+question: "How can I filter only pending tasks?"
+---
+
+Back to the [FAQ](/support/faq)
+
+### Q: Filter only pending tasks
+
+I thought about using a virtual tag, but there is nothing like `+PENDING`.
+
+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.
+
+A: A `+PENDING` virtual tag is a good idea. It would make a nice feature request.
+
+A: Please try
+
+```
+task status:pending all
+```
+
+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.task.027.md

@@ -0,0 +1,15 @@
+---
+title: "Taskwarrior - FAQ"
+topic: "Taskwarrior"
+question: "How can I filter by project for the timesheet command?"
+---
+
+Back to the [FAQ](/support/faq)
+
+### Q: How can I filter by project for the timesheet command?
+
+As far as I can tell, `task timesheet` has no way to filter which projects are reported on.
+The obvious `task proj: projname timesheet` doesn't work.
+
+A: Sorry, the timesheet command does not support filters, and I think it should.
+This would make a good feature request.