doc/source/en/TortoiseSVN/tsvn_dug/dug_add.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
   3 <sect1 id="tsvn-dug-add">\r
   4         <title>Adding New Files And Directories</title>\r
   5         <indexterm>\r
   6                 <primary>add</primary>\r
   7         </indexterm>\r
   8         <indexterm>\r
   9                 <primary>version new files</primary>\r
  10         </indexterm>\r
  11         <?dbhh topicname="HIDD_ADD"?>\r
  12         <para>\r
  13                 <figure id="tsvn-dug-adding-dia-1">\r
  14                         <title>Explorer context menu for unversioned files</title>\r
  15                         <graphic fileref="../images/ContextMenuFileNoControl.png"/>\r
  16                 </figure>\r
  17                 If you created new files and/or directories during\r
  18                 your development process then you need to add them\r
  19                 to source control too. Select the file(s) and/or directory\r
  20                 and use\r
  21                 <menuchoice>\r
  22                         <guimenu>TortoiseSVN</guimenu>\r
  23                         <guimenuitem>Add</guimenuitem>\r
  24                 </menuchoice>.\r
  25         </para>\r
  26         <para>\r
  27                 After you added the files/directories to source control\r
  28                 the file appears with a <literal>added</literal> icon overlay which means you\r
  29                 first have to commit your working copy to make those\r
  30                 files/directories available to other developers.\r
  31                 Adding a file/directory does <emphasis>not</emphasis> affect\r
  32                 the repository!\r
  33         </para>\r
  34         <tip>\r
  35                 <title>Many Adds</title>\r
  36                 <para>\r
  37                         You can also use the Add command on already versioned\r
  38                         folders. In that case, the add dialog will show you all\r
  39                         unversioned files inside that versioned folder.\r
  40                         This helps if you have many new files and need to add\r
  41                         them all at once.\r
  42                 </para>\r
  43         </tip>\r
  44         <para>\r
  45                 To add files from outside your working copy you can use\r
  46                 the drag-and-drop handler:\r
  47                 <orderedlist>\r
  48                         <listitem>\r
  49                                 <para>\r
  50                                         select the files you want to add\r
  51                                 </para>\r
  52                         </listitem>\r
  53                         <listitem>\r
  54                                 <para>\r
  55                                         <action>right-drag</action> them\r
  56                                         to the new location inside the working copy\r
  57                                 </para>\r
  58                         </listitem>\r
  59                         <listitem>\r
  60                                 <para>\r
  61                                         release the right mouse button\r
  62                                 </para>\r
  63                         </listitem>\r
  64                         <listitem>\r
  65                                 <para>\r
  66                                         select\r
  67                                         <menuchoice>\r
  68                                                 <guimenu>Context Menu</guimenu>\r
  69                                                 <guimenuitem>SVN Add files to this WC</guimenuitem>\r
  70                                         </menuchoice>.\r
  71                                         The files will then be copied to the working copy and\r
  72                                         added to version control.\r
  73                                 </para>\r
  74                         </listitem>\r
  75                 </orderedlist>\r
  76         </para>\r
  77         <para>\r
  78                 You can also add files within a working copy simply by left-dragging and\r
  79                 dropping them onto the commit dialog.\r
  80         </para>\r
  81         <para>\r
  82                 If you add a file or folder by mistake, you can undo the addition\r
  83                 before you commit using\r
  84                 <menuchoice>\r
  85                         <guimenu>TortoiseSVN</guimenu>\r
  86                         <guimenuitem>Undo add...</guimenuitem>\r
  87                 </menuchoice>.\r
  88         </para>\r
  89 </sect1>\r