/doc/source/clone.txt

https://bitbucket.org/tortoisehg/hgtk/ · Plain Text · 59 lines · 45 code · 14 blank · 0 comment · 0 complexity · 8509256817e5fe94c0487043d893f2ca MD5 · raw file

  1. Clone a repository
  2. =======================
  3. .. module:: clone.dialog
  4. :synopsis: Dialog used to clone a repository
  5. To clone a repository you have to run the clone dialog.
  6. From the explorer context menu select :menuselection:`TortoiseHg... --> Clone a repository`
  7. or type :command:`hgtk clone`.
  8. .. figure:: figures/clone.png
  9. :alt: Clone dialog
  10. Clone Dialog
  11. :guilabel:`Source Path`
  12. It is the path (or URL) of the repository that will be cloned. Use
  13. the :guilabel:`Browse...` to choose a local folder.
  14. :guilabel:`Destination Path`
  15. It is the path of destination directory, a folder with the same name
  16. of source repository will be created within this directory.
  17. Under the :guilabel:`Advanced options` expander you will find:
  18. :guilabel:`Clone To Revision`
  19. You can limit the clone up to this revision. Even the tags created
  20. after this revision will not be imported.
  21. :guilabel:`do not update the new working directory`
  22. If checked, after the clone the working directory will be empty. It
  23. is useful when you have to clone a repository with the purpose of
  24. central repository, or backup, where you have only, in the future,
  25. to *push* and *pull*.
  26. :guilabel:`use pull protocol to copy metadata`
  27. When the source and destination are on the same filesystem,
  28. Mercurial tries to use hardlinks. Some filesystems, such as AFS
  29. implement hardlink incorrectly, but do not report errors. Use this
  30. option to avoid hardlinks.
  31. :guilabel:`use uncompressed transfer`
  32. To use uncompressed transfer (fast over LAN).
  33. :guilabel:`use proxy server`
  34. To use the proxy server configured in :menuselection:`TortoiseHg... --> Global Settings --> Proxy`.
  35. This is enabled only if a proxy is configured.
  36. :guilabel:`Remote Cmd`
  37. Specify a Mercurial command to run on the remote side.
  38. From command line
  39. -----------------
  40. The clone tool can be started from command line ::
  41. hgtk clone
  42. The syntax is ::
  43. hgtk clone [SOURCE] [DEST]
  44. where [SOURCE] and [DEST] are, the paths of source repository and destination folder.
  45. .. vim: noet ts=4