73 lines
2.5 KiB
Groff
73 lines
2.5 KiB
Groff
.\" This is the groff documentation source for gitw
|
|
.\"
|
|
.\" Preview with: groff -man -Tascii gitw.1
|
|
.\" or: man -l gitw.1
|
|
.\"
|
|
|
|
.TH GITW 1 "2023-10-26" "User Commands"
|
|
.SH NAME
|
|
gitw \- Git issue and milestone integration for taskwarrior
|
|
.SH SYNOPSIS
|
|
.B gitw
|
|
.RI COMMAND
|
|
.
|
|
.SH DESCRIPTION
|
|
.nr PI 4n
|
|
.B gitw
|
|
Gitwarrior is a CLI tool to extend the taskwarrior tasks to synch issues and milestones. Gitwarrior requires the following uda's to be defined:
|
|
.IP \[bu]
|
|
last_gitw_update(date)
|
|
.IP \[bu]
|
|
git_number(number)
|
|
.IP \[bu]
|
|
git_type(string)
|
|
.IP \[bu]
|
|
git_comment_ids(string)
|
|
.PP
|
|
It should be run inside of a git working copy (ideally in the root directory of the git repository).
|
|
.PP
|
|
gitw is a automation and wrapper for taskwarrior.
|
|
.
|
|
.SH COMMANDS
|
|
.B push
|
|
Push changes of local taskwarrior to gitea repository. Tasks which have all the uda's set correctly will be updated on the gitea instance according to the local git working copy.
|
|
.PP
|
|
.B pull
|
|
Pull changes from the gitea instance with information from the configuration file and the derived information from the local git working copy.
|
|
.PP
|
|
.B task <args>
|
|
Wrapper for taskwarrior, which wraps the provided taskwarrior filter and commands provided via
|
|
.I <args>
|
|
in the corresponding context for the current git working copy (which is used as a project name).
|
|
.PP
|
|
.I NOTE:
|
|
The taskwarrior context needs to be created before with the name of the context set to the project name of the git repository.
|
|
.PP
|
|
.B help
|
|
Print a help menu for all the commands available in
|
|
.B gitw
|
|
.
|
|
.SH EXAMPLES
|
|
gitw pull --dry-run
|
|
.PP
|
|
gitw push
|
|
.PP
|
|
gitw task
|
|
.PP
|
|
gitw --help
|
|
.PP
|
|
gitw --version
|
|
.PP
|
|
Pull changes from the corresponding gitea instance into the local taskwarrior tasks.
|
|
.
|
|
.SH AUTHOR
|
|
Written by Yves Biener.
|
|
Man page by Yves Biener.
|
|
.
|
|
.SH BUGS
|
|
Please report bugs at
|
|
.IR https://gitea.yves-biener.de/yves-biener/gitwarrior/issues
|
|
.
|
|
.SH COPYRIGHT
|
|
This software is provided by Yves Biener ''as is'' and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall Yves Biener be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.
|