##// END OF EJS Templates
issue 1053: heavily qualify the "cp -al" advice for cloning
Bryan O'Sullivan -
r6509:52798484 default
parent child Browse files
Show More
@@ -506,15 +506,17 b' def clone(ui, source, dest=None, **opts)'
506 do not report errors. In these cases, use the --pull option to
506 do not report errors. In these cases, use the --pull option to
507 avoid hardlinking.
507 avoid hardlinking.
508
508
509 You can safely clone repositories and checked out files using full
509 In some cases, you can clone repositories and checked out files
510 hardlinks with
510 using full hardlinks with
511
511
512 $ cp -al REPO REPOCLONE
512 $ cp -al REPO REPOCLONE
513
513
514 which is the fastest way to clone. However, the operation is not
514 This is the fastest way to clone, but it is not always safe. The
515 atomic (making sure REPO is not modified during the operation is
515 operation is not atomic (making sure REPO is not modified during
516 up to you) and you have to make sure your editor breaks hardlinks
516 the operation is up to you) and you have to make sure your editor
517 (Emacs and most Linux Kernel tools do so).
517 breaks hardlinks (Emacs and most Linux Kernel tools do so). Also,
518 this is not compatible with certain extensions that place their
519 metadata under the .hg directory, such as mq.
518
520
519 If you use the -r option to clone up to a specific revision, no
521 If you use the -r option to clone up to a specific revision, no
520 subsequent revisions will be present in the cloned repository.
522 subsequent revisions will be present in the cloned repository.
General Comments 0
You need to be logged in to leave comments. Login now