Show More
@@ -1040,8 +1040,9 b' def clone(ui, source, dest=None, **opts)' | |||
|
1040 | 1040 | The location of the source is added to the new repository's |
|
1041 | 1041 | ``.hg/hgrc`` file, as the default to be used for future pulls. |
|
1042 | 1042 | |
|
1043 | It is possible to specify an ``ssh://`` URL as the destination, but no | |
|
1044 | ``.hg/hgrc`` and working directory will be created on the remote side. | |
|
1043 | Only local paths and ``ssh://`` URLs are supported as | |
|
1044 | destinations. For ``ssh://`` destinations, no working directory or | |
|
1045 | ``.hg/hgrc`` will be created on the remote side. | |
|
1045 | 1046 | |
|
1046 | 1047 | To pull only a subset of changesets, specify one or more revisions |
|
1047 | 1048 | identifiers with -r/--rev or branches with -b/--branch. The |
@@ -1051,38 +1052,40 b' def clone(ui, source, dest=None, **opts)' | |||
|
1051 | 1052 | tag will include the tagged changeset but not the changeset |
|
1052 | 1053 | containing the tag. |
|
1053 | 1054 | |
|
1054 | For efficiency, hardlinks are used for cloning whenever the source | |
|
1055 | and destination are on the same filesystem (note this applies only | |
|
1056 | to the repository data, not to the working directory). Some | |
|
1057 | filesystems, such as AFS, implement hardlinking incorrectly, but | |
|
1058 | do not report errors. In these cases, use the --pull option to | |
|
1059 | avoid hardlinking. | |
|
1060 | ||
|
1061 | In some cases, you can clone repositories and the working directory | |
|
1062 | using full hardlinks with :: | |
|
1063 | ||
|
1064 | $ cp -al REPO REPOCLONE | |
|
1065 | ||
|
1066 | This is the fastest way to clone, but it is not always safe. The | |
|
1067 | operation is not atomic (making sure REPO is not modified during | |
|
1068 | the operation is up to you) and you have to make sure your editor | |
|
1069 | breaks hardlinks (Emacs and most Linux Kernel tools do so). Also, | |
|
1070 | this is not compatible with certain extensions that place their | |
|
1071 | metadata under the .hg directory, such as mq. | |
|
1072 | ||
|
1073 | Mercurial will update the working directory to the first applicable | |
|
1074 | revision from this list: | |
|
1075 | ||
|
1076 | a) null if -U or the source repository has no changesets | |
|
1077 | b) if -u . and the source repository is local, the first parent of | |
|
1078 |
the source repository |
|
|
1079 | c) the changeset specified with -u (if a branch name, this means the | |
|
1080 | latest head of that branch) | |
|
1081 |
|
|
|
1082 | e) the tipmost head specified with -b | |
|
1083 | f) the tipmost head specified with the url#branch source syntax | |
|
1084 |
|
|
|
1085 | h) tip | |
|
1055 | .. container:: verbose | |
|
1056 | ||
|
1057 | For efficiency, hardlinks are used for cloning whenever the | |
|
1058 | source and destination are on the same filesystem (note this | |
|
1059 | applies only to the repository data, not to the working | |
|
1060 | directory). Some filesystems, such as AFS, implement hardlinking | |
|
1061 | incorrectly, but do not report errors. In these cases, use the | |
|
1062 | --pull option to avoid hardlinking. | |
|
1063 | ||
|
1064 | In some cases, you can clone repositories and the working | |
|
1065 | directory using full hardlinks with :: | |
|
1066 | ||
|
1067 | $ cp -al REPO REPOCLONE | |
|
1068 | ||
|
1069 | This is the fastest way to clone, but it is not always safe. The | |
|
1070 | operation is not atomic (making sure REPO is not modified during | |
|
1071 | the operation is up to you) and you have to make sure your | |
|
1072 | editor breaks hardlinks (Emacs and most Linux Kernel tools do | |
|
1073 | so). Also, this is not compatible with certain extensions that | |
|
1074 | place their metadata under the .hg directory, such as mq. | |
|
1075 | ||
|
1076 | Mercurial will update the working directory to the first applicable | |
|
1077 | revision from this list: | |
|
1078 | ||
|
1079 | a) null if -U or the source repository has no changesets | |
|
1080 | b) if -u . and the source repository is local, the first parent of | |
|
1081 | the source repository's working directory | |
|
1082 | c) the changeset specified with -u (if a branch name, this means the | |
|
1083 | latest head of that branch) | |
|
1084 | d) the changeset specified with -r | |
|
1085 | e) the tipmost head specified with -b | |
|
1086 | f) the tipmost head specified with the url#branch source syntax | |
|
1087 | g) the tipmost head of the default branch | |
|
1088 | h) tip | |
|
1086 | 1089 | |
|
1087 | 1090 | See :hg:`help urls` for details on specifying URLs. |
|
1088 | 1091 |
General Comments 0
You need to be logged in to leave comments.
Login now