taskwarrior

mirror of https://github.com/GothenburgBitFactory/taskwarrior.git synced 2025-06-26 10:54:26 +02:00

History

Paul Beckingham 743baf00cf TW-311: Estimated completion in burndown.daily shows impossible results - Thanks to Michele Santullo. - Although TW-311 references impossible results, there are two problems. First there is the algorithm that determines estimateѕ completion, and second there is the reference to wait dates. The algorithm has been replaced by something better, but wait dates have nothing to do with estimation. - The 'burndown.bias' configuration setting is removed. - The estimated completion is based on the net completion rate since the high water mark of total pending tasks, measured on a daily basis, regardless of the type of chart produced. - Vim syntax updated. - Docs updated.		2015-11-07 15:35:21 -05:00
..
ftdetect	Updated copyright to 2015	2015-01-01 00:00:41 -05:00
syntax	TW-311: Estimated completion in burndown.daily shows impossible results	2015-11-07 15:35:21 -05:00
README	Updated copyright to 2015	2015-01-01 00:00:41 -05:00

README

          Configure VIM for Syntax Highlighting of Taskwarrior Data


The task data files (pending.data, completed.data and undo.data),
configuration file (.taskrc) as well as edits made via commands like "task 1
edit" can be color-highlighted if you happen to use VIM as your preferred text
editor.  Eventually this will happen automatically in newer versions of VIM,
but for now you have to do a little bit of file shuffling.


                                Prerequisites

For this to work, you need to first have syntax highlighting enabled when you
use VIM.  This happens to be the default for most VIM installations, but it is
usually quite simple if that doesn't happen to be so in your case.  Rather
than repeat the excellent VIM documentation here, please see the appropriate
VIM documentation itself.  Generally this can be made seen by starting
vim/gvim and issuing the following command:

    :help syntax

You may prefer instead to read the help online at:
    http://vimdoc.sourceforge.net/htmldoc/syntax.html#syntax


              Configuring VIM to Understand Taskwarrior Data

Once you have VIM's syntax highlighting enabled and working with other file
types properly, configuring it for use with taskwarrior is simple.  You simply
need to copy some files that came with taskwarrior into your home directory so
that you have:

    ~/.vim/ftdetect/task.vim
    ~/.vim/syntax/taskdata.vim
    ~/.vim/syntax/taskedit.vim
    ~/.vim/syntax/taskrc.vim

The source of these files varies depending on how you installed task.  If you
installed task via a regular package (rpm or deb) you can find these files in
/usr/share/doc/task-VERSION/scripts/vim/.  If you built task yourself from the
tarball (using the default configure options), these will be in
/usr/local/share/doc/task-VERSION/scripts/vim/ instead.  So you should be able
to do one of the following:

    cp -av /usr/share/doc/task-VERSION/scripts/vim/* ~/.vim/

or

    cp -av /usr/local/share/doc/task-VERSION/scripts/vim/* ~/.vim/

You should then be ready to go.
---
All four above mentioned files are

Copyright 2009 - 2015 John Florian

and are available under the MIT license.
For the full text of this license, see COPYING.