burrow/burrow.1

55 lines
1.2 KiB
Groff

.TH BURROW 1 "06 Mar 2018" "version 1.2.5"
.SH NAME
burrow \- a helper for building and managing a gopher hole
.SH SYNOPSIS
burrow [options] [command]
.SH DESRIPTION
burrow is a collection of helper actions designed to assist in the creation,
modification, and maintenance of a gopher hole.
.SH COMMANDS
.TP
.B phlog
Create a new phlog entry.
.TP
.B recipe
Add or update a recipe to the recipe box.
.B topic
Add or update a topic in your topics directory.
.TP
.B create-config
Generates a default configuration file at
.I ~/.config/burrow/config
if no other configuration file exists. It is populated with the default
settings.
.TP
.B edit-config
Opens your burrow configuration file for editing if it exists.
.TP
.B update-git
If the gopher directory resides within a git repository, this action will do a
silent
.B git-pull
which is useful for crons.
.SH OPTIONS
.TP
.B -v, --version
Display current version information.
.TP
.B -d, --debug
Debug mode.
.TP
.B -h, --help
Show the help.
.SH FILES
.I ~/.config/burrow/config
,
.I ~/.config/burrow
,
.I ~/.burrow
: configuration settings for burrow. If none of these are available, the default
configuration is loaded.
.SH BUGS
None known.
.SH AUTHOR
James Tomasino <tomasino (at) sdf (dot) org>