GIT-Home > manpage
GIT-Home
tutorial
manpage
download
FAQ

GIT-HOME (1)

SYNOPSIS

git-home [ options ] command [ command option ]

DESCRIPTION

The basic aim of git-home is to automate task when keeping a whole home directory in git repositories. The first motivation for git-home comes from Joey Hess' cvshome (formerly cvshome) and the second one from Jean-Francois Richard's git-home-history.

OPTIONS

--debug, -d display git(1) messages.
--help, -h show help screen
--quiet, -q do no display anything

COMMANDS

add-module
create a new module
commit
commit all modified files and push changes to remote repository
fix-modules
do symlinks from modules to home
help
show help screen
init-modules
do some local configuration in .git
ls-files
show managed files
move
move files from one repository to an other and commit, fix and push
pull
pull all missing (or new) modules but do not update existing modules
status
display file status
update
update all modules and fix them

add-module options

add-module [ options ] url module-name
--to, -t <path>
 create local module in <path> (default=``.``).
--home, -h treat repository as the home super-repository.
--git-homed, -g
 do only clone a git-home module from url and update the .git-home configuration file.
--no-fix, -F do not call the fix routine.
--commit-all, -c
 set the commit-all switch in the configuration file to enable the tracking / committing of _all_ file located in the module.
--no-update, -U
 unset the update switch in the configuration file to disable module treatment when using the update command.
--no-push, -P unset the push switch in the configuration file to skip module upload.
--external, -e set the external switch in the configuration file. All other switches are unset as well. The ls-file does not display files under an external module.

The new modules-name would be created and uploaded to url.

commit options

commit [ -m,--message message ] modules ...
--message, -m the commit message log instead of default one.

fix-modules options

fix-modules [ -C,--no-commit ] [ -m | --message message ] [ modules ... ]
--no-commit, -C
 do not commit changes made to the __home__ module.
--message, -m the commit message log instead of default one.

Performs operation only on modules if specified, on all otherwise.

help options

help

This command has no option.

init-modules options

init-modules [ modules ... ]

Performs operation only on modules if specified, on all otherwise.

ls-files options

init-files [ options ] [ modules ... ]
--ignored, -i list only ignored files.
--modified, -m list only modified files.

Performs operation only on modules if specified, on all otherwise.

move options

move [ -f,--from module ] [ -t | --to module ] files ...
--from, -f source module instead of __home__.
--to, -t destination module instead of __home__.
--no-commit, -C
 do not commit changes made to the destination module.

pull options

pull [ -u,--url url ]
--url, -u pull from url to current directory and setup this url as the __home__ super-repository.

If no option is provided, pull all missing modules (that are manually defined in then .git-home configuration file).

status options

status [ [ -u,--untracked ] | [ -t | --tracked ] | [ -a | --all ] ]
--untracked, -u
 show only untracked files
--tracked, -t show only modified tracked files.
--all, -a combination of previous options (this is the default behaviour).

update options

update

This command has no option.

BUGS

No time to include bugs, command actions might seldom lead astray user's assumption.