Commit | Line | Data |
---|---|---|
d5ae2173 YD |
1 | stg-cp(1) |
2 | ========= | |
3 | Yann Dirson <ydirson@altern.org> | |
4 | v0.13, March 2007 | |
5 | ||
6 | NAME | |
7 | ---- | |
8 | stg-cp - stgdesc:cp[] | |
9 | ||
10 | SYNOPSIS | |
11 | -------- | |
d1d7d28d YD |
12 | [verse] |
13 | 'stg' cp [OPTIONS] <file|dir> <newname> | |
14 | 'stg' cp [OPTIONS] <files|dirs...> <dir> | |
d5ae2173 YD |
15 | |
16 | DESCRIPTION | |
17 | ----------- | |
18 | ||
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 | |
21 | stglink:refresh[]. | |
22 | ||
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. | |
27 | ||
28 | In the second form, copy one or several files and/or directories, into | |
29 | an existing directory. | |
30 | ||
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. | |
34 | ||
35 | CAVEATS | |
36 | ------- | |
37 | ||
d92a3fd7 YD |
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. | |
d5ae2173 YD |
43 | |
44 | FUTURE OPTIONS | |
45 | -------------- | |
46 | ||
d1d7d28d YD |
47 | No options are supported yet. The following options may be |
48 | implemented in the future. | |
49 | ||
d5ae2173 YD |
50 | --all:: |
51 | Also copy files not known to Git when copying a directory. | |
52 | ||
53 | --force:: | |
54 | Force overwriting of target files, even if overwritten files | |
55 | have non-committed changes or are not known to Git. | |
56 | ||
57 | --dry-run:: | |
58 | Show which files would be added, and which would be modified | |
59 | if --force would be added. | |
60 | ||
61 | StGIT | |
62 | ----- | |
b24fee3e | 63 | Part of the StGIT suite - see gitlink:stg[1]. |