| blob | fdeced7361a2b6f4f23b10fb0292f99530ced2ba |
1 <?xml version="1.0" encoding="UTF-8"?>\r
2 <!DOCTYPE sect1 SYSTEM "../../../dtd/dblite.dtd">\r
3 <sect1 id="tsvn-dug-repobrowser">\r
4 <title>The Repository Browser</title>\r
5 <indexterm>\r
6 <primary>repo-browser</primary>\r
7 </indexterm>\r
8 <indexterm>\r
9 <primary>server-side actions</primary>\r
10 </indexterm>\r
11 <indexterm>\r
12 <primary>copy</primary>\r
13 </indexterm>\r
14 <indexterm>\r
15 <primary>rename</primary>\r
16 </indexterm>\r
17 <indexterm>\r
18 <primary>server viewer</primary>\r
19 </indexterm>\r
20 <?dbhh topicname="HIDD_REPOSITORY_BROWSER"?>\r
21 <para>\r
22 Sometimes you need to work directly on the repository, without having\r
23 a working copy. That's what the <firstterm>Repository Browser</firstterm>\r
24 is for. Just as the explorer and the icon overlays allow you to view your\r
25 working copy, so the Repository Browser allows you to view the structure\r
26 and status of the repository.\r
27 <figure id="tsvn-dug-repobrowser-dia-1">\r
28 <title>The Repository Browser</title>\r
29 <graphic fileref="../images/Repobrowser.png"/>\r
30 </figure>\r
31 With the Repository Browser you can execute commands like copy, move,\r
32 rename, ... directly on the repository.\r
33 </para>\r
34 <para>\r
35 The repository browser looks very similar to the Windows explorer,\r
36 except that it is showing the content of the repository at a particular\r
37 revision rather than files on your computer. In the left pane you\r
38 can see a directory tree, and in the right pane are the contents\r
39 of the selected directory.\r
40 At the top of the Repository Browser Window you can enter the URL of\r
41 the repository and the revision you want to browse.\r
42 </para>\r
43 <para>\r
44 Just like Windows explorer, you can click on the column headings in\r
45 the right pane if you want to set the sort order. And as in explorer\r
46 there are context menus available in both panes.\r
47 </para>\r
48 <para>\r
49 The context menu for a file allows you to:\r
50 <itemizedlist>\r
51 <listitem>\r
52 <para>\r
53 Open the selected file, either with the default viewer for\r
54 that file type, or with a program you choose.\r
55 </para>\r
56 </listitem>\r
57 <listitem>\r
58 <para>\r
59 Save an unversioned copy of the file to your hard drive.\r
60 </para>\r
61 </listitem>\r
62 <listitem>\r
63 <para>\r
64 Show the revision log for that file, or show a graph of\r
65 all revisions so you can see where the file came from.\r
66 </para>\r
67 </listitem>\r
68 <listitem>\r
69 <para>\r
70 Blame the file, to see who changed which line and when.\r
71 </para>\r
72 </listitem>\r
73 <listitem>\r
74 <para>\r
75 Delete or rename the file.\r
76 </para>\r
77 </listitem>\r
78 <listitem>\r
79 <para>\r
80 Make a copy of the file, either to a different part of the\r
81 repository, or to a working copy rooted in the same repository.\r
82 </para>\r
83 </listitem>\r
84 <listitem>\r
85 <para>\r
86 View/Edit the file's properties.\r
87 </para>\r
88 </listitem>\r
89 </itemizedlist>\r
90 </para>\r
91 <para>\r
92 The context menu for a folder allows you to:\r
93 <itemizedlist>\r
94 <listitem>\r
95 <para>\r
96 Show the revision log for that folder, or show a graph of\r
97 all revisions so you can see where the folder came from.\r
98 </para>\r
99 </listitem>\r
100 <listitem>\r
101 <para>\r
102 Export the folder to a local unversioned copy on your hard drive.\r
103 </para>\r
104 </listitem>\r
105 <listitem>\r
106 <para>\r
107 Checkout the folder to produce a local working copy on your hard drive.\r
108 </para>\r
109 </listitem>\r
110 <listitem>\r
111 <para>\r
112 Create a new folder in the repository.\r
113 </para>\r
114 </listitem>\r
115 <listitem>\r
116 <para>\r
117 Add files or folders directly to the repository.\r
118 </para>\r
119 </listitem>\r
120 <listitem>\r
121 <para>\r
122 Delete or rename the folder.\r
123 </para>\r
124 </listitem>\r
125 <listitem>\r
126 <para>\r
127 Make a copy of the folder, either to a different part of the\r
128 repository, or to a working copy rooted in the same repository.\r
129 </para>\r
130 </listitem>\r
131 <listitem>\r
132 <para>\r
133 View/Edit the folder's properties.\r
134 </para>\r
135 </listitem>\r
136 <listitem>\r
137 <para>\r
138 Mark the folder for comparison. A marked folder is shown in bold.\r
139 </para>\r
140 </listitem>\r
141 <listitem>\r
142 <para>\r
143 Compare the folder with a previously marked folder, either as\r
144 a unified diff, or as a list of changed files which can then be\r
145 visually diffed using the default diff tool. This can be particularly\r
146 useful for comparing two tags, or trunk and branch to see what changed.\r
147 </para>\r
148 </listitem>\r
149 </itemizedlist>\r
150 </para>\r
151 <para>\r
152 If you select two folders in the right pane, you can view the differences\r
153 either as a unified-diff, or as a list of files which can be visually diffed\r
154 using the default diff tool.\r
155 </para>\r
156 <para>\r
157 If you select multiple folders in the right pane, you can checkout all\r
158 of them at once into a common parent folder.\r
159 </para>\r
160 <para>\r
161 If you select 2 tags which are copied from the same root\r
162 (typically <literal>/trunk/</literal>), you can use\r
163 <menuchoice>\r
164 <guimenu>Context Menu</guimenu>\r
165 <guimenuitem>Show Log...</guimenuitem>\r
166 </menuchoice>\r
167 to view the list of revisions between the two tag points.\r
168 </para>\r
169 <para>\r
170 You can use <keycap>F5</keycap> to refresh the view as usual. This will\r
171 refresh everything which is currently displayed. If you want to pre-fetch\r
172 or refresh the information for nodes which have not been opened yet, use\r
173 <keycap>Ctrl-F5</keycap>. After that, expanding any node will happen\r
174 instantly without a network delay while the information is fetched.\r
175 </para>\r
176 <para>\r
177 You can also use the repository browser for drag-and-drop operations.\r
178 If you drag a folder from explorer into the repo-browser, it will be\r
179 imported into the repository. Note that if you drag multiple items,\r
180 they will be imported in separate commits.\r
181 </para>\r
182 <para>\r
183 If you want to move an item within the repository, just <action>left drag</action>\r
184 it to the new location. If you want to create a copy rather than moving the item,\r
185 <keycap>Ctrl</keycap>-<action>left drag</action> instead. When copying, the cursor has a\r
186 <quote>plus</quote> symbol on it, just as it does in Explorer.\r
187 </para>\r
188 <para>\r
189 If you want to copy/move a file or folder to another location and also\r
190 give it a new name at the same time, you can <action>right drag</action>\r
191 or <keycap>Ctrl</keycap>-<action>right drag</action> the item instead of using\r
192 <action>left drag</action>. In that case, a rename dialog\r
193 is shown where you can enter a new name for the file or folder.\r
194 </para>\r
195 <para>\r
196 Whenever you make changes in the repository using one of these methods,\r
197 you will be presented with a log message entry dialog. If you dragged\r
198 something by mistake, this is also your chance to cancel the action.\r
199 </para>\r
200 <para>\r
201 Sometimes when you try to open a path you will get an error message\r
202 in place of the item details. This might happen if you specified an\r
203 invalid URL, or if you don't have access permission, or if there is\r
204 some other server problem. If you need to copy this message to include\r
205 it in an email, just right click on it and use\r
206 <menuchoice>\r
207 <guimenu>Context Menu</guimenu>\r
208 <guimenuitem>Copy error message to clipboard</guimenuitem>\r
209 </menuchoice>,\r
210 or simply use <keycap>Ctrl+C</keycap>.\r
211 </para>\r
212 </sect1>\r