Home Explore Help
Sign In
pbarriat
/
ecearth3
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: 937295dc99
Branches Tags
ecearth3
/
sources
/
nemo-3.6
/
EXTERNAL
/
fcm
/
lib
/
Fcm
/
CLI
/
fcm-mkpatch.pod

fcm-mkpatch.pod 2.2 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960 
  1. =head1 NAME
    2. 

  2. 

  3. fcm mkpatch
    4. 

  4. 

  5. =head1 SYNOPSIS
    6. 

  6. 

  7. mkpatch: Create patches from specified revisions of a URL
    8. 

  8. 

  9.     fcm mkpatch [OPTIONS] URL [OUTDIR]
    10. 

  10. 

  11. Create patches from specified revisions of the specified URL. If OUTDIR is
    12. 

  12. specified, the output is sent to OUTDIR. Otherwise, the output will be sent to a
    13. 

  13. default location in the current directory ($PWD/fcm-mkpatch-out). The output
    14. 

  14. directory will contain the patch for each revision as well as a script for
    15. 

  15. importing the patch.
    16. 

  16. 

  17. A warning is given if the URL is not of a branch in a FCM project or if it is a
    18. 

  18. sub-directory of a branch.
    19. 

  19. 

  20. =head1 OPTIONS
    21. 

  21. 

  22. =over 4
    23. 

  23. 

  24. =item --exclude arg
    25. 

  25. 

  26. Exclude a path in the URL. Multiple paths can be specified by using a
    27. 

  27. colon-separated list of paths, or by specifying this option multiple times.
    28. 

  28. 

  29. The specified path must be a relative path of the URL. Glob patterns such as *
    30. 

  30. and ? are acceptable. Changes in an excluded path will not be considered in the
    31. 

  31. patch. A changeset containing changes only in the excluded path will not be
    32. 

  32. considered at all.
    33. 

  33. 

  34. =item --organisation arg
    35. 

  35. 

  36. This option can be used to specify the name of your organisation.
    37. 

  37. 

  38. The command will attempt to parse the commit log message for each revision in
    39. 

  39. the patch. It will remove all merge templates, replace Trac links with a
    40. 

  40. modified string, and add information about the original changeset. If you
    41. 

  41. specify the name of your organisation, it will replace Trac links such as
    42. 

  42. "ticket:123" with "$organisation_ticket:123", and report the original changeset
    43. 

  43. with a message such as "$organisation_changeset:1000".  If the organisation
    44. 

  44. name is not specified then it defaults to "original".
    45. 

  45. 

  46. =item -r [--revision] arg
    47. 

  47. 

  48. Specify a revision number or a revision number range.
    49. 

  49. 

  50. If a revision is specified with the --revision option, it will attempt to create
    51. 

  51. a patch based on the changes at that revision. If a revision is not specified,
    52. 

  52. it will attempt to create a patch based on the changes at the HEAD revision. If
    53. 

  53. a revision range is specified, it will attempt to create a patch for each
    54. 

  54. revision in that range (including the change in the lower range) where changes
    55. 

  55. have taken place in the URL. No output will be written if there is no change in
    56. 

  56. the given revision (range).
    57. 

  57. 

  58. =back
    59. 

  59. 

  60. =cut
    61.