3 Yann Dirson <ydirson@altern.org>
12 stg cp [OPTIONS] <file|dir> <newname>
14 stg cp [OPTIONS] <files|dirs...> <dir>
19 Make git-controlled copies of git-controlled files. The copies are
20 added to the Git index, so you can add them to a patch with
23 In the first form, copy a single file or a single directory, with a
24 new name. The parent directory of <newname> must already exist;
25 <newname> itself must not already exist, or the command will be
26 interpreted as one of the second form.
28 In the second form, copy one or several files and/or directories, into
29 an existing directory.
31 Directories are copied recursively. Only the git-controlled files
32 under the named directories are copied and added to the index. Any
33 file not known to Git will not be copied.
38 This command does not allow yet to overwrite an existing file (whether
39 it could be recovered from Git or not). Further more, when copying a
40 directory, the second form does not allow to proceed if a directory by
41 that name already exists inside the target, even when no file inside
42 that directory would be overwritten.
48 Also copy files not known to Git when copying a directory.
51 Force overwriting of target files, even if overwritten files
52 have non-committed changes or are not known to Git.
55 Show which files would be added, and which would be modified
56 if --force would be added.
60 Part of the StGIT suite - see gitlink:stg[1].