DragonFly On-Line Manual Pages

Search: Section:  

vitrc(5)                         User Manuals                         vitrc(5)


NAME

       vitrc - Configuration file for the vit(1) command


SYNOPSIS

       $HOME/.vitrc


DESCRIPTION

       VIT obtains its configuration data from a file called .vitrc . This
       file must be located in the user's home directory.

       Except for comments (lines starting with "#"), currently the only
       acceptable commands in .vitrc are map commands. They take the form

              map <KEY>=<KEY-SEQUENCE>

       where:

              <KEY>  should represent a key or combination of keys, such as
                     "a" or a <KEY-CODE> as listed below.

              and

              <KEY-SEQUENCE> is a sequence of <KEY>s to emulate. The result
              should be the same as if these keys were pressed manually by the
              user.

              <KEY-CODE>s are strings that represent keys. The following may
              be used:
              Function keys: <F1> <F2> <F3> <F4> <F5> <F6> <F7> <F8> <F9>
              <F10> <F11> <F12>

              Navigation keys: <Home> <End> <PageUp> <PageDown> <Up> <Down>
              <Right> <Left>

              Editing keys: <Insert> <Del> <Backspace> <Space> <Tab> <Return>

              Modifier combinations: \ca for Ctrl + "a" combination.


EXAMPLES

   EXTERNAL COMMANDS
       Note that for many of the examples, you need to have the appropriate
       extension installed and in your PATH. Recall that after :! a 'w' means
       that VIT should "wait". This allows another command to take over (e.g.
       Vim when you're editing a task) and for you to see the output of a
       command. After :! a 'r' means that VIT should reread your list of
       tasks. This should be used when your external command changes the task
       data.

       map \cn=:!wr tasknote %TASKID<Return>
              When Ctrl + n is pressed, runs the command 'tasknote <ID>',
              where <ID> is the ID of the task that is currently selected in
              VIT.

       map c=:! task %TASKID rc.defaultwidth:200 | grep -o -P -m 1
       (ftp|http)s?:// | tr -d '0 | xsel -b<Return>
              Copies the first link it finds to the clipboard.

       map Z=:!rw echo Changing due date0; task %TASKID modify due:$(read -p
       How many days?  DAYS; echo $DAYS)days<Return>
              Asks you for input and then changes the due date of the selected
              task to NOW plus that many days.

       map <Left>=:!wr task $(task _get %TASKID.parent) edit<Return>
              When the left arrow key is pressed, edits the parent of a
              recurring task (do not use on non-recurring task).

   INTERNAL COMMANDS
       map Q= Disables whatever the Q key is bound to internally in VIT, which
              is a quick quit.

CREDITS & COPYRIGHTS
       Copyright (C) 2012 - 2013, Steve Rader
       Copyright (C) 2013 - 2014, Scott Kostyshak

       VIT is distributed under GNU General Public License version 3 or (at
       your option) any later version. See http://www.gnu.org/licenses/ for
       more information.


SEE ALSO

       vit(1) taskrc(1)

       For more information regarding VIT, see the following:

       The official site at
              <http://tasktools.org/projects/vit.html>

       The official code repository at
              <git://tasktools.org/vit.git/>

       You can contact the project by emailing
              <support@taskwarrior.org>


REPORTING BUGS

       Bugs in VIT may be reported to the issue-tracker at
              <http://taskwarrior.org>

                                                                      vitrc(5)

Search: Section: