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

FreeBSD Manual Pages

  
 
  

home | help 
TIMEW-CONFIG(7)			 User Manuals		       TIMEW-CONFIG(7)

NAME
       timew-config - Timewarrior configuration	file and override options

SYNOPSIS
       timew rc.<name>=<value> <command>

DESCRIPTION
       Timewarrior stores its configuration in the user's home directory in
       ~/.timewarrior/timewarrior.cfg on non-Unix systems (e.g.	Windows).

       On Unix systems,	XDG Base Directory specification is supported, if
       ~/.timewarrior directory	doesn't	exist (old config directory is still
       supported and has precedence over XDG BD	compliant locations).

       This means configuration	is stored in
       $XDG_CONFIG_HOME/timewarrior/timewarrior.cfg, which defaults to
       ~/.config/timewarrior/timewarrior.cfg if	$XDG_CONFIG_HOME environment
       variable	is not specified.

       Those wanting to	migrate	their data to a	new directory scheme, might do
       that with following shell snippet:

	   LEGACY="${HOME}/.timewarrior"
	   CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/timewarrior"
	   DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/timewarrior"
	   mkdir -p "${CONFIG_DIR}"
	   mkdir -p "${DATA_DIR}"
	   mv "${LEGACY}/timewarrior.cfg" "${CONFIG_DIR}"
	   mv "${LEGACY}/extensions" "${CONFIG_DIR}"
	   mv "${LEGACY}/data" "${DATA_DIR}"
	   rmdir "${LEGACY}"

       This file contains a mix	of rules and configuration settings. Note that
       the TIMEWARRIORDB environment variable can be set to override this
       location.

       The values 'true', '1', 'y', 'yes' and 'on' are all equivalent and
       enable a	setting. Any other value means disable the setting.

       Default values may be overridden	by timewarrior.cfg values, which may
       in turn be overridden on	the command line using:	rc.<name>=<value>

       For example, to turn off	verbose	mode:

	   rc.verbose=0

       Note that hints can also	do this	(:quiet).

CONFIGURATION
       confirmation
	   Determines whether harmful operations require interactive
	   confirmation.

	   May be overridden by	the ':yes' hint.

	   Default value is 'yes'.

       verbose
	   Determines whether Timewarrior generates feedback.

	   May be overridden by	the ':quiet' hint.

	   Default value is 'yes'.

       debug
	   Determines whether diagnostic debugging information is shown.

	   Useful for troubleshooting, but not for general use.

	   Default value is 'off'.

       debug.indicator
	   The debug output prefix string.

	   Default value is '>>'.

timew 1.7.1			  2024-01-16		       TIMEW-CONFIG(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=timew-config&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help