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

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
   3 <sect1 id="tsvn-dug-stash">\r
   4         <?dbhh topicname="HIDD_STASH"?>\r
   5         <title>Stash Changes</title>\r
   6         <indexterm>\r
   7                 <primary>stash</primary>\r
   8         </indexterm>\r
   9         <para>\r
  10                 When you want to record the current state of the working directory and the index,\r
  11                 but want to go back to a clean working directory,\r
  12                 <action>right click</action> on a folder to pop up the context menu and then select\r
  13                 the command\r
  14                 <menuchoice>\r
  15                         <guimenu>TortoiseGit</guimenu>\r
  16                         <guimenuitem>Stash Save</guimenuitem>\r
  17                 </menuchoice>\r
  18                 A dialog will pop up where you can optionally enter a message for this state:\r
  19                 <figure id="tsvn-dug-stash-dia-1">\r
  20                         <title>Stash save dialog</title>\r
  21                         <graphic fileref="../images/stash.png"/>\r
  22                 </figure>\r
  23                 You can also select <guilabel>include untracked</guilabel>, to stash untracked files away, too.\r
  24         </para>\r
  25         <para>\r
  26                 When TortoiseGit detects that a stashed changes exist, the context menu will be extended:\r
  27                 <figure id="tsvn-dug-stash-dia-2">\r
  28                         <title>(un)stash options</title>\r
  29                         <graphic fileref="../images/ContextMenuStash.png"/>\r
  30                 </figure>\r
  31                 The stash is implemented as a stack. <guimenuitem>Stash Apply</guimenuitem> will apply the changes of the latest stash\r
  32                 to your working tree. <guimenuitem>Stash Pop</guimenuitem> does the same, but will remove the latest stash from the stack\r
  33                 after applying it. <guimenuitem>Stash Save</guimenuitem> is still possible and will stash the current changes of the working\r
  34                 copy to the top of the stack. <guimenuitem>Stash List</guimenuitem> provides an overview of all the whole stash stack. You\r
  35                 can also remove and view the stashed changes there (similarly to the <xref linkend="tsvn-dug-showlog"/> and <xref linkend="tsvn-dug-update"/>).\r
  36         </para>\r
  37         <para>\r
  38                 You can find more information at <xref linkend="git-stash(1)"/>\r
  39         </para>\r
  40 </sect1>\r