[1980] | 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 |
---|