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

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
   3 <sect1 id="tsvn-dug-submodules">\r
   4         <?dbhh topicname="HIDD_SUBMODULE_ADD"?>\r
   5         <title>Submodules</title>\r
   6         <para>\r
   7                 When you want to embedd foreign repositories into a working copy/git repository, this is called a submodule.\r
   8                 Here using the\r
   9                 <menuchoice>\r
  10                         <guimenu>TortoiseGit</guimenu>\r
  11                         <guimenuitem>Submodules Add</guimenuitem>\r
  12                 </menuchoice>\r
  13                 option a foreign repository can be embedded into a dedicated subdirectory of the source tree.\r
  14                 When selecting this option, a dialog pops up:\r
  15                 <figure id="tsvn-dug-submodules-dia-1">\r
  16                         <title>The add submodule dialog</title>\r
  17                         <graphic fileref="../images/GitSubModuleAdd.png"/>\r
  18                 </figure>\r
  19                 Here you can enter the location/URL of the <guilabel>Repository</guilabel> you want to embedd\r
  20                 into the directory <guilabel>Path</guilabel>. <guilabel>Path</guilabel> can be entered as a relative\r
  21                 path within the active source tree, but can also be an absolute path (pointing to the active source tree).\r
  22                 The folder should be empty or non existent.\r
  23                 If you don't want to integrate the HEAD of the <guilabel>Repository</guilabel>, you can enter a differend\r
  24                 <guilabel>Branch</guilabel>.\r
  25                 By pressing <guibutton>OK</guibutton>, the entered <guilabel>Repository</guilabel> is cloned and integrated\r
  26                 into the current source tree.\r
  27         </para>\r
  28         <para>\r
  29                 If a working copy contains submodules, two new context menu entries are available:\r
  30                 <figure id="tsvn-dug-submodules-dia-2">\r
  31                         <title>Submodule context menu entries</title>\r
  32                         <graphic fileref="../images/ContextMenuSubmodules.png"/>\r
  33                 </figure>\r
  34         </para>\r
  35         <para>\r
  36                 <guimenuitem>Submodule Update</guimenuitem>: Initialize the submodules and/or update the registered submodules, i.e. clone missing submodules and checkout the commit specified in the index of the containing repository.\r
  37         </para>\r
  38         <para>\r
  39                 <guimenuitem>Submodule Sync</guimenuitem>: Synchronizes submodules' remote URL configuration setting to the value specified in .gitmodules. This is useful when submodule URLs change upstream and you need to update your local repositories accordingly. \r
  40         </para>\r
  41         <para>\r
  42                 Also if a working copy contains submodules, <xref linkend="tsvn-dug-checkout"/> and <xref linkend="tsvn-dug-reset"/> contain a button for updating submodules:\r
  43                 <figure id="tsvn-dug-submodules-dia-3">\r
  44                         <title>Button for updating submodules in progress dialog</title>\r
  45                         <graphic fileref="../images/CheckoutSubmodules.png"/>\r
  46                 </figure>\r
  47         </para>\r
  48         <para>\r
  49                 You can find more information at <xref linkend="git-submodule(1)"/>\r
  50         </para>\r
  51 </sect1>\r