doc/source/en/TortoiseGit/tsvn_dug/dug_copy.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
   3 <sect1 id="tsvn-dug-copy">\r
   4         <title>Copying/Moving/Renaming Files and Folders</title>\r
   5         <indexterm>\r
   6                 <primary>copy files</primary>\r
   7         </indexterm>\r
   8         <indexterm>\r
   9                 <primary>rename files</primary>\r
  10         </indexterm>\r
  11         <indexterm>\r
  12                 <primary>move files</primary>\r
  13         </indexterm>\r
  14         <indexterm>\r
  15                 <primary>branch</primary>\r
  16         </indexterm>\r
  17         <indexterm>\r
  18                 <primary>tag</primary>\r
  19         </indexterm>\r
  20         <para>\r
  21                 It often happens that you already have the files you need in another\r
  22                 project in your repository, and you simply want to copy them across.\r
  23                 You could simply copy the files and add them as described above, but\r
  24                 that would not give you any history. And if you subsequently fix a bug\r
  25                 in the original files, you can only merge the fix automatically if the\r
  26                 new copy is related to the original in Git.\r
  27         </para>\r
  28 <!--\r
  29         <para>\r
  30                 The easiest way to copy files and folders from within a working tree is\r
  31                 to use the right-drag menu. When you <action>right-drag</action> a file\r
  32                 or folder from one working tree to another, or even within the same\r
  33                 folder, a context menu appears when you release the mouse.\r
  34                 <figure id="tsvn-dug-copy-right-drag">\r
  35                         <title>Right drag menu for a directory under version control</title>\r
  36                         <graphic fileref="../images/RightDragMenu.png"/>\r
  37                 </figure>\r
  38                 Now you can copy existing versioned content to a new location, possibly\r
  39                 renaming it at the same time.\r
  40         </para>\r
  41         <para>\r
  42                 You can also copy or move versioned files within a working tree, or between two\r
  43                 working trees, using the familiar cut-and-paste method. Use the standard Windows\r
  44                 <action>Copy</action> or <action>Cut</action> to copy one or more versioned items\r
  45                 to the clipboard. If the clipboard contains such versioned items, you can then use\r
  46                 <menuchoice>\r
  47                         <guimenu>TortoiseGit</guimenu>\r
  48                         <guimenuitem>Paste</guimenuitem>\r
  49                 </menuchoice>\r
  50                 (note: not the standard Windows <action>Paste</action>)\r
  51                 to copy or move those items to the new working tree location.\r
  52         </para>\r
  53 -->\r
  54         <para>\r
  55                 You can copy files and folders from your working tree to another\r
  56                 location in the repository using\r
  57                 <menuchoice>\r
  58                         <guimenu>TortoiseGit</guimenu>\r
  59                         <guimenuitem>Branch/Tag</guimenuitem>\r
  60                 </menuchoice>.\r
  61                 Refer to <xref linkend="tsvn-dug-branch-1"/> to find out more.\r
  62         </para>\r
  63         <para>\r
  64                 You can locate an older version of a file or folder in the log\r
  65                 dialog and copy it to a new location in the repository directly\r
  66                 from the log dialog using\r
  67                 <menuchoice>\r
  68                         <guimenu>Context menu</guimenu>\r
  69                         <guimenuitem>Create branch/tag from revision</guimenuitem>\r
  70                 </menuchoice>.\r
  71                 Refer to <xref linkend="tsvn-dug-showlog-2"/> to find out more.\r
  72         </para>\r
  73 <!--\r
  74         <para>\r
  75                 You can also use the repository browser to locate content you want,\r
  76                 and copy it into your working tree directly from the repository,\r
  77                 or copy between two locations within the repository.\r
  78                 Refer to <xref linkend="tsvn-dug-repobrowser"/> to find out more.\r
  79         </para>\r
  80         <tip>\r
  81                 <title>Cannot copy between repositories</title>\r
  82                 <para>\r
  83                         Whilst you can copy and files and folders <emphasis>within</emphasis>\r
  84                         a repository, you <emphasis>cannot</emphasis> copy or move from one\r
  85                         repository to another while preserving history using TortoiseGit.\r
  86                         Not even if the repositories live on the same server. All you can\r
  87                         do is copy the content in its current state and add it as new\r
  88                         content to the second repository.\r
  89                 </para>\r
  90                 <para>\r
  91                         If you are uncertain whether two URLs on the same server refer\r
  92                         to the same or different repositories, use the repo browser to\r
  93                         open one URL and find out where the repository root is.\r
  94                         If you can see both locations in one repo browser window then\r
  95                         they are in the same repository.\r
  96                 </para>\r
  97         </tip>\r
  98 -->\r
  99 </sect1>\r