hg clone [ПАРАМЕТР]... ИСТОЧНИК [НАЗН]

создать копию существующего хранилища

Создает копию существующего хранилища в новом каталоге.

Если каталог назначения не задан, используется базовая часть имени каталога источника.

Адрес источника добавляется в файл ".hg/hgrc" нового хранилища, и используется по умолчанию для последующих затягиваний.

В качестве путей назначения поддерживаются только локальные пути и URL вида "ssh://". Для назначения "ssh://" не создается рабочей копии или файла ".hg/hgrc" на отдаленной стороне.

Чтобы затянуть подмножество наборов изменений, укажите один или более идентификатор ревизии с помощью -r/--rev или ветки с помощь -b/--branch. Клон будет содержать только заданные ревизии и их предков. Эти параметры (равно как и 'clone ист#рев назн') подразумевают --pull, даже для локальных исходных хранилищ. Обратите внимание, что при задании метки, клон будет включать в себя помеченный набор изменений, но не набор изменений, содержащий метку.

Если хранилище-источник имеет закладку с именем '@', эта ревизия будет автоматически извлечена в новом хранилище по умолчанию.

Чтобы извлечь конкретную версию, используйте -u/--update; чтобы создать клон без рабочего каталога, используйте -U/--noupdate.

Из соображений эффективности при клонировании источника находящегося на одной файловой системе с хранилищем назначения, используются жесткие ссылки (это относится только к данным хранилища, не рабочему каталогу). Некоторые файловые системы, например, AFS, некорректно реализуют жесткие ссылки, но не сообщают об ошибках. В этом случае используйте --pull чтобы избежать жестких ссылок.

В некоторых случаях можно клонировать хранилища и рабочие каталоги целиком жесткими ссылками

$ cp -al ХРАНИЛИЩЕ КЛОН

Это самый быстрый способ клонирования, но он не всегда безопасен. Эта операция не атомарна (вам надо следить за тем, что ХРАНИЛИЩЕ не изменяется в процессе копирования), и вам надо убедиться, что ваш редактор умеет разрывать жесткие ссылки (Emacs и большинство инструментов разработчика ядра Linux умеют). Этот способ также не совместим с некоторыми расширениями, которые хранят свои метаданные в каталоге .hg, таких как mq.

Mercurial обновит рабочий каталог до первой подходящей ревизии по списку:

а) пустой каталог, если в источнике нет наборов изменений или указан -U б) если указано -u . и источник локален, до первого родителя рабочей копии источника в) ревизия, указанная в -u (если это имя ветки, то до головной ревизии этой ветки) г) до ревизии, указанной с помощью -r д) до самой новой головной ревизии указанной в -b е) до самой новой головной ревизии заданной как url#ветка ж) до ревизии с закладкой '@', если таковая существует з) до самой новой головной ревизии ветки default и) до оконечной ревизии

Примеры:

• создать клон отдаленного хранилища в новом каталоге с именем hg/:

  hg clone http://selenic.com/hg
  

• создать легковесный локальный клон:

  hg clone project/ project-feature/
  

• клонировать хранилище по абсолютному пути на ssh-сервере (обратите внимание на двойной слэш):

  hg clone ssh://user@server//home/projects/alpha/
  

• выполнить быстрое клонирование по локальной сети с извлечением указанной ревизии:

  hg clone --uncompressed http://server/repo -u 1.5
  

• создать хранилище без наборов изменений после заданной ревизии:

  hg clone -r 04e544 experimental/ good/
  

• клонировать (и отслеживать) указанную именованную ветку:

  hg clone http://selenic.com/hg#stable
  

Подробнее о задании URL хранилища см. "hg help urls".

В случае успеха возвращает 0.

параметры:

параметры, помеченные [+], могут указываться многократно

глобальные параметры:

параметры, помеченные [+], могут указываться многократно