Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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  accept-
     able 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 exten-
     sion 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 infor-
     mation.

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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vitrc&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help