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

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
   3 <sect1 id="tsvn-dug-export">\r
   4         <title>Exporting a Subversion Working Copy</title>\r
   5         <indexterm>\r
   6                 <primary>export</primary>\r
   7         </indexterm>\r
   8         <indexterm>\r
   9                 <primary>unversioned 'working copy'</primary>\r
  10         </indexterm>\r
  11         <para>\r
  12                 Sometimes you may want a copy of your working tree without any of\r
  13                 those <filename>.svn</filename> directories, e.g. to create a zipped\r
  14                 tarball of your source, or to export to a web server. Instead of\r
  15                 making a copy and then deleting all those <filename>.svn</filename>\r
  16                 directories manually, TortoiseGit offers the command\r
  17                 <menuchoice>\r
  18                         <guimenu>TortoiseGit</guimenu>\r
  19                         <guimenuitem>Export...</guimenuitem>\r
  20                 </menuchoice>.\r
  21                 Exporting from a URL and exporting from a working copy are treated\r
  22                 slightly differently.\r
  23         </para>\r
  24         <para>\r
  25                 <figure id="tsvn-dug-export-dia-1">\r
  26                         <title>The Export-from-URL Dialog</title>\r
  27                         <graphic fileref="../images/ExportURL.png"/>\r
  28                 </figure>\r
  29                 If you execute this command on an unversioned folder, TortoiseGit will\r
  30                 assume that the selected folder is the target, and open a dialog for\r
  31                 you to enter the URL and revision to export from.\r
  32                 This dialog has options to export only the top level folder, to omit\r
  33                 external references, and to override the line end style for files which\r
  34                 have the <literal>svn:eol-style</literal> property set.\r
  35         </para>\r
  36         <para>\r
  37                 Of course you can export directly from the repository too.\r
  38                 Use the Repository Browser to navigate to the relevant subtree\r
  39                 in your repository, then use\r
  40                 <menuchoice>\r
  41                         <guimenu>Context Menu</guimenu>\r
  42                         <guimenuitem>Export</guimenuitem>\r
  43                 </menuchoice>.\r
  44                 You will get the <guilabel>Export from URL</guilabel> dialog described above.\r
  45         </para>\r
  46         <para>\r
  47                 If you execute this command on your working copy you'll be asked for\r
  48                 a place to save the <emphasis>clean</emphasis> working copy without the\r
  49                 <filename>.svn</filename> folders.\r
  50                 By default, only the versioned files are exported, but you can use the\r
  51                 <guilabel>Export unversioned files too</guilabel> checkbox to include any other\r
  52                 unversioned files which exist in your WC and not in the repository.\r
  53                 External references using <literal>svn:externals</literal> can be\r
  54                 omitted if required.\r
  55         </para>\r
  56         <para>\r
  57                 Another way to export from a working copy is to <action>right drag</action>\r
  58                 the working copy folder to another location and choose\r
  59                 <menuchoice>\r
  60                         <guimenu>Context Menu</guimenu>\r
  61                         <guimenuitem>SVN Export here</guimenuitem>\r
  62                 </menuchoice>\r
  63                 or \r
  64                 <menuchoice>\r
  65                         <guimenu>Context Menu</guimenu>\r
  66                         <guimenuitem>SVN Export all here</guimenuitem>\r
  67                 </menuchoice>.\r
  68                 The second option includes the unversioned files as well.\r
  69         </para>\r
  70         <para>\r
  71                 When exporting from a working copy,\r
  72                 if the target folder already contains a folder of the same\r
  73                 name as the one you are exporting, you will be given the option\r
  74                 to overwrite the existing content, or to create a new folder with\r
  75                 an automatically generated name, eg. <literal>Target (1)</literal>.\r
  76         </para>\r
  77         <tip>\r
  78                 <title>Exporting single files</title>\r
  79                 <para>\r
  80                         The export dialog does not allow exporting single files, even \r
  81                         though Subversion can.\r
  82                 </para>\r
  83                 <para>\r
  84                         To export single files with TortoiseGit, you have to use\r
  85                         the repository browser (<xref linkend="tsvn-dug-repobrowser"/>).\r
  86                         Simply drag the file(s) you want to export from the repository\r
  87                         browser to where you want them in the explorer, or use the\r
  88                         context menu in the repository browser to export the files.\r
  89                 </para>\r
  90         </tip>\r
  91         <tip>\r
  92                 <title>Exporting a Change Tree</title>\r
  93                 <para>\r
  94                         If you want to export a copy of your project tree structure\r
  95                         but containing only the files which have changed in a particular\r
  96                         revision, or between any two revisions, use the compare revisions\r
  97                         feature described in <xref linkend="tsvn-dug-compare-revs"/>.\r
  98                 </para>\r
  99         </tip>\r
 100         <sect2 id="tsvn-dug-export-unversion">\r
 101                 <title>Removing a working copy from version control</title>\r
 102                 <indexterm>\r
 103                         <primary>unversion</primary>\r
 104                 </indexterm>\r
 105                 <para>\r
 106                         Sometimes you have a working copy which you want to convert back\r
 107                         to a normal folder without the <literal>.svn</literal> directories.\r
 108                         What you really need is an export-in-place command, that just\r
 109                         removes the control directories rather than generating a new\r
 110                         clean directory tree.\r
 111                 </para>\r
 112                 <para>\r
 113                         The answer is surprisingly simple - export the folder to itself!\r
 114                         TortoiseGit detects this special case and asks if you want to\r
 115                         make the working copy unversioned. If you answer\r
 116                         <emphasis>yes</emphasis> the control directories will be removed\r
 117                         and you will have a plain, unversioned directory tree.\r
 118                 </para>\r
 119         </sect2>\r
 120 </sect1>\r