| 1 | =head1 NAME |
|---|
| 2 | |
|---|
| 3 | fcm export-items |
|---|
| 4 | |
|---|
| 5 | =head1 SYNOPSIS |
|---|
| 6 | |
|---|
| 7 | Exports directories in SOURCE as a list of versioned items. |
|---|
| 8 | |
|---|
| 9 | This command is used to support a legacy working practice, in which directories |
|---|
| 10 | in a source tree are regarded as individual versioned items. |
|---|
| 11 | |
|---|
| 12 | fcm export-items [OPTIONS] SOURCE |
|---|
| 13 | |
|---|
| 14 | =head1 ARGUMENTS |
|---|
| 15 | |
|---|
| 16 | The SOURCE should be the URL of a branch in a Subversion repository with the |
|---|
| 17 | standard FCM layout. |
|---|
| 18 | |
|---|
| 19 | =head1 OPTIONS |
|---|
| 20 | |
|---|
| 21 | =over 4 |
|---|
| 22 | |
|---|
| 23 | =item --config-file=PATH, --file=PATH, -f PATH |
|---|
| 24 | |
|---|
| 25 | Specify the path to the configuration file. |
|---|
| 26 | (default=$PWD/fcm-export-items.cfg) |
|---|
| 27 | |
|---|
| 28 | =item --directory=PATH, -C PATH |
|---|
| 29 | |
|---|
| 30 | Specify the path to the destination. (default=$PWD) |
|---|
| 31 | |
|---|
| 32 | =item --new, -N |
|---|
| 33 | |
|---|
| 34 | Specify the new mode. In this mode, everything is re-exported. Otherwise, the |
|---|
| 35 | system runs in incremental mode, in which the version directories are only |
|---|
| 36 | updated if they do not already exist. |
|---|
| 37 | |
|---|
| 38 | =back |
|---|
| 39 | |
|---|
| 40 | =head1 CONFIGURATION |
|---|
| 41 | |
|---|
| 42 | The configuration file should be in the deprecated FCM 1 configuration format. |
|---|
| 43 | The label in each entry should be a path relative to the source URL. If the path |
|---|
| 44 | ends in * then the path is expanded recursively and any sub-directories |
|---|
| 45 | containing regular files are added to the list of relative paths to export. The |
|---|
| 46 | value may be empty, or it may be a list of space separated "conditions". Each |
|---|
| 47 | condition is a conditional operator (>, >=, <, <=, == or !=) followed by a |
|---|
| 48 | revision number. The command uses the revision log to determine the revisions at |
|---|
| 49 | which the relative path has been updated in the source URL. If these revisions |
|---|
| 50 | also satisfy the "conditions" set by the user, they will be considered in the |
|---|
| 51 | export. |
|---|
| 52 | |
|---|
| 53 | =head1 COPYRIGHT |
|---|
| 54 | |
|---|
| 55 | Copyright (C) 2006-2021 British Crown (Met Office) & Contributors. |
|---|
| 56 | |
|---|
| 57 | =cut |
|---|
