1 | =head1 NAME |
---|
2 | |
---|
3 | fcm mkpatch |
---|
4 | |
---|
5 | =head1 SYNOPSIS |
---|
6 | |
---|
7 | mkpatch: Create patches from specified revisions of a URL |
---|
8 | |
---|
9 | fcm mkpatch [OPTIONS] URL [OUTDIR] |
---|
10 | |
---|
11 | Create patches from specified revisions of the specified URL. If OUTDIR is |
---|
12 | specified, the output is sent to OUTDIR. Otherwise, the output will be sent to a |
---|
13 | default location in the current directory ($PWD/fcm-mkpatch-out). The output |
---|
14 | directory will contain the patch for each revision as well as a script for |
---|
15 | importing the patch. |
---|
16 | |
---|
17 | A warning is given if the URL is not of a branch in a FCM project or if it is a |
---|
18 | sub-directory of a branch. |
---|
19 | |
---|
20 | =head1 OPTIONS |
---|
21 | |
---|
22 | =over 4 |
---|
23 | |
---|
24 | =item --exclude arg |
---|
25 | |
---|
26 | Exclude a path in the URL. Multiple paths can be specified by using a |
---|
27 | colon-separated list of paths, or by specifying this option multiple times. |
---|
28 | |
---|
29 | The specified path must be a relative path of the URL. Glob patterns such as * |
---|
30 | and ? are acceptable. Changes in an excluded path will not be considered in the |
---|
31 | patch. A changeset containing changes only in the excluded path will not be |
---|
32 | considered at all. |
---|
33 | |
---|
34 | =item --organisation arg |
---|
35 | |
---|
36 | This option can be used to specify the name of your organisation. |
---|
37 | |
---|
38 | The command will attempt to parse the commit log message for each revision in |
---|
39 | the patch. It will remove all merge templates, replace Trac links with a |
---|
40 | modified string, and add information about the original changeset. If you |
---|
41 | specify the name of your organisation, it will replace Trac links such as |
---|
42 | "ticket:123" with "$organisation_ticket:123", and report the original changeset |
---|
43 | with a message such as "$organisation_changeset:1000". If the organisation |
---|
44 | name is not specified then it defaults to "original". |
---|
45 | |
---|
46 | =item -r [--revision] arg |
---|
47 | |
---|
48 | Specify a revision number or a revision number range. |
---|
49 | |
---|
50 | If a revision is specified with the --revision option, it will attempt to create |
---|
51 | a patch based on the changes at that revision. If a revision is not specified, |
---|
52 | it will attempt to create a patch based on the changes at the HEAD revision. If |
---|
53 | a revision range is specified, it will attempt to create a patch for each |
---|
54 | revision in that range (including the change in the lower range) where changes |
---|
55 | have taken place in the URL. No output will be written if there is no change in |
---|
56 | the given revision (range). |
---|
57 | |
---|
58 | =back |
---|
59 | |
---|
60 | =cut |
---|