blob: 23149258cfb7791b5a79d57bc52ce5c670fae153 [file] [log] [blame]
stg-cp(1)
=========
Yann Dirson <ydirson@altern.org>
v0.13, March 2007
NAME
----
stg-cp - stgdesc:cp[]
SYNOPSIS
--------
[verse]
'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
stglink:refresh[].
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 gitlink:stg[1].