stg-cp(1)
NAME
stg-cp - stgdesc:cp[]
SYNOPSIS
stg cp [OPTIONS] <file|dir> <newname> stg cp [OPTIONS] <files|dirs...> <dir>
DESCRIPTION
Make git-controlled copies of git-controlled files. The copies are
added to the Git index, so you can add them to a patch with stgrefresh.
In the first form, copy a single file or a single directory, with a new
name. The parent directory of <newname> must already exist; <newname>
itself must not already exist, or the command will be interpreted as
one of the second form.
In the second form, copy one or several files and/or directories, into
an existing directory.
Directories are copied recursively. Only the git-controlled files under
the named directories are copied and added to the index. Any file not
known to Git will not be copied.
CAVEATS
This command does not allow yet to overwrite an existing file (whether
it could be recovered from Git or not). Further more, when copying a
directory, the second form does not allow to proceed if a directory by
that name already exists inside the target, even when no file inside
that directory would be overwritten.
FUTURE OPTIONS
No options are supported yet. The following options may be implemented
in the future.
- --all
- Also copy files not known to Git when copying a directory.
- --force
- Force overwriting of target files, even if overwritten files have
non-committed changes or are not known to Git. - --dry-run
- Show which files would be added, and which would be modified if
--force would be added.
STGIT
Part of the StGIT suite - see git1[1].
NOTES
- 1. 1
- stg