391 |
391 |
392 def branch(ui, repo, label=None, **opts): |
392 def branch(ui, repo, label=None, **opts): |
393 """set or show the current branch name |
393 """set or show the current branch name |
394 |
394 |
395 With no argument, show the current branch name. With one argument, |
395 With no argument, show the current branch name. With one argument, |
396 set the working directory branch name (the branch does not exist in |
396 set the working directory branch name (the branch does not exist |
397 the repository until the next commit). |
397 in the repository until the next commit). It is recommended to use |
|
398 the 'default' branch as your primary development branch. |
398 |
399 |
399 Unless --force is specified, branch will not let you set a |
400 Unless --force is specified, branch will not let you set a |
400 branch name that shadows an existing branch. |
401 branch name that shadows an existing branch. |
401 |
402 |
402 Use --clean to reset the working directory branch to that of the |
403 Use --clean to reset the working directory branch to that of the |
561 basename of the source. |
562 basename of the source. |
562 |
563 |
563 The location of the source is added to the new repository's |
564 The location of the source is added to the new repository's |
564 .hg/hgrc file, as the default to be used for future pulls. |
565 .hg/hgrc file, as the default to be used for future pulls. |
565 |
566 |
|
567 If you use the -r option to clone up to a specific revision, no |
|
568 subsequent revisions (including subsequent tags) will be present |
|
569 in the cloned repository. This option implies --pull, even on |
|
570 local repositories. |
|
571 |
|
572 By default, clone will check out the head of the 'default' branch. |
|
573 If the -U option is used, the new clone will contain only a repository |
|
574 (.hg) and no working copy (the working copy parent is the null revision). |
|
575 |
|
576 See 'hg help urls' for valid source format details. |
|
577 |
|
578 It is possible to specify an ssh:// URL as the destination, but no |
|
579 .hg/hgrc and working directory will be created on the remote side. |
|
580 Look at the help text for urls for important details about ssh:// URLs. |
|
581 |
566 For efficiency, hardlinks are used for cloning whenever the source |
582 For efficiency, hardlinks are used for cloning whenever the source |
567 and destination are on the same filesystem (note this applies only |
583 and destination are on the same filesystem (note this applies only |
568 to the repository data, not to the checked out files). Some |
584 to the repository data, not to the checked out files). Some |
569 filesystems, such as AFS, implement hardlinking incorrectly, but |
585 filesystems, such as AFS, implement hardlinking incorrectly, but |
570 do not report errors. In these cases, use the --pull option to |
586 do not report errors. In these cases, use the --pull option to |
580 the operation is up to you) and you have to make sure your editor |
596 the operation is up to you) and you have to make sure your editor |
581 breaks hardlinks (Emacs and most Linux Kernel tools do so). Also, |
597 breaks hardlinks (Emacs and most Linux Kernel tools do so). Also, |
582 this is not compatible with certain extensions that place their |
598 this is not compatible with certain extensions that place their |
583 metadata under the .hg directory, such as mq. |
599 metadata under the .hg directory, such as mq. |
584 |
600 |
585 If you use the -r option to clone up to a specific revision, no |
|
586 subsequent revisions will be present in the cloned repository. |
|
587 This option implies --pull, even on local repositories. |
|
588 |
|
589 If the -U option is used, the new clone will contain only a repository |
|
590 (.hg) and no working copy (the working copy parent is the null revision). |
|
591 |
|
592 See 'hg help urls' for valid source format details. |
|
593 |
|
594 It is possible to specify an ssh:// URL as the destination, but no |
|
595 .hg/hgrc and working directory will be created on the remote side. |
|
596 Look at the help text for urls for important details about ssh:// URLs. |
|
597 """ |
601 """ |
598 cmdutil.setremoteconfig(ui, opts) |
602 cmdutil.setremoteconfig(ui, opts) |
599 hg.clone(ui, source, dest, |
603 hg.clone(ui, source, dest, |
600 pull=opts.get('pull'), |
604 pull=opts.get('pull'), |
601 stream=opts.get('uncompressed'), |
605 stream=opts.get('uncompressed'), |