Log dialog can revert selected files to parent revision
[TortoiseGit.git] / doc / source / en / TortoiseGit / tsvn_dug / dug_revert.xml
blobf3f79e1f23161ac68919affbe52e6fbe774c2790
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
3 <sect1 id="tsvn-dug-revert">\r
4         <?dbhh topicname="HIDD_REVERT"?>\r
5         <title>Undo Changes</title>\r
6         <indexterm>\r
7                 <primary>revert</primary>\r
8         </indexterm>\r
9         <indexterm>\r
10                 <primary>undo</primary>\r
11         </indexterm>\r
12         <para>\r
13                 If you want to undo all changes you made in a file since\r
14                 the last update you need to select the file,\r
15                 <action>right click</action> to pop up the context menu and then select\r
16                 the command\r
17                 <menuchoice>\r
18                         <guimenu>TortoiseGit</guimenu>\r
19                         <guimenuitem>Revert</guimenuitem>\r
20                 </menuchoice>\r
21                 A dialog will pop up showing you the files that you've changed and\r
22                 can revert. Select those you want to revert and click on\r
23                 <guibutton>OK</guibutton>.\r
24                 <figure id="tsvn-dug-revert-dia-1">\r
25                         <title>Revert dialog</title>\r
26                         <graphic fileref="../images/Revert.png"/>\r
27                 </figure>\r
28         </para>\r
29         <para>\r
30                 If you want to undo a deletion or a rename, you need to use\r
31                 Revert on the parent folder as the deleted item does not\r
32                 exist for you to right-click on.\r
33         </para>\r
34         <para>\r
35                 If you want to undo the addition of an item, this appears in\r
36                 the context menu as\r
37                 <menuchoice>\r
38                         <guimenu>TortoiseGit</guimenu>\r
39                         <guimenuitem>Delete (keep local)</guimenuitem>\r
40                 </menuchoice>.\r
41                 This is really a revert as well, but the name has been changed\r
42                 to make it more obvious.\r
43         </para>\r
44         <para>\r
45                 The columns in this dialog can be customized in the same way as the\r
46                 columns in the <guilabel>Check for modifications</guilabel> dialog.\r
47                 Read <xref linkend="tsvn-dug-wcstatus-2"/> for further details.\r
48         </para>\r
49         <tip>\r
50                 <title>Undoing Changes which have been Committed</title>\r
51                 <para>\r
52                         <menuchoice>\r
53                                 <guimenuitem>Revert</guimenuitem>\r
54                         </menuchoice>\r
55                         will only undo your local changes. It does <emphasis>not</emphasis>\r
56                         undo any changes which have already been committed. If you want to\r
57                         undo all the changes which were committed in a particular revision,\r
58                         read <xref linkend="tsvn-dug-showlog"/> for further information.\r
59                 </para>\r
60         </tip>\r
61         <tip>\r
62                 <title>Revert is Slow</title>\r
63                 <para>\r
64                         When you revert changes you may find that the operation takes a lot\r
65                         longer than you expect. This is because the modified version of the\r
66                         file is sent to the recycle bin, so you can retrieve your changes\r
67                         if you reverted by mistake. However, if your recycle bin is full,\r
68                         Windows takes a long time to find a place to put the file. The\r
69                         solution is simple: either empty the recycle bin or deactivate\r
70                         the <guilabel>Use recycle bin when reverting</guilabel> box\r
71                         in TortoiseGit's settings.\r
72                 </para>\r
73         </tip>\r
74 </sect1>\r