platform-vcm-home/docs/online/cvs_features2.0/cvs-faq.html
Parent Directory
| 
Revision Log
Revision 1.55 - (view) (download) (as text)
| 1 : | jlemieux | 1.44 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| 2 : | jlemieux | 1.48 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> |
| 3 : | jlemieux | 1.44 | <head> |
| 4 : | jlemieux | 1.48 | <meta content="application/xhtml+xml; charset=utf-8" |
| 5 : | mvalenta | 1.54 | http-equiv="content-type" /> |
| 6 : | <meta content="haran" name="author" /> | ||
| 7 : | <meta content="Windows Notepad" name="generator" /> | ||
| 8 : | jlemieux | 1.48 | <link type="text/css" href="http://dev.eclipse.org/default_style.css" |
| 9 : | mvalenta | 1.54 | rel="stylesheet" /> |
| 10 : | jlemieux | 1.48 | <link title="Grey boxes stylesheet" |
| 11 : | jlemieux | 1.44 | href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-vcm-home/layout.css" |
| 12 : | mvalenta | 1.54 | type="text/css" rel="stylesheet" /> |
| 13 : | jlemieux | 1.48 | <link |
| 14 : | href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-vcm-home/colors.css" | ||
| 15 : | mvalenta | 1.54 | type="text/css" rel="stylesheet" /> |
| 16 : | mvalenta | 1.49 | <title>Eclipse Platform - CVS FAQ</title> |
| 17 : | jlemieux | 1.44 | </head> |
| 18 : | <body> | ||
| 19 : | jlemieux | 1.48 | <table width="100%" cellpadding="2" cellspacing="5" border="0"> |
| 20 : | jlemieux | 1.44 | <tbody> |
| 21 : | <tr> | ||
| 22 : | mvalenta | 1.54 | <td width="72%" align="left"> <font class="indextop"> CVS</font><br /> |
| 23 : | jlemieux | 1.44 | <font class="indexsub">platform cvs support</font></td> |
| 24 : | jlemieux | 1.48 | <td width="28%"><img width="120" height="86" |
| 25 : | mvalenta | 1.54 | src="http://dev.eclipse.org/images/Idea.jpg" /></td> |
| 26 : | jlemieux | 1.44 | </tr> |
| 27 : | </tbody> | ||
| 28 : | </table> | ||
| 29 : | jlemieux | 1.41 | <h1>CVS Eclipse Plug-in FAQ</h1> |
| 30 : | mvalenta | 1.55 | <p>Last Modified: $Date: 2005/04/20 18:14:14 $</p> |
| 31 : | james | 1.1 | <ul> |
| 32 : | jlemieux | 1.44 | <li><b><a href="#gettingStarted">Getting started</a></b> |
| 33 : | jlemieux | 1.36 | <ol> |
| 34 : | jlemieux | 1.44 | <li><a href="#gettingStarted_1">How do I get a project into my |
| 35 : | workspace from CVS?</a></li> | ||
| 36 : | <li><a href="#gettingStarted_2">How do I put a project into CVS | ||
| 37 : | from my workspace?</a></li> | ||
| 38 : | <li><a href="#gettingStarted_3">I already have a project checked | ||
| 39 : | out from CVS with the command-line tool. How do I use it in Eclipse | ||
| 40 : | without having to check out the whole project again?</a></li> | ||
| 41 : | jlemieux | 1.36 | </ol> |
| 42 : | </li> | ||
| 43 : | jlemieux | 1.44 | <li><b><a href="#browsing">Browsing the Repository</a></b> |
| 44 : | jlemieux | 1.36 | <ol> |
| 45 : | jlemieux | 1.44 | <li><a href="#browsing_1">Why don't my branches and versions show |
| 46 : | up when I am browsing?</a></li> | ||
| 47 : | <li><a href="#browsing_2">Why do some modules defined in | ||
| 48 : | CVSROOT/modules appear empty in the CVS Repositories view?</a></li> | ||
| 49 : | <li><a href="#browsing_3">When I expand HEAD in the CVS | ||
| 50 : | Repositories View, it is always empty even though I know the repository | ||
| 51 : | has contents. Whats wrong?</a></li> | ||
| 52 : | jlemieux | 1.36 | </ol> |
| 53 : | </li> | ||
| 54 : | jlemieux | 1.44 | <li><b><a href="#server">Server Issues</a></b> |
| 55 : | kevinm | 1.15 | <ol> |
| 56 : | jlemieux | 1.44 | <li><a href="#server_1">What server versions of CVS are supported |
| 57 : | by Eclipse?</a></li> | ||
| 58 : | <li><a href="#server_1a">Why doesn't Eclipse 2.1.x work with CVS | ||
| 59 : | server versions 1.11.7 and beyond?</a></li> | ||
| 60 : | kevinm | 1.15 | <li><a href="#server_cvsnt">Why isn't CVSNT supported?</a></li> |
| 61 : | <li><a href="#server_2">Where can I get CVS for UNIX or Windows?</a></li> | ||
| 62 : | <li><a href="#server_3">Where can I find documentation on CVS?</a></li> | ||
| 63 : | jlemieux | 1.44 | <li><a href="#server_4">I'm having problems running CVSNT |
| 64 : | 1.11.1.1 on Windows 2000, what's wrong?</a></li> | ||
| 65 : | <li><a href="#server_5">I use logical repository mapping under | ||
| 66 : | CVSNT 1.11.1.3, but Eclipse complains. What's wrong?</a></li> | ||
| 67 : | <li><a href="#server_6">When I perform a Replace With or Update | ||
| 68 : | operation, Eclipse tells me that option -C is not supported. What's | ||
| 69 : | wrong?</a></li> | ||
| 70 : | <li><a href="#server_7">I performed a Replace With or Override | ||
| 71 : | and Update and one of the files involved ended up with strange | ||
| 72 : | characters in it. Why?</a></li> | ||
| 73 : | <li><a href="#server_8">I got a "received broken pipe signal" | ||
| 74 : | error. What does it mean?</a></li> | ||
| 75 : | <li><a href="#server_9">How do I use a local connection with | ||
| 76 : | Eclipse?</a></li> | ||
| 77 : | <li><a href="#server_10">When using CVSNT, why do I get the error | ||
| 78 : | "Error fetching file revisions" when synchronizing?</a></li> | ||
| 79 : | <li><a href="#server_11">Why can't I get Eclipse to work with | ||
| 80 : | CVSNT and mapped network drives?</a></li> | ||
| 81 : | <li><a href="#server_12">Using CVSNT, Why do I get the error "cvs | ||
| 82 : | [server aborted]: cannot find .: No such file or directory"?</a></li> | ||
| 83 : | <li><a href="#server_13">My server has been configured to use an | ||
| 84 : | alternate server name. What do I need to do?</a></li> | ||
| 85 : | jlemieux | 1.36 | </ol> |
| 86 : | </li> | ||
| 87 : | jlemieux | 1.44 | <li><b><a href="#ssh">Using SSH with CVS</a></b> |
| 88 : | jlemieux | 1.36 | <ol> |
| 89 : | jlemieux | 1.44 | <li><a href="#ssh_1">How do I use SSH to communicate with the |
| 90 : | server?</a></li> | ||
| 91 : | <li><a href="#ssh_2">What is the difference between ext and | ||
| 92 : | extssh?</a></li> | ||
| 93 : | mvalenta | 1.53 | <li><a href="#ssh_jcraft">My SSH server only support SSH2 protocol and |
| 94 : | I'm using Eclipse 2.1.x</a></li> | ||
| 95 : | <li><a href="#ssh_3">How do I set up public-key authentication for use with | ||
| 96 : | an external SSH client?</a></li> | ||
| 97 : | jlemieux | 1.44 | <li><a href="#ssh_4">When I try to connect using SSH, it tells me |
| 98 : | "Could not chdir to home directory /home/user/myname". What did I do | ||
| 99 : | wrong?</a></li> | ||
| 100 : | <li><a href="#ssh_5">I got an 'Unknown response' while trying to | ||
| 101 : | perform CVS browsing. What went wrong?</a></li> | ||
| 102 : | mvalenta | 1.53 | <li><a href="#ssh_6">I can't get keys generated using Putty to work with Eclipse</a></li> |
| 103 : | jlemieux | 1.44 | </ol> |
| 104 : | </li> | ||
| 105 : | <li><b><a href="#10">Upgrading from Eclipse 1.0</a></b> | ||
| 106 : | <ol> | ||
| 107 : | <li><a href="#10_1">Is there anything I should do before | ||
| 108 : | upgrading from Eclipse 1.0 to 2.0?</a></li> | ||
| 109 : | <li><a href="#10_2">I'm using a workspace from 1.0. Why does the | ||
| 110 : | Team menu only contain "Share Project"?</a></li> | ||
| 111 : | <li><a href="#10_3">Eclipse 1.0 created all my files as binary in | ||
| 112 : | the repository. How do I fix this?</a></li> | ||
| 113 : | <li><a href="#10_4">Is a Branch the same as a Stream? What about | ||
| 114 : | other 1.0 terminology?</a></li> | ||
| 115 : | <li><a href="#10_5">I get a message saying the .vcm_meta file is | ||
| 116 : | obsolete and should be deleted. Should I really delete it?</a></li> | ||
| 117 : | </ol> | ||
| 118 : | </li> | ||
| 119 : | <li><b><a href="#java">Using Eclipse and CVS for Java development</a></b> | ||
| 120 : | <ol> | ||
| 121 : | <li><a href="#java_1">When I check out a Java project from the | ||
| 122 : | repository, how do I make Eclipse aware it is a Java project?</a></li> | ||
| 123 : | <li><a href="#java_2">What is the .classpath file? Should I | ||
| 124 : | release it to the repository?</a></li> | ||
| 125 : | <li><a href="#java_3">In my CVS repository, there is a source | ||
| 126 : | directory in the repository root. How can I use this with Eclipse?</a></li> | ||
| 127 : | <li><a href="#java_4">How do I check out a module definition as a | ||
| 128 : | Java project</a></li> | ||
| 129 : | <li><a href="#java_5">Why does the bin directory keep appearing | ||
| 130 : | in the Synchronize view?</a></li> | ||
| 131 : | <li><a href="#java_5a">I ignored the bin directory but it appears | ||
| 132 : | to be shared anyway. Why?</a></li> | ||
| 133 : | jlemieux | 1.36 | <li><a href="#java_6">How do I use CVS keywords in Java templates?</a></li> |
| 134 : | jlemieux | 1.44 | <li><a href="#java_7">I'm working with a virtual module defined |
| 135 : | in the CVSROOT/modules file. How do I commit the .project and/or | ||
| 136 : | .classpath file?</a></li> | ||
| 137 : | jlemieux | 1.36 | </ol> |
| 138 : | </li> | ||
| 139 : | jlemieux | 1.44 | <li><b><a href="#commandLine">Compatibility Between CVS command-line |
| 140 : | client and Eclipse</a></b> | ||
| 141 : | jlemieux | 1.36 | <ol> |
| 142 : | jlemieux | 1.44 | <li><a href="#commandLine_1">Does Eclipse use [WinCVS|CVS |
| 143 : | command-line client] to talk to the server?</a></li> | ||
| 144 : | <li><a href="#commandLine_2">The command-line CVS client stores | ||
| 145 : | information in CVS folders. Does Eclipse do the same thing? If so, | ||
| 146 : | where are the folders?</a></li> | ||
| 147 : | <li><a href="#commandLine_3">Is Eclipse compatible with the | ||
| 148 : | command-line CVS client?</a></li> | ||
| 149 : | <li><a href="#commandLine_4">Can I import a project into Eclipse | ||
| 150 : | that was checked out using the command line?</a></li> | ||
| 151 : | <li><a href="#commandLine_5">Why does Eclipse corrupt my *.jar, | ||
| 152 : | *.zip, etc. files?</a></li> | ||
| 153 : | <li><a href="#commandLine_6">When I use the command-line CVS on | ||
| 154 : | my project, why do the CVS folders sometimes appear in the Navigator | ||
| 155 : | View?</a></li> | ||
| 156 : | <li><a href="#commandLine_7">When I use the command-line CVS on | ||
| 157 : | my project, why go I get "resource out of sync" errors?</a></li> | ||
| 158 : | jlemieux | 1.36 | </ol> |
| 159 : | </li> | ||
| 160 : | jlemieux | 1.44 | <li><b><a href="#patches">Working with Patches</a></b> |
| 161 : | jlemieux | 1.36 | <ol> |
| 162 : | <li><a href="#patches_1">How do I send someone a patch?</a></li> | ||
| 163 : | jlemieux | 1.44 | <li><a href="#patches_2">How do I apply a patch that someone sent |
| 164 : | me?</a></li> | ||
| 165 : | jlemieux | 1.36 | </ol> |
| 166 : | </li> | ||
| 167 : | jlemieux | 1.44 | <li><b><a href="#linux">Linux Issues</a></b> |
| 168 : | jlemieux | 1.36 | <ol> |
| 169 : | jlemieux | 1.44 | <li><a href="#linux_0">On linux, using IBM JRE 1.3.0, I get a |
| 170 : | timeout when connecting to a repository. What's wrong?</a></li> | ||
| 171 : | <li><a href="#linux_1">On Red Hat 8, Eclipse fails to make a | ||
| 172 : | checkout but it works with other clients. Why?</a></li> | ||
| 173 : | jlemieux | 1.36 | </ol> |
| 174 : | </li> | ||
| 175 : | jlemieux | 1.44 | <li><b><a href="#windows">Windows Issues</a></b> |
| 176 : | jlemieux | 1.36 | <ol> |
| 177 : | jlemieux | 1.44 | <li><a href="#windows_0">Eclipse crashed Windows 2000 (blue |
| 178 : | screen) when performing a CVS operation. What happened?</a></li> | ||
| 179 : | <li><a href="#windows_2">Eclipse always times out when performing | ||
| 180 : | a Synchronize on one or two particular machines?</a></li> | ||
| 181 : | <li><a href="#windows_3">Why do CVS operations slow down when I | ||
| 182 : | am connected to my network/dial-up?</a></li> | ||
| 183 : | <li><a href="#windows_4">Why do all my files show as outgoing | ||
| 184 : | changes?</a></li> | ||
| 185 : | jlemieux | 1.36 | </ol> |
| 186 : | </li> | ||
| 187 : | jlemieux | 1.44 | <li><b><a href="#misc">Miscellaneous</a></b> |
| 188 : | jlemieux | 1.36 | <ol> |
| 189 : | jlemieux | 1.44 | <li><a href="#misc_0">Is there any equivalent to CVS_CLIENT_LOG |
| 190 : | is Eclipse?</a></li> | ||
| 191 : | <li><a href="#misc_1">What is the .project file, and should I | ||
| 192 : | release it to CVS?</a></li> | ||
| 193 : | <li><a href="#misc_2">I don't have update access to the CVS | ||
| 194 : | repository. Can I still check out a project with Eclipse?</a></li> | ||
| 195 : | <li><a href="#misc_3">What does "Terminated with fatal signal 10" | ||
| 196 : | mean?</a></li> | ||
| 197 : | <li><a href="#misc_4">I copied some folders from one CVS project | ||
| 198 : | to another and the old CVS information remained. What happened?</a></li> | ||
| 199 : | <li><a href="#misc_8">I used Team > Share Project to connect a | ||
| 200 : | local project to an existing project and it takes forwever. Why?</a></li> | ||
| 201 : | jlemieux | 1.36 | <li><a href="#misc_9">Does Eclipse support Watch/Edit?</a></li> |
| 202 : | jlemieux | 1.44 | <li><a href="#misc_12">Why do I get a "Pre-commit failed" error |
| 203 : | with no detailed error message?</a></li> | ||
| 204 : | kevinm | 1.15 | </ol> |
| 205 : | jlemieux | 1.36 | </li> |
| 206 : | james | 1.1 | </ul> |
| 207 : | <!-- End of table of contents --> | ||
| 208 : | <!-- Getting Started --> | ||
| 209 : | jlemieux | 1.42 | <h1>Getting Started</h1> |
| 210 : | james | 1.1 | <ol> |
| 211 : | jlemieux | 1.44 | <li><b><a name="gettingStarted_1">How do I get a project into my |
| 212 : | workspace from CVS?</a></b> | ||
| 213 : | <p> </p> | ||
| 214 : | <ol> | ||
| 215 : | <li>Window->Show View->Other. Select CVS->CVS | ||
| 216 : | Repositories.</li> | ||
| 217 : | <li>Context Menu->New->Repository Location...</li> | ||
| 218 : | <li>Fill in the location information identifying your repository | ||
| 219 : | and click Finish.</li> | ||
| 220 : | <li>Expand the newly-created repository location.</li> | ||
| 221 : | <li>Expand HEAD.</li> | ||
| 222 : | <li>Find the module you are interested in.</li> | ||
| 223 : | <li>Context Menu->Check Out As Project.</li> | ||
| 224 : | </ol> | ||
| 225 : | mvalenta | 1.54 | <br /> |
| 226 : | jlemieux | 1.44 | The project now exists in your workspace. </li> |
| 227 : | mvalenta | 1.54 | <p> <br /> |
| 228 : | jlemieux | 1.44 | </p> |
| 229 : | <li><b><a name="gettingStarted_2">How do I put a project into CVS | ||
| 230 : | from my workspace?</a></b> | ||
| 231 : | <p> </p> | ||
| 232 : | <ol> | ||
| 233 : | <li>Select the project in the Navigator or other view.</li> | ||
| 234 : | <li>Context Menu->Team->Share Project...</li> | ||
| 235 : | <li>Fill in the location information identifying your repository | ||
| 236 : | and click Finish.</li> | ||
| 237 : | <li>The Synchronize view opens, showing all your outgoing changes.</li> | ||
| 238 : | <li>Select the project in the Synchronize view.</li> | ||
| 239 : | <li>Context Menu->Commit.</li> | ||
| 240 : | <li>Answer yes when prompted to add new files to version control.</li> | ||
| 241 : | <li>Supply a release comment if you like.</li> | ||
| 242 : | </ol> | ||
| 243 : | mvalenta | 1.54 | <br /> |
| 244 : | jlemieux | 1.44 | The project now exists in the repository. </li> |
| 245 : | mvalenta | 1.54 | <p> <br /> |
| 246 : | jlemieux | 1.44 | </p> |
| 247 : | <li><b><a name="gettingStarted_3">I already have a project checked | ||
| 248 : | out from CVS with the command-line tool. How do I use it in Eclipse | ||
| 249 : | without having to check out the whole project again?</a></b> | ||
| 250 : | <p> </p> | ||
| 251 : | <ol> | ||
| 252 : | <li>Create a project in the workspace.</li> | ||
| 253 : | <li>File->Import, select File System, locate your files, click | ||
| 254 : | Finish.</li> | ||
| 255 : | <li>Select the project in the Navigator or other view.</li> | ||
| 256 : | <li>Context Menu->Team->Share Project...</li> | ||
| 257 : | <li>The wizard should tell you that it found all the necessary | ||
| 258 : | information. Click Finish.</li> | ||
| 259 : | </ol> | ||
| 260 : | mvalenta | 1.54 | <br /> |
| 261 : | jlemieux | 1.44 | Eclipse has now shared the project with the CVS repository. </li> |
| 262 : | <p> </p> | ||
| 263 : | james | 1.1 | </ol> |
| 264 : | mvalenta | 1.54 | <br /> |
| 265 : | james | 1.1 | <!-- Browsing the Repository --> |
| 266 : | jlemieux | 1.42 | <h1>Browsing the Repository</h1> |
| 267 : | james | 1.1 | <ol> |
| 268 : | jlemieux | 1.44 | <li><b><a name="browsing_1">Why don't my branches and versions show |
| 269 : | up when I am browsing?</a></b> | ||
| 270 : | <p> </p> | ||
| 271 : | <p>When you are browsing in the CVS Repositories view, you may | ||
| 272 : | expect to see branch and version tags which you have previously | ||
| 273 : | created. In CVS, such tags are stored on individual files rather than | ||
| 274 : | on projects or folders. Rather than scan every file in the repository, | ||
| 275 : | Eclipse only scans one well-known file, .project, which should exist in | ||
| 276 : | every Eclipse project. It is possible that you have other interesting | ||
| 277 : | tags that do not appear on .project but which you would like to show up | ||
| 278 : | in the CVS Repositories view.</p> | ||
| 279 : | <p> </p> | ||
| 280 : | <p>To make these tags appear, do the following:</p> | ||
| 281 : | <ol> | ||
| 282 : | <li>Open the CVS Repositories view.</li> | ||
| 283 : | <li>Expand HEAD and select the project for which you want to | ||
| 284 : | configure tags.</li> | ||
| 285 : | <li>Context Menu->Configure Branches and Versions...</li> | ||
| 286 : | <li>In the "Browse files for tags" table, select one or more | ||
| 287 : | files that contain tags you would like to see.</li> | ||
| 288 : | <li>Click "Add Selected Tags".</li> | ||
| 289 : | <li>Click "OK".</li> | ||
| 290 : | </ol> | ||
| 291 : | mvalenta | 1.54 | <br /> |
| 292 : | jlemieux | 1.44 | The CVS Repositories view will now display the chosen tags under the |
| 293 : | Branches and Versions categories. In addition, these tags will show up | ||
| 294 : | in other tag-related operations, such as "Replace With->Branch or | ||
| 295 : | Version...". </li> | ||
| 296 : | <p> </p> | ||
| 297 : | <li><b><a name="browsing_2">Why do some modules defined in | ||
| 298 : | CVSROOT/modules appear empty in the CVS Repositories view?</a></b> | ||
| 299 : | <p> </p> | ||
| 300 : | <p>Some modules are not expandable because their definition is | ||
| 301 : | complex and difficult to parse on the client. These modules can still | ||
| 302 : | be checked out properly using the "Check Out Module" menu command from | ||
| 303 : | the module's context menu. </p> | ||
| 304 : | </li> | ||
| 305 : | <p> </p> | ||
| 306 : | <li><b><a name="browsing_3">When I expand HEAD in the CVS | ||
| 307 : | Repositories View, it is always empty even though I know the repository | ||
| 308 : | has contents. Whats wrong?</a></b> | ||
| 309 : | <p> </p> | ||
| 310 : | <p>If you also see messages from the server like "-f server: ...", | ||
| 311 : | this indicates that your CVS server has not been configured properly. | ||
| 312 : | Here is the line as it should appear in the "/etc/inetd.conf" file | ||
| 313 : | (example from AIX but the problem has also been seen on Solaris):</p> | ||
| 314 : | <ul> | ||
| 315 : | <li>cvspserver stream tcp nowait root /usr/bin/cvs cvs -f | ||
| 316 : | --allow-root=/usr/cvsroot pserver</li> | ||
| 317 : | </ul> | ||
| 318 : | <p>The key is the 2nd copy of "cvs". The online cvs book at <a | ||
| 319 : | href="http://cvsbook.red-bean.com/cvsbook.html#The_pserver_access_method_is_not_working"> | ||
| 320 : | mvalenta | 1.28 | http://cvsbook.red-bean.com/cvsbook.html</a> |
| 321 : | jlemieux | 1.44 | has it right (although I thought it was a typo so never tried it). Look |
| 322 : | for "The pserver access method is not working" section. Part of the | ||
| 323 : | reason I got this wrong is that the linux xinetd configuration | ||
| 324 : | does not duplicate the name of the program. At one point I | ||
| 325 : | mvalenta | 1.28 | just copied the fields from the linux config into the fields in the AIX |
| 326 : | jlemieux | 1.44 | inetd.conf file. Now that I know what to look for, the other entries in |
| 327 : | the inetd.conf file | ||
| 328 : | mvalenta | 1.28 | have the program name duplicated.</p> |
| 329 : | jlemieux | 1.44 | </li> |
| 330 : | <p> </p> | ||
| 331 : | james | 1.1 | </ol> |
| 332 : | mvalenta | 1.54 | <br /> |
| 333 : | kevinm | 1.16 | <!-- Server Issues --> |
| 334 : | jlemieux | 1.43 | <h1>Server Issues</h1> |
| 335 : | james | 1.1 | <ol> |
| 336 : | jlemieux | 1.48 | <li><b><a name="server_1">What server versions of CVS are supported |
| 337 : | by Eclipse?</a></b> | ||
| 338 : | jlemieux | 1.44 | <p> </p> |
| 339 : | jlemieux | 1.48 | <p>In 3.0, Eclipse supports CVS version 1.11.1p1 or higher, running |
| 340 : | mvalenta | 1.49 | on a Linux or UNIX server and CVSNT 2.0.58d or later, when properly |
| 341 : | <a href="../html-cvs/cvs-compatibility.html">configured</a>. Eclipse 2.1.2 and before does not work with | ||
| 342 : | jlemieux | 1.48 | CVS versions greater than 1.11.6 (see <a href="#server_1a">next point</a>). |
| 343 : | mvalenta | 1.49 | CVSNT versions prior to 2.0.58d are not supported but some versions have been reported to |
| 344 : | work with few problems. | ||
| 345 : | There have also been some | ||
| 346 : | jlemieux | 1.48 | problems reported with HPUX and Solaris version (see <a |
| 347 : | jlemieux | 1.44 | href="#browsing_3">above</a>). </p> |
| 348 : | mvalenta | 1.55 | <p>There are also cases where newer server versions are required for some |
| 349 : | funtionality. For instance, incoming change sets in the synchronize view | ||
| 350 : | require CVS version 1.11.5 or beyond to work properly (see bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=81960">https://bugs.eclipse.org/bugs/show_bug.cgi?id=81960</a>)</p> | ||
| 351 : | jlemieux | 1.44 | </li> |
| 352 : | jlemieux | 1.48 | <li><b><a name="server_1a">Why doesn't Eclipse 2.1.x work with CVS |
| 353 : | server versions 1.11.7 and beyond?</a></b> | ||
| 354 : | jlemieux | 1.44 | <p> </p> |
| 355 : | jlemieux | 1.48 | <p>Most of the interesting Eclipse CVS functionality relies on the |
| 356 : | format of the messages and the change in format made in 1.11.7 breaks | ||
| 357 : | the parsing in Eclipse versions proir to 2.1.3. Most of the | ||
| 358 : | incompatibilities for 1.11.x were adressed in 2.1.3. See bugs <a | ||
| 359 : | href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=46655">46655</a> | ||
| 360 : | and <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=49056">49056</a> | ||
| 361 : | for patches and workarounds for previous versions of Eclipse or | ||
| 362 : | remaining incompatibilities. As for 1.12.x releases of CVS, Eclipse | ||
| 363 : | 2.1.x is not compatible with this server version. Eclipse 3.0 is | ||
| 364 : | compatible with 1.12.7 but future releases of CVS may cause similar | ||
| 365 : | breakages. In such cases, Team>Update and Team>Commit should | ||
| 366 : | still work but the more advanced workflows (e.g. synchronizing) may not | ||
| 367 : | be reliable.</p> | ||
| 368 : | </li> | ||
| 369 : | mvalenta | 1.49 | <li><b><a name="server_cvsnt">Why aren't older (pre 2.0.58d) CVSNT versions supported?</a></b> |
| 370 : | <p>The reason older CVSNT versions aren't supported is because traditionally its | ||
| 371 : | development effort had been smaller and has lagged behind that of CVS | ||
| 372 : | Linux, thus its quality tends to be of issue. That has changed as of version 2.0.58d | ||
| 373 : | which is now supported (when properly | ||
| 374 : | <a href="../html-cvs/cvs-compatibility.html">configured</a>) on Eclipse 3.0 and beyond.</p> | ||
| 375 : | mvalenta | 1.47 | </li> |
| 376 : | jlemieux | 1.48 | <li><b><a name="server_2">Where can I get CVS for UNIX or Windows?</a></b> |
| 377 : | jlemieux | 1.44 | <p> </p> |
| 378 : | <p>CVS for UNIX can be downloaded from <a | ||
| 379 : | jlemieux | 1.48 | href="http://www.cvshome.org">http://www.cvshome.org</a>. CVSNT can be |
| 380 : | downloaded from <a href="http://www.cvsnt.org">http://www.cvsnt.org</a>.</p> | ||
| 381 : | jlemieux | 1.44 | </li> |
| 382 : | <p> </p> | ||
| 383 : | jlemieux | 1.48 | <li><b><a name="server_3">Where can I find documentation on CVS?</a></b> |
| 384 : | jlemieux | 1.44 | <p> </p> |
| 385 : | <p>The CVS manual can be browsed online at <a | ||
| 386 : | jlemieux | 1.48 | href="http://www.cvshome.org/docs/manual/">http://www.cvshome.org/docs/manual/</a>. |
| 387 : | The CVS FAQ-O-Matic can be found at <a | ||
| 388 : | jlemieux | 1.44 | href="http://ccvs.cvshome.org/fom/fom.cgi">http://ccvs.cvshome.org/fom/fom.cgi</a>.</p> |
| 389 : | </li> | ||
| 390 : | <p> </p> | ||
| 391 : | jlemieux | 1.48 | <li><b><a name="server_4">I'm having problems running CVSNT 1.11.1.1 |
| 392 : | on Windows 2000, what's wrong?</a></b> | ||
| 393 : | jlemieux | 1.44 | <p> </p> |
| 394 : | jlemieux | 1.48 | <p>We have reports that CVSNT 1.11.1.1 (and perhaps later versions) |
| 395 : | will not run on Windows 2000 unless Service Pack 2 or later is | ||
| 396 : | installed.</p> | ||
| 397 : | jlemieux | 1.44 | </li> |
| 398 : | <p> </p> | ||
| 399 : | jlemieux | 1.48 | <li><b><a name="server_5">I use logical repository mapping under |
| 400 : | CVSNT 1.11.1.3, but Eclipse complains. What's wrong?</a></b> | ||
| 401 : | jlemieux | 1.44 | <p> </p> |
| 402 : | jlemieux | 1.48 | <p>You have set up relative mapping (repository prefix) under |
| 403 : | CVSNT, so that, for example, "D:\cvs\repo" maps to "/REPO". That means | ||
| 404 : | you should be able to use ":pserver:user@host:/REPO". However, CVSNT | ||
| 405 : | does not always communicate these paths to the client properly; in | ||
| 406 : | particular, Eclipse needs information for synchronization which is not | ||
| 407 : | included in this mode of operation. The solution is to change your | ||
| 408 : | CVSNT server settings to disable the use of a repository prefix, and | ||
| 409 : | use the full path of the repository, thus: | ||
| 410 : | ":pserver:user@host:D:\cvs\repo".</p> | ||
| 411 : | jlemieux | 1.44 | </li> |
| 412 : | <p> </p> | ||
| 413 : | jlemieux | 1.48 | <li><b><a name="server_6">When I perform a Replace With or Update |
| 414 : | operation, Eclipse tells me that option -C is not supported. What's | ||
| 415 : | wrong?</a></b> | ||
| 416 : | jlemieux | 1.44 | <p> </p> |
| 417 : | jlemieux | 1.48 | <p>This error indicates that your server version is CVS 1.10 or |
| 418 : | before. The -C option was introduced in version 1.11. See <a | ||
| 419 : | jlemieux | 1.44 | href="#server_1">above</a> for supported CVS versions.</p> |
| 420 : | </li> | ||
| 421 : | <p> </p> | ||
| 422 : | jlemieux | 1.48 | <li><b><a name="server_7">I performed a Replace With or Override and |
| 423 : | Update and one of the files involved ended up with strange characters | ||
| 424 : | in it. Why?</a></b> | ||
| 425 : | jlemieux | 1.44 | <p> </p> |
| 426 : | jlemieux | 1.48 | <p>This error indicates that your server version is CVS 1.11 which |
| 427 : | has a bug when replacing a locally dirty file. See <a href="#server_1">above</a> | ||
| 428 : | for supported CVS versions.</p> | ||
| 429 : | jlemieux | 1.44 | </li> |
| 430 : | <p> </p> | ||
| 431 : | jlemieux | 1.48 | <li><b><a name="server_8">I got a "received broken pipe signal" |
| 432 : | error. What does it mean?</a></b> | ||
| 433 : | jlemieux | 1.44 | <p> </p> |
| 434 : | jlemieux | 1.48 | <p>Eclipse sometime performs multiple commands within a single |
| 435 : | connection to the server. This may cause problems with CVS server that | ||
| 436 : | are running server scripts in reponse to certain commands.</p> | ||
| 437 : | jlemieux | 1.44 | </li> |
| 438 : | <p> </p> | ||
| 439 : | jlemieux | 1.48 | <li><b><a name="server_9">How do I use a local connection with |
| 440 : | Eclipse?</a></b> | ||
| 441 : | jlemieux | 1.44 | <p> </p> |
| 442 : | jlemieux | 1.48 | <p>Eclipse does not support the use of the local connection method |
| 443 : | as this requires a CVS client that also includes the CVS server code in | ||
| 444 : | it. Command line cvs uses the same executable for the client and the | ||
| 445 : | server whereas Eclipse is a client only. Since the repository is on the | ||
| 446 : | same machine as the client, you should be able to use pserver.</p> | ||
| 447 : | jlemieux | 1.44 | </li> |
| 448 : | <p> </p> | ||
| 449 : | jlemieux | 1.48 | <li><b><a name="server_10">When using CVSNT, why do I get the error |
| 450 : | "Error fetching file revisions" when synchronizing?</a></b> | ||
| 451 : | jlemieux | 1.44 | <p> </p> |
| 452 : | jlemieux | 1.48 | <p>This error, or an error stating that "An error has occurred |
| 453 : | processing file <repo file> <revision>", occur when the | ||
| 454 : | CVSNT server has been configured to use a repository prefix (also | ||
| 455 : | referred to as a repository alias). CVSNT provides this mechanism to | ||
| 456 : | allow compatibility with the Unix/Linux based command line tools. | ||
| 457 : | However, the CVSNT server does not properly map the repository paths | ||
| 458 : | that are communicated in text messages. The Eclipse CVS client relies | ||
| 459 : | on these text messages to provide advanced features such as | ||
| 460 : | synchronization and compare. In order for these features to work | ||
| 461 : | properly, the CVSNT server must not be configured to use a repository | ||
| 462 : | prefix. Instead, the full path name (i.e. D:\cvs\root) must be used | ||
| 463 : | (see related question <a href="#server_5">above</a>). </p> | ||
| 464 : | jlemieux | 1.44 | </li> |
| 465 : | <p> </p> | ||
| 466 : | jlemieux | 1.48 | <li><b><a name="server_11">Why can't I get Eclipse to work with CVSNT |
| 467 : | and mapped network drives?</a></b> | ||
| 468 : | jlemieux | 1.44 | <p> </p> |
| 469 : | jlemieux | 1.48 | <p>The problem is that CVSNT (as of 1.11.1.3) only supports using |
| 470 : | the local connection method with network drives and Eclipse does not | ||
| 471 : | support this connection method (see <a href="#server_9">above</a>). </p> | ||
| 472 : | jlemieux | 1.44 | </li> |
| 473 : | <p> </p> | ||
| 474 : | jlemieux | 1.48 | <li><b><a name="server_12">Using CVSNT, Why do I get the error "cvs |
| 475 : | [server aborted]: cannot find .: No such file or directory"?</a></b> | ||
| 476 : | jlemieux | 1.44 | <p> </p> |
| 477 : | jlemieux | 1.48 | <p>I think the problem is that of user rights on the machine CVSNT |
| 478 : | is running on. You might try one or more of the following options: </p> | ||
| 479 : | mvalenta | 1.33 | <ul> |
| 480 : | jlemieux | 1.48 | <li>create a group having full access rights to the CVSNT |
| 481 : | repository directory structure plus the temp folder CVSNT is using. | ||
| 482 : | This is easiest if you specify a separate CVSNT temp directory such as | ||
| 483 : | mvalenta | 1.54 | "c:\cvstemp" using the Advanced tab in the<br /> |
| 484 : | jlemieux | 1.48 | CVSNT control panel. (The default temporary directories in |
| 485 : | "C:\WINNT\TEMP" and "C:\Documents and Settings" have access | ||
| 486 : | restrictions under Win2000 and WinXP).</li> | ||
| 487 : | jlemieux | 1.44 | <li>turn off impersonation in CVSNT</li> |
| 488 : | jlemieux | 1.48 | <li>add all CVS users to PowerUsers on the machine CVSNT is |
| 489 : | running on</li> | ||
| 490 : | jlemieux | 1.44 | </ul> |
| 491 : | <p></p> | ||
| 492 : | mvalenta | 1.40 | <p></p> |
| 493 : | mvalenta | 1.33 | </li> |
| 494 : | jlemieux | 1.48 | <li><b><a name="server_13">My server has been configured to use an |
| 495 : | alternate server name. What do I need to do?</a></b> | ||
| 496 : | jlemieux | 1.44 | <p> </p> |
| 497 : | jlemieux | 1.48 | <p>Custom server names cause problems for Eclipse CVS because the |
| 498 : | client makes use of the text messages sent from the server. The symptom | ||
| 499 : | you will see is that expanding HEAD will not show any of the folders in | ||
| 500 : | the repository. To correct the problem: </p> | ||
| 501 : | jlemieux | 1.44 | <ol> |
| 502 : | <li>Open the CVS Repositories View. </li> | ||
| 503 : | jlemieux | 1.48 | <li>From the context menu of the repository location, open the |
| 504 : | Properties page. </li> | ||
| 505 : | <li>On the CVS properties page (the only one present), select | ||
| 506 : | "Expect a custom program name" (at the bottom) and enter "cvspserver". </li> | ||
| 507 : | jlemieux | 1.44 | </ol> |
| 508 : | jlemieux | 1.48 | This should fix the problem. </li> |
| 509 : | jlemieux | 1.44 | <p> </p> |
| 510 : | james | 1.1 | </ol> |
| 511 : | mvalenta | 1.54 | <br /> |
| 512 : | james | 1.1 | <!-- SSH --> |
| 513 : | jlemieux | 1.43 | <h1>Using SSH with CVS</h1> |
| 514 : | james | 1.1 | <ol> |
| 515 : | mvalenta | 1.53 | <li><b><a name="ssh_1">How do I use SSH to communicate with the server?</a></b> |
| 516 : | <p>The pserver protocol sends passwords over the network in plaintext. Many | ||
| 517 : | people prefer to establish a secure connection using SSH. Eclipse supports | ||
| 518 : | two methods of connecting to CVS repositories using SSH. </p> | ||
| 519 : | <p>To use the Eclipse's built-in SSH support, simply specify "extssh" as the | ||
| 520 : | connection method type when creating the repository connection.</p> | ||
| 521 : | jlemieux | 1.44 | <p>To use SSH support from an external tool, you must: </p> |
| 522 : | <ol> | ||
| 523 : | mvalenta | 1.53 | <li>Specify "ext" as the connection method type when creating the repository |
| 524 : | connection.</li> | ||
| 525 : | <li>Window->Preferences->Team->CVS->Ext Connection Method. On | ||
| 526 : | this page, specify the name and location of your external ssh client. | ||
| 527 : | (For example, "<code>C:\plink.exe</code>" or "<code>/usr/local/bin/ssh</code>"). | ||
| 528 : | Also specify the name and location of the CVS binary <b>on the server</b>. | ||
| 529 : | The default value is often correct.</li> | ||
| 530 : | <li>Ensure that you can log on to the server using the external SSH tool | ||
| 531 : | <b>without specifying a password</b>.</li> | ||
| 532 : | </ol> | ||
| 533 : | <p><b>Note:</b> In Eclipse 2.1, you can also specify (on the Ext Connection | ||
| 534 : | Method preference page) the parameters to be passed to the SSH client, including | ||
| 535 : | the password.</p> | ||
| 536 : | </li> | ||
| 537 : | <li><b><a name="ssh_2">What is the difference between ext and extssh?</a></b> | ||
| 538 : | <p>The extssh connection method uses a built-in SSH client. The ext connection | ||
| 539 : | method allows you to specify an external SSH client to use. For extssh to | ||
| 540 : | work with Eclipse 2.1.x and before, the server must be running an SSH server | ||
| 541 : | with SSH1 protocol compatibility. If extssh does not work, it is possible | ||
| 542 : | that the server is running only the SSH2 protocol. If this is the case, | ||
| 543 : | you must configure the ext connection method with an external SSH client. | ||
| 544 : | In Eclipse 3.0 and beyond, extssh does support SSH2. </p> | ||
| 545 : | jlemieux | 1.44 | </li> |
| 546 : | mvalenta | 1.53 | <li><a name="ssh_jcraft"></a><strong>My SSH server only support SSH2 protocol |
| 547 : | mvalenta | 1.54 | and I'm using Eclipse 2.1.x</strong> <br /> |
| 548 : | <br /> | ||
| 549 : | mvalenta | 1.53 | Eclipse comes with a built-in SSH connection method called 'extssh'. Prior |
| 550 : | to Eclipse 3.0, this method only supported SSH1 servers. If your server is | ||
| 551 : | running SSH2 and you want to use Eclipse 2.1.x to connect to that server you | ||
| 552 : | mvalenta | 1.54 | have two options: <br /> |
| 553 : | jlemieux | 1.36 | <ol> |
| 554 : | mvalenta | 1.53 | <li>use a command line SSH client that supports SSH2 with the 'ext' connection |
| 555 : | mvalenta | 1.54 | method <br /> |
| 556 : | jlemieux | 1.44 | </li> |
| 557 : | <li>download a plugin created by <a | ||
| 558 : | mvalenta | 1.53 | href="http://www.jcraft.com/eclipse-cvsssh2/">JCraft</a> that provides a SSH2 |
| 559 : | mvalenta | 1.54 | connection method. <br /> |
| 560 : | jlemieux | 1.44 | </li> |
| 561 : | jlemieux | 1.36 | </ol> |
| 562 : | mvalenta | 1.53 | To use the 'ext' connection method, download and install an SSH command line |
| 563 : | client for your operating environment. In the Team > CVS > Ext Connection | ||
| 564 : | Method preference page, configure the location of the SSH executable and how | ||
| 565 : | the executable is to be called. For the ext method to work the CVS client | ||
| 566 : | on your server must support the server mode. You can verify this by running | ||
| 567 : | mvalenta | 1.54 | cvs --help-commands and ensure that the server command is supported.<br /> |
| 568 : | mvalenta | 1.53 | </li> |
| 569 : | <li><b><a name="ssh_3">How do I set up public-key authentication for an external | ||
| 570 : | SSH client?</a></b> | ||
| 571 : | <p>The steps for setting up public-key authentication vary depending on your | ||
| 572 : | SSH client. However, they all follow this set of common steps: </p> | ||
| 573 : | <ol> | ||
| 574 : | <li>Use the client program (or a utility that came with it) to generate | ||
| 575 : | a public/private key pair. This program might be called ssh-keygen or | ||
| 576 : | puttygen.exe.</li> | ||
| 577 : | <li>Copy the public key to the server. This is often done by pasting the | ||
| 578 : | public key into the file <code>/home/user/.ssh/authorized_keys</code>.</li> | ||
| 579 : | </ol> | ||
| 580 : | </li> | ||
| 581 : | mvalenta | 1.54 | <br /> |
| 582 : | mvalenta | 1.53 | <li><b><a name="ssh_4">When I try to connect using SSH, it tells me "Could not |
| 583 : | chdir to home directory /home/user/myname". What did I do wrong?</a></b> | ||
| 584 : | <p>This often happens when using SourceForge projects for the first time, | ||
| 585 : | but may occur on other servers as well. You must manually log in to the | ||
| 586 : | server, using an interactive SSH session, in order to create your home directory | ||
| 587 : | for the first time. After this, you will be able to log in successfully. | ||
| 588 : | </p> | ||
| 589 : | <p>Use your SSH client to connect to the server (e.g. cvs.sourceforge.net) | ||
| 590 : | and log in with your username and password. Your home directory will be | ||
| 591 : | created for you.</p> | ||
| 592 : | </li> | ||
| 593 : | <li><b><a name="ssh_5">I got an 'Unknown response' while trying to perform CVS | ||
| 594 : | browsing. What went wrong?</a></b> | ||
| 595 : | <p>A problem has been reported that involves the Cygwin SSH client (see bug | ||
| 596 : | <a href="http://bugs.eclipse.org/bugs/show_bug.cgi?id=21180">21180</a>). | ||
| 597 : | Try using another SSH client such as Putty or <a | ||
| 598 : | jlemieux | 1.44 | href="http://www.networksimplicity.com/openssh/">OpenSSH</a>. </p> |
| 599 : | jlemieux | 1.36 | </li> |
| 600 : | mvalenta | 1.54 | <li><a name="ssh_6"><strong>I can't get keys generated using Putty to work with |
| 601 : | Eclipse</strong></a></li> | ||
| 602 : | mvalenta | 1.53 | <p>Putty's private key is encrypted by AES, but JCE (Java Crtptgraphy Extension) |
| 603 : | included in J2SE 1.4.x does not support AES. So, at present time, there is | ||
| 604 : | no plan to support it. Of course, JSch (the SSH2 client used in Eclipse) may | ||
| 605 : | support Putty's key by using the latest J2SE in the near future, but Eclipse | ||
| 606 : | mvalenta | 1.54 | 3.0/3.1 will not be able to use it because they must run on J2SE 1.4.0. This |
| 607 : | is explained more in bug <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=84281">https://bugs.eclipse.org/bugs/show_bug.cgi?id=84281</a>.</p> | ||
| 608 : | james | 1.1 | </ol> |
| 609 : | mvalenta | 1.54 | <br /> |
| 610 : | james | 1.1 | <!-- Upgrading from Eclipse 1.0 --> |
| 611 : | jlemieux | 1.43 | <h1>Upgrading from Eclipse 1.0</h1> |
| 612 : | james | 1.1 | <ol> |
| 613 : | jlemieux | 1.44 | <li><b><a name="10_1">Is there anything I should do before upgrading |
| 614 : | from Eclipse 1.0 to 2.0?</a></b> | ||
| 615 : | <p> </p> | ||
| 616 : | <p><b>IMPORTANT:</b> Before upgrading from Eclipse 1.0 to 2.0, make | ||
| 617 : | sure you release all your changes to the repository using Eclipse 1.0. | ||
| 618 : | Although it is possible to submit the changes using Eclipse 2.0 after | ||
| 619 : | you upgrade, to do so is not straight forward due to a change in how | ||
| 620 : | the synchronization information for each project is stored.</p> | ||
| 621 : | </li> | ||
| 622 : | <p> </p> | ||
| 623 : | <li><b><a name="10_2">I'm using a workspace from 1.0. Why does the | ||
| 624 : | Team menu only contain "Share Project"?</a></b> | ||
| 625 : | <p> </p> | ||
| 626 : | <p>Team support changed drastically between Eclipse 1.0 and 2.0. As | ||
| 627 : | such, the method of sharing projects with the repository changed as | ||
| 628 : | well. We have tried to make it relatively easy for you to migrate, | ||
| 629 : | however. You will notice that your previously shared projects only have | ||
| 630 : | "Share Project" in the Team menu. If you select that option, a wizard | ||
| 631 : | will guide you through the migration process. When you are finished, | ||
| 632 : | your project will be shared and the Synchronize view will open. You | ||
| 633 : | will see conflicting changes on every file - this is due to changes in | ||
| 634 : | the way sync information is stored between 1.0 and 2.0. If you do not | ||
| 635 : | have any outgoing changes (which you shouldn't have if you committed | ||
| 636 : | all your outgoing changes before upgrading as recommended above), then | ||
| 637 : | you can simply select the project in the Synchronize view and select | ||
| 638 : | "Override and Update" which will load the current contents from the | ||
| 639 : | server. If you do have outgoing changes, you can pull down the triangle | ||
| 640 : | menu in the Synchronize view and select "Compare File Contents". After | ||
| 641 : | some work, the Synchronize view will show you only the files which are | ||
| 642 : | actually different. You can then use the Synchronize view to resolve | ||
| 643 : | these conflicts.</p> | ||
| 644 : | </li> | ||
| 645 : | <p> </p> | ||
| 646 : | <li><b><a name="10_3">Eclipse 1.0 created all my files as binary in | ||
| 647 : | the repository. How do I fix this?</a></b> | ||
| 648 : | <p> </p> | ||
| 649 : | <p>Any file checked into a CVS repository from Eclipse 1.0 was | ||
| 650 : | marked as binary. This means that end-of-line conversions will not | ||
| 651 : | occur on checkout, and some features of CVS (such as auto-mergeable | ||
| 652 : | conflicts) will not apply to these files. As such, it may be desirable | ||
| 653 : | to change some of these files from binary to text. To change the file | ||
| 654 : | types, do the following:</p> | ||
| 655 : | <ol> | ||
| 656 : | <li>Make sure that all members of your team have saved and | ||
| 657 : | committed any changes to the affected files.</li> | ||
| 658 : | <li>Select the resources you wish to change in the Navigator or | ||
| 659 : | other view.</li> | ||
| 660 : | <li>Context Menu->Team->Set Keyword Substitution...</li> | ||
| 661 : | <li>Select "Automatic" to use the recommended detection. Click | ||
| 662 : | Next.</li> | ||
| 663 : | <li>Select the checkbox labelled "Include files that are already | ||
| 664 : | in the repository". Click Next.</li> | ||
| 665 : | <li>Click Finish. All affected files will immediately be modified | ||
| 666 : | in the repository.</li> | ||
| 667 : | <li>All other team members must now check out fresh copies of all | ||
| 668 : | affected files.</li> | ||
| 669 : | </ol> | ||
| 670 : | </li> | ||
| 671 : | <p> </p> | ||
| 672 : | <li><b><a name="10_4">Is a Branch the same as a Stream? What about | ||
| 673 : | other 1.0 terminology?</a></b> | ||
| 674 : | <p> </p> | ||
| 675 : | <p>In an effort to move away from generic terminology that applies | ||
| 676 : | to all repository providers, and toward provider-specific terminologies | ||
| 677 : | and workflows, many terms, menu items and labels have changed in 2.0. | ||
| 678 : | Here is a brief list of some of the changes. For more detailed | ||
| 679 : | information, please see the Eclise CVS documentation.</p> | ||
| 680 : | <table border="1"> | ||
| 681 : | <tbody> | ||
| 682 : | <tr> | ||
| 683 : | <td><b>Eclipse 1.0</b></td> | ||
| 684 : | <td><b>Eclipse 2.0</b></td> | ||
| 685 : | <td><b>Comments</b></td> | ||
| 686 : | </tr> | ||
| 687 : | <tr> | ||
| 688 : | <td>Stream</td> | ||
| 689 : | <td>Branch</td> | ||
| 690 : | <td>The CVS terminology "Branch" replaces "Stream"</td> | ||
| 691 : | </tr> | ||
| 692 : | <tr> | ||
| 693 : | <td>Catchup</td> | ||
| 694 : | <td>Update</td> | ||
| 695 : | <td>"Update" refers to the standard CVS method of retrieving | ||
| 696 : | remote contents. For more details on Update, see the Eclipse CVS | ||
| 697 : | documentation.</td> | ||
| 698 : | </tr> | ||
| 699 : | <tr> | ||
| 700 : | <td>Release</td> | ||
| 701 : | <td>Commit</td> | ||
| 702 : | <td>These terms are equivalent.</td> | ||
| 703 : | </tr> | ||
| 704 : | <tr> | ||
| 705 : | <td>Add to Workspace</td> | ||
| 706 : | <td>Check Out as Project</td> | ||
| 707 : | <td>The CVS terminology "Check Out" replaces "Add to | ||
| 708 : | Workspace".</td> | ||
| 709 : | </tr> | ||
| 710 : | <tr> | ||
| 711 : | <td><i>None</i></td> | ||
| 712 : | <td>Tag</td> | ||
| 713 : | <td>In CVS, a Tag refers to either a Branch Tag or a Version | ||
| 714 : | Tag. Branches and versions together are referred to as Tags.</td> | ||
| 715 : | </tr> | ||
| 716 : | </tbody> | ||
| 717 : | </table> | ||
| 718 : | </li> | ||
| 719 : | <p> </p> | ||
| 720 : | <li><b><a name="10_5">I get a message saying the .vcm_meta file is | ||
| 721 : | obsolete and should be deleted. Should I really delete it?</a></b> | ||
| 722 : | <p> </p> | ||
| 723 : | <p>In Eclipse 1.0, meta-information about a project was stored in | ||
| 724 : | .vcm_meta. In Eclipse 2.0, this mechanism was made more general and the | ||
| 725 : | data was moved to the .project file. As such, the .vcm_meta file is now | ||
| 726 : | unneeded. The Eclipse CVS client will warn you of this state by placing | ||
| 727 : | a warning in the task list. If you still have people on your team who | ||
| 728 : | are using Eclipse 1.0 for development with your repository, then you | ||
| 729 : | should not delete the .vcm_meta file. If all members of your team are | ||
| 730 : | using Eclipse 2.0, then you can safely delete the .vcm_meta file and | ||
| 731 : | commit the deletion to the repository.</p> | ||
| 732 : | </li> | ||
| 733 : | <p> </p> | ||
| 734 : | james | 1.1 | </ol> |
| 735 : | mvalenta | 1.54 | <br /> |
| 736 : | james | 1.1 | <!-- Using Eclipse and CVS for Java Development --> |
| 737 : | jlemieux | 1.43 | <h1>Using Eclipse and CVS for Java Development</h1> |
| 738 : | james | 1.1 | <ol> |
| 739 : | jlemieux | 1.44 | <li><b><a name="java_1">When I check out a Java project from the |
| 740 : | repository, how do I make Eclipse aware it is a Java project?</a></b> | ||
| 741 : | <p> </p> | ||
| 742 : | <p>Eclipse makes use of information in the .project file to | ||
| 743 : | determine if a project is a Java project. If the project you have | ||
| 744 : | checked out does not have a .project file, Eclipse will not mark it | ||
| 745 : | properly. If you use "Checkout As..." instead of "Checkout As Project" | ||
| 746 : | in the Repositories view, then you will be given an opportunity to | ||
| 747 : | specify Java as the project type and provide Java specific | ||
| 748 : | configuration information.</p> | ||
| 749 : | <p> </p> | ||
| 750 : | <p> </p> | ||
| 751 : | </li> | ||
| 752 : | <li><b><a name="java_2">What is the .classpath file? Should I commit | ||
| 753 : | it to the repository?</a></b> | ||
| 754 : | <p> </p> | ||
| 755 : | <p>Eclipse's Java development tools create and maintain a special | ||
| 756 : | file, .classpath, in the root of each Java project. This file contains | ||
| 757 : | information about the project's classpath, including references to | ||
| 758 : | other projects, external jars, and the project's own source path. If | ||
| 759 : | you are working on a team with other developers that use Eclipse, you | ||
| 760 : | probably want to commit this file to the repository so that others can | ||
| 761 : | benefit from correct classpath settings. If the other developers on | ||
| 762 : | your team do not use Eclipse, you may still want to commit the | ||
| 763 : | .classpath file so that your settings are persisted - this should not | ||
| 764 : | affect the users that are not using Eclipse.</p> | ||
| 765 : | <p> </p> | ||
| 766 : | <p> </p> | ||
| 767 : | </li> | ||
| 768 : | <li><b><a name="java_3">In my CVS repository, there is a source | ||
| 769 : | directory in the repository root. How can I use this with Eclipse?</a></b> | ||
| 770 : | <p> </p> | ||
| 771 : | <p>If the name of the CVS module is part of the package name of | ||
| 772 : | Java files, you will encounter problems. For example, if the module you | ||
| 773 : | check out is called "test", and it contains a folder called "code" | ||
| 774 : | which contains Java files that claim to be in the package "test.code", | ||
| 775 : | Eclipse will not be able to compile these Java classes. There are | ||
| 776 : | several solutions to this problem:</p> | ||
| 777 : | <ol> | ||
| 778 : | <li>One solution is to move the top-level package folder ("test" | ||
| 779 : | in this case) to be a subfolder of the CVS module. In this case, create | ||
| 780 : | a folder called "test" in the project "test", and move "code" into it. | ||
| 781 : | Then commit your changes. | ||
| 782 : | <p> </p> | ||
| 783 : | </li> | ||
| 784 : | <li>Another possible solution is to use modules definitions. | ||
| 785 : | Modules can be defined in the CVSROOT/modules file to include root | ||
| 786 : | level projects as subfolders of the checked out folder stucture. The | ||
| 787 : | steps to get this to work for the above example are: | ||
| 788 : | <ol> | ||
| 789 : | mvalenta | 1.54 | <li>Add the following two lines to the CVSROOT/modules file<br /> |
| 790 : | test &test<br /> | ||
| 791 : | jlemieux | 1.44 | MyProject &test </li> |
| 792 : | <li>In the CVS Repositories View, select the modules with the | ||
| 793 : | name matching the one defined in the CVSROOT/modules file (Note that in | ||
| 794 : | Eclipse 2.0.x, you will need to switch to "Show Modules" mode using the | ||
| 795 : | drop down menu in the title bar in order to see the module).</li> | ||
| 796 : | <li>Select "MyProject" and choose "Checkout Module" from the | ||
| 797 : | popup menu.</li> | ||
| 798 : | </ol> | ||
| 799 : | See the <a href="http://www.cvshome.org">CVS documentation</a> for | ||
| 800 : | more information on defining modules. | ||
| 801 : | <p> </p> | ||
| 802 : | </li> | ||
| 803 : | <li>If you are using Eclipse 2.1, you can create a new Java | ||
| 804 : | Project and then perform a "Checkout Into..." on the CVS Module. This | ||
| 805 : | operation allows you to check out a CVS modules into an existing | ||
| 806 : | project as a subfolder and configures that target project to be shared | ||
| 807 : | with CVS. </li> | ||
| 808 : | </ol> | ||
| 809 : | <p>Source folders must always begin beneath the project, not above | ||
| 810 : | it. See the Eclipse Java Development Tools documentation for more | ||
| 811 : | information on source folders.</p> | ||
| 812 : | </li> | ||
| 813 : | <p> </p> | ||
| 814 : | <li><b><a name="java_4">How do I check out a module definition as a | ||
| 815 : | Java project?</a></b> | ||
| 816 : | <p> </p> | ||
| 817 : | <p>To check out a module that is defined in the CVSROOT/modules | ||
| 818 : | file as a Java project, you may have to pre-create the target project | ||
| 819 : | as a java project in the workspace before performing the "Check Out | ||
| 820 : | Module". </p> | ||
| 821 : | </li> | ||
| 822 : | <p> </p> | ||
| 823 : | <li><b><a name="java_5">Why does the bin directory keep appearing in | ||
| 824 : | the Synchronize view?</a></b> | ||
| 825 : | <p> </p> | ||
| 826 : | <p>JDT marks most of its build output as being derived resources so | ||
| 827 : | that CVS and other repository types can easily ignore these resources | ||
| 828 : | from version control. However, if you define custom source and build | ||
| 829 : | output folders, the newly created build output folder will not be | ||
| 830 : | marked as derived. In many cases the root build output folder is named | ||
| 831 : | bin. To ignore this folder, select it in the navigator and choose Team | ||
| 832 : | > Add to .cvsignore, then commit the .cvsignore file to the | ||
| 833 : | repository so that the bin folder will be ignored at all times for that | ||
| 834 : | project. </p> | ||
| 835 : | </li> | ||
| 836 : | <p> </p> | ||
| 837 : | <li><b><a name="java_5a">I ignored the bin directory but it appears | ||
| 838 : | to be shared anyway. Why?</a></b> | ||
| 839 : | <p> </p> | ||
| 840 : | <p>If a resources whose name matches a pattern in the .cvsignore | ||
| 841 : | also exists in the repository, then this resource is not ignored. For | ||
| 842 : | the case of the bin folder, chances are that the bin folder was | ||
| 843 : | committed to the repository at some point. The solution is to purge | ||
| 844 : | this directory from the repository. </p> | ||
| 845 : | </li> | ||
| 846 : | <p> </p> | ||
| 847 : | <li><b><a name="java_6">How do I use CVS keywords in Java templates?</a></b> | ||
| 848 : | <p> </p> | ||
| 849 : | mvalenta | 1.55 | <p>Substitute the usual keyword (e.g. $Revision: 1.54 $) with the $ |
| 850 : | escaped version (e.g. $$Revision: 1.54 $$). </p> | ||
| 851 : | jlemieux | 1.44 | </li> |
| 852 : | <p> </p> | ||
| 853 : | <li><b><a name="java_7">I'm working with a virtual module defined in | ||
| 854 : | the CVSROOT/modules file. How do I commit the .project and/or | ||
| 855 : | .classpath file?</a></b> | ||
| 856 : | <p> </p> | ||
| 857 : | <p>The easiest way to address this problem is to create a project | ||
| 858 : | in the repository whose purpose is to hold the .project and .classpath | ||
| 859 : | files for your module. For example, if your module definition is <i>my-module | ||
| 860 : | &sub-dir1 &sub-dir2</i> you could change it to <i>my-module | ||
| 861 : | my-module-project &sub-dir1 $sub-dir2</i> where my-module-project | ||
| 862 : | is an new folder on the CVS server. Committing the .project and | ||
| 863 : | .classpath files would create the files in this folder. </p> | ||
| 864 : | </li> | ||
| 865 : | <p> </p> | ||
| 866 : | james | 1.1 | </ol> |
| 867 : | mvalenta | 1.54 | <br /> |
| 868 : | james | 1.1 | <!-- Compatibility Between CVS Command-line Client and Eclipse --> |
| 869 : | jlemieux | 1.43 | <h1>Compatibility Between CVS Command-line Client and Eclipse</h1> |
| 870 : | james | 1.1 | <ol> |
| 871 : | jlemieux | 1.44 | <li><b><a name="commandLine_1">Does Eclipse use [WinCVS|CVS |
| 872 : | command-line client] to talk to the server?</a></b> | ||
| 873 : | <p> </p> | ||
| 874 : | <p>No. Eclipse implements a CVS client in Java that talks directly | ||
| 875 : | to the server using the documented CVS protocol. No external CVS client | ||
| 876 : | is required.</p> | ||
| 877 : | </li> | ||
| 878 : | <p> </p> | ||
| 879 : | <li><b><a name="commandLine_2">The command-line CVS client stores | ||
| 880 : | information in CVS folders. Does Eclipse do the same thing? If so, | ||
| 881 : | where are the folders?</a></b> | ||
| 882 : | <p> </p> | ||
| 883 : | <p>Eclipse stores CVS sync information in CVS/ folders in the same | ||
| 884 : | way as the command-line CVS client does. However, you rarely see these | ||
| 885 : | folders within Eclipse. They are marked using a Core facility called | ||
| 886 : | "team-private" which causes them to be hidden from view. If you open a | ||
| 887 : | (non-Eclipse) file explorer you will see that these directories and | ||
| 888 : | their contents appear on the file system.</p> | ||
| 889 : | </li> | ||
| 890 : | <p> </p> | ||
| 891 : | <li><b><a name="commandLine_3">Is Eclipse compatible with the | ||
| 892 : | command-line CVS client?</a></b> | ||
| 893 : | <p> </p> | ||
| 894 : | <p>Eclipse Team CVS stores its meta information in a format that is | ||
| 895 : | compatible with the command-line CVS client. Thus you should be able to | ||
| 896 : | use a CVS command line client against Eclipse workspace files on disk. | ||
| 897 : | Please note that this support is experimental, and you may run into | ||
| 898 : | problems. However, we are very interested in making this work, so | ||
| 899 : | please report any bugs you find.</p> | ||
| 900 : | <p>Whenever you use external tools to modify workspace files, you | ||
| 901 : | must perform a Refresh from within Eclipse to make the workspace aware | ||
| 902 : | of the changes.</p> | ||
| 903 : | <p>You may encounter unexpected behaviour when using the | ||
| 904 : | command-line CVS client in conjunction with deleted folders. Eclipse's | ||
| 905 : | CVS support keeps track of deleted folders and their contents so that, | ||
| 906 : | on the next synchronization, the Synchronize view can properly report | ||
| 907 : | on the changes. This information is kept outside of the CVS meta folder | ||
| 908 : | structure. This is because in CVS you normally inform the repository of | ||
| 909 : | deletions prior to deleting them locally, which is a different workflow | ||
| 910 : | than we like to support in the Synchronization view. Thus it is | ||
| 911 : | recommended that you do not use the command-line CVS client while you | ||
| 912 : | have pending deletions to commit. In some circumstances it could cause | ||
| 913 : | the Synchronize view to display incorrect contents, although it should | ||
| 914 : | not cause any lost work.</p> | ||
| 915 : | </li> | ||
| 916 : | <p> </p> | ||
| 917 : | <li><b><a name="commandLine_4">Can I import a project into Eclipse | ||
| 918 : | that was checked out using the command line?</a></b> | ||
| 919 : | <p> </p> | ||
| 920 : | <p>Yes you can. However, you may encounter errors from the builder | ||
| 921 : | related to the copying of the CVS folders. This can have two causes. | ||
| 922 : | The first is when the project is imported before the CVS plugin is | ||
| 923 : | loaded. To avoid this problem, make sure you open one of the CVS views | ||
| 924 : | before importing the project. The second is due to a "race" on import | ||
| 925 : | between the CVS plugin and other plugins that react to the import. If | ||
| 926 : | the CVS plugin wins the race, then the CVS folders are hidden but if | ||
| 927 : | another plugin discovers the CVS folders first, it may cause the | ||
| 928 : | workbench to "know" about them and perform inappropriate actions on | ||
| 929 : | them. The best way to solve the problem is to run a <b>Team>Update</b> | ||
| 930 : | on the project and then shutdown and restart Eclipse (although closing | ||
| 931 : | and reopening the view in which the CVS folders appear may work as | ||
| 932 : | well). If this fails, you may need to check the projects out from your | ||
| 933 : | repository using Eclipse instead of the command line client.</p> | ||
| 934 : | <p>There is a plugin named <i>org.eclipse.team.cvs.delta</i> | ||
| 935 : | available on the <a | ||
| 936 : | href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-vcm-home/dev.html">Development | ||
| 937 : | Resources</a> page that loads on startup and ensures that CVS folders | ||
| 938 : | are properly hidden. If you import CVS projects often, you may want to | ||
| 939 : | use this plugin. </p> | ||
| 940 : | </li> | ||
| 941 : | <p> </p> | ||
| 942 : | <li><b><a name="commandLine_5">Why does Eclipse corrupt my *.jar, | ||
| 943 : | *.zip, etc. files?</a></b> | ||
| 944 : | <p> </p> | ||
| 945 : | <p>This problem is caused by the keyword substitution mode assigned | ||
| 946 : | to the file on the server. Any binary files must be marked as -kb. The | ||
| 947 : | default for CVS is to mark unknown file types as text. CVS provides | ||
| 948 : | cvswrappers and the cvs admin command to set file types.</p> | ||
| 949 : | </li> | ||
| 950 : | <p> </p> | ||
| 951 : | <li><b><a name="commandLine_6">When I use the command-line CVS on my | ||
| 952 : | project, why do the CVS folders sometimes appear in the Navigator View?</a></b> | ||
| 953 : | <p> </p> | ||
| 954 : | <p>There are some cases where CVS folders are not hidden from the | ||
| 955 : | UI as the user would expect. For instance, CVS folders will appear if a | ||
| 956 : | user imports a CVS project into Eclipse before the CVS plug-in is | ||
| 957 : | loaded. To avoid this, open the CVS Repositories view (thus loading the | ||
| 958 : | CVS plug-in) before importing CVS projects into Eclipse. There is also | ||
| 959 : | a plugin available <a | ||
| 960 : | href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-vcm-home/dev.html">here</a> | ||
| 961 : | that will ensure that the CVS folders are properly hidden even if the | ||
| 962 : | CVS plugin is not loaded.</p> | ||
| 963 : | </li> | ||
| 964 : | <p> </p> | ||
| 965 : | <li><b><a name="commandLine_7">When I use the command-line CVS on my | ||
| 966 : | project, why go I get "resource out of sync" errors?</a></b> | ||
| 967 : | <p> </p> | ||
| 968 : | <p>This occurs when files that are resources in Eclipse are | ||
| 969 : | modified outside of Eclipse. One solution is to perform a refresh | ||
| 970 : | (available from a resource's popup menu) on any resources or projects | ||
| 971 : | that where modified outside of Eclipse. There is also an "auto-refresh" | ||
| 972 : | plugin available from Platform Core (click <a | ||
| 973 : | href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-core-home/dev.html">here</a> | ||
| 974 : | to go to there).</p> | ||
| 975 : | </li> | ||
| 976 : | <p> </p> | ||
| 977 : | james | 1.1 | </ol> |
| 978 : | mvalenta | 1.54 | <br /> |
| 979 : | james | 1.1 | <!-- Working with Patches --> |
| 980 : | jlemieux | 1.43 | <h1>Working with Patches</h1> |
| 981 : | james | 1.1 | <ol> |
| 982 : | jlemieux | 1.44 | <li><b><a name="patches_1">How do I send someone a patch?</a></b> |
| 983 : | <p> </p> | ||
| 984 : | <p>If you have modified a project that you checked out from CVS, | ||
| 985 : | you may want to send those changes to someone else. This often occurs | ||
| 986 : | when you do not have commit rights, but want to send the changes to | ||
| 987 : | someone who does. To create a patch file:</p> | ||
| 988 : | <ol> | ||
| 989 : | <li>Select the changed project in the Navigator or other view.</li> | ||
| 990 : | <li>Context Menu->Team->Create Patch...</li> | ||
| 991 : | <li>Select a location for the patch.</li> | ||
| 992 : | <li>Use E-mail or other delivery method to send the patch to | ||
| 993 : | someone else.</li> | ||
| 994 : | </ol> | ||
| 995 : | </li> | ||
| 996 : | <p> </p> | ||
| 997 : | <li><b><a name="patches_2">How do I apply a patch that someone sent | ||
| 998 : | me?</a></b> | ||
| 999 : | <p> </p> | ||
| 1000 : | <p>To apply a patch, such as one generated in the previous step, do | ||
| 1001 : | the following:</p> | ||
| 1002 : | <ol> | ||
| 1003 : | <li>Select the changed project in the Navigator or other view.</li> | ||
| 1004 : | <li>Context Menu->Compare With->Patch...</li> | ||
| 1005 : | <li>Fill in the location of the patch file</li> | ||
| 1006 : | <li>Click Next. A summary of changed files will appear.</li> | ||
| 1007 : | <li>Click Finish. The changes are now merged into the workspace.</li> | ||
| 1008 : | <li>Context Menu->Team->Synchronize. You may now commit the | ||
| 1009 : | changes into the repository.</li> | ||
| 1010 : | </ol> | ||
| 1011 : | </li> | ||
| 1012 : | <p> </p> | ||
| 1013 : | james | 1.1 | </ol> |
| 1014 : | mvalenta | 1.54 | <br /> |
| 1015 : | mvalenta | 1.30 | <!-- Linux --> |
| 1016 : | jlemieux | 1.43 | <h1>Linux Issues</h1> |
| 1017 : | mvalenta | 1.30 | <ol> |
| 1018 : | jlemieux | 1.44 | <p> </p> |
| 1019 : | <li><b><a name="linux_0">On linux, using IBM JRE 1.3.0, I get a | ||
| 1020 : | timeout when connecting to a repository. What's wrong?</a></b> | ||
| 1021 : | <p> </p> | ||
| 1022 : | <p>Problems have been reported in this area using IBM JRE 1.3.0 on | ||
| 1023 : | Linux. The solution is to upgrade your JRE to version 1.3.1.</p> | ||
| 1024 : | </li> | ||
| 1025 : | <p> </p> | ||
| 1026 : | <li><b><a name="linux_1">On Red Hat 8, Eclipse fails to make a | ||
| 1027 : | checkout but it works with other clients. Why?</a></b> | ||
| 1028 : | <p> </p> | ||
| 1029 : | <p>The problem may be the encoding in /etc/sysconfig/i18n file. If | ||
| 1030 : | the language encoding is </p> | ||
| 1031 : | mvalenta | 1.54 | <pre> LANG="en_US.UTF-8"<br /> </pre> |
| 1032 : | jlemieux | 1.44 | changing it to |
| 1033 : | mvalenta | 1.54 | <pre> LANG="en_US"<br /> </pre> |
| 1034 : | jlemieux | 1.44 | should fix the problem. |
| 1035 : | <p></p> | ||
| 1036 : | </li> | ||
| 1037 : | <p> </p> | ||
| 1038 : | mvalenta | 1.30 | </ol> |
| 1039 : | <!-- Windows --> | ||
| 1040 : | jlemieux | 1.43 | <h1>Windows Issues</h1> |
| 1041 : | mvalenta | 1.30 | <ol> |
| 1042 : | jlemieux | 1.44 | <p> </p> |
| 1043 : | <li><b><a name="windows_0">Eclipse crashed Windows 2000 (blue screen) | ||
| 1044 : | when performing a CVS operation. What happened?</a></b> | ||
| 1045 : | <p> </p> | ||
| 1046 : | <p>Instances of this have been reported that involve the NDIS.sys | ||
| 1047 : | driver and particular brands of network cards (see bug <a | ||
| 1048 : | href="http://dev.eclipse.org/bugs/show_bug.cgi?id=21276">21276</a>).</p> | ||
| 1049 : | </li> | ||
| 1050 : | <p> </p> | ||
| 1051 : | <li><b><a name="windows_2">Eclipse always times out when performing a | ||
| 1052 : | Synchronize on one or two particular machines?</a></b> | ||
| 1053 : | <p> </p> | ||
| 1054 : | <p>Instances of this have been reported that involve the VIA | ||
| 1055 : | on-board network cards (see bug <a | ||
| 1056 : | href="http://dev.eclipse.org/bugs/show_bug.cgi?id=21276">27077</a>). | ||
| 1057 : | Changing the network card fixed the problem.</p> | ||
| 1058 : | </li> | ||
| 1059 : | <p> </p> | ||
| 1060 : | <li><b><a name="windows_3">Why do CVS operations slow down when I am | ||
| 1061 : | connected to my network/dial-up?</a></b> | ||
| 1062 : | <p> </p> | ||
| 1063 : | <p>I have a large number of entries in my hosts file for anti-ad | ||
| 1064 : | software - and when I'm connected, name resolution (even to localhost) | ||
| 1065 : | slows to a crawl. When I'm not connected, localhost gets resolved at | ||
| 1066 : | normal speed. I think this might be a "feature" of 2000/XP - it didn't | ||
| 1067 : | happen in NT.</p> | ||
| 1068 : | </li> | ||
| 1069 : | <li><b><a name="windows_4">Why do all my files show as outgoing | ||
| 1070 : | changes?</a></b> | ||
| 1071 : | <p> </p> | ||
| 1072 : | <p>The CVS plugin uses timestamps of the files on disk to track the | ||
| 1073 : | modification state of versioned files. As a result, there are some | ||
| 1074 : | cases where Windows users may find that as a result of either (1) an | ||
| 1075 : | automatic daylight savings change or (2) moving files between file | ||
| 1076 : | systems, that all the files show up as outgoing changes. See <a | ||
| 1077 : | href="http://dev.eclipse.org/bugs/show_bug.cgi?id=5337">Bug 5337</a> | ||
| 1078 : | for an explanation of the problem and workarounds. </p> | ||
| 1079 : | mvalenta | 1.50 | <p>Thers is a utility action that will reset the timestamps so the |
| 1080 : | files are in-sync with CVS. Be warned however that this utility resets the | ||
| 1081 : | timestamps for any file whose timestamp differs from the sync timestamp by 1 hour. | ||
| 1082 : | There is a possibility that this could reset a file that is really dirty. Use at your own risk. | ||
| 1083 : | mvalenta | 1.52 | To use the action, install the plugin found <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-vcm-home/plugins/fixtimestamps.zip">here</a> |
| 1084 : | and them run the CVS Util/Fix Timestamps command available from the context menu of the Resource Navigator. | ||
| 1085 : | mvalenta | 1.50 | </p> |
| 1086 : | mvalenta | 1.38 | </li> |
| 1087 : | jlemieux | 1.44 | <p> </p> |
| 1088 : | mvalenta | 1.30 | </ol> |
| 1089 : | james | 1.1 | <!-- Miscellaneous --> |
| 1090 : | jlemieux | 1.43 | <h1>Miscellaneous</h1> |
| 1091 : | james | 1.1 | <ol> |
| 1092 : | jlemieux | 1.44 | <li><b><a name="misc_0">Is there any equivalent to CVS_CLIENT_LOG is |
| 1093 : | Eclipse?</a></b> | ||
| 1094 : | <p> </p> | ||
| 1095 : | <p>Yes, there are tracing facilities in Eclipse that will allow you | ||
| 1096 : | to see what messages are being communicated between the CVS client and | ||
| 1097 : | server. Here's how:</p> | ||
| 1098 : | <ol> | ||
| 1099 : | <li>Create a file named ".options" in you eclipse directory (the | ||
| 1100 : | directory that contains the executable) that contains the following 2 | ||
| 1101 : | lines that enable CVS debugging. | ||
| 1102 : | mvalenta | 1.54 | <pre> org.eclipse.team.cvs.core/debug=true<br /> org.eclipse.team.cvs.core/cvsprotocol=true<br /> </pre> |
| 1103 : | jlemieux | 1.44 | </li> |
| 1104 : | <li>Start Eclipse with the following parameters tailored to you | ||
| 1105 : | local setup (The below example is for windows). The important aspects | ||
| 1106 : | are the use of java.exe instead of javaw.exe and the inclusion of the | ||
| 1107 : | -debug and -consolelog options. These will cause the debug console to | ||
| 1108 : | be visible and for debugging output to appear in the console. | ||
| 1109 : | mvalenta | 1.54 | <pre> C:\eclipse\eclipse.exe<br /> -vm C:\jre\bin\java.exe<br /> -data C:\eclipse\workspace<br /> -debug<br /> -consolelog<br /> </pre> |
| 1110 : | jlemieux | 1.44 | </li> |
| 1111 : | <li>Inside Eclipse, create your repo location and expand it in | ||
| 1112 : | the repositories view (for example). The CVS command traffic in the | ||
| 1113 : | debug console should contains an invocation of the update command that | ||
| 1114 : | looks something like (this is output from dev.eclipse.org): | ||
| 1115 : | mvalenta | 1.54 | <pre> CMD> cvs -n update -d "."<br /> ...<br /> update<br /> E cvs server: Updating .<br /> E cvs server: New directory `CVSROOT' -- ignored<br /> E cvs server: New directory `jdt-core-home' -- ignored<br /> E cvs server: New directory `jdt-debug-home' -- ignored<br /> ...<br /> </pre> |
| 1116 : | jlemieux | 1.44 | </li> |
| 1117 : | </ol> | ||
| 1118 : | </li> | ||
| 1119 : | <p> </p> | ||
| 1120 : | <li><b><a name="misc_1">What is the .project file, and should I | ||
| 1121 : | release it to CVS?</a></b> | ||
| 1122 : | <p> </p> | ||
| 1123 : | <p>The .project file is created and maintained by Eclipse. It | ||
| 1124 : | stores meta-information about the project, such as which projects it | ||
| 1125 : | references and what type of project it is. If other members of your | ||
| 1126 : | team will be using Eclipse to check out this project from CVS, you | ||
| 1127 : | almost certainly want to release the .project file to CVS. Even if | ||
| 1128 : | other members of your team are not using Eclipse, you may still want to | ||
| 1129 : | release the .project file so that the information is persisted for you.</p> | ||
| 1130 : | </li> | ||
| 1131 : | <p> </p> | ||
| 1132 : | <li><b><a name="misc_2">I don't have update access to the CVS | ||
| 1133 : | repository. Can I still check out a project with Eclipse?</a></b> | ||
| 1134 : | <p> </p> | ||
| 1135 : | <p>In some circumstances, depending on permissions on the server, | ||
| 1136 : | you may not be able to browse the repository in the CVS Repositories | ||
| 1137 : | view. In this case, it may still be possible to check out the project | ||
| 1138 : | you want.</p> | ||
| 1139 : | <ol> | ||
| 1140 : | <li>Create an empty project.</li> | ||
| 1141 : | <li>Context Menu->Team->Share Project...</li> | ||
| 1142 : | <li>Enter the repository information and click Finish</li> | ||
| 1143 : | <li>The Synchronize view appears. Update all incoming changes.</li> | ||
| 1144 : | </ol> | ||
| 1145 : | <p>The project in your workspace is now shared with the CVS | ||
| 1146 : | repository, and contains the remote contents.</p> | ||
| 1147 : | </li> | ||
| 1148 : | <p> </p> | ||
| 1149 : | <li><b><a name="misc_3">What does "Terminated with fatal signal 10" | ||
| 1150 : | mean?</a></b> | ||
| 1151 : | <p> </p> | ||
| 1152 : | <p>There is a bug in the CVS server related to some compression | ||
| 1153 : | levels. If you get this error, change the compression level on the CVS | ||
| 1154 : | preferences page and see if that helps.</p> | ||
| 1155 : | </li> | ||
| 1156 : | <p> </p> | ||
| 1157 : | <li><b><a name="misc_4">I copied some folders from one CVS project to | ||
| 1158 : | another and the old CVS information remained. What happened?</a></b> | ||
| 1159 : | <p> </p> | ||
| 1160 : | <p>There is a bug in the CVS client in Eclipse 2.0 that will not | ||
| 1161 : | purge the CVS folders properly if a folder under CVS control is moved | ||
| 1162 : | into a folder that is not under CVS control. If this occurs, you will | ||
| 1163 : | need to delete the CVS folders manually.</p> | ||
| 1164 : | </li> | ||
| 1165 : | <p> </p> | ||
| 1166 : | <li><b><a name="misc_8">I used Team > Share Project to connect a | ||
| 1167 : | local project to an existing project and it takes forwever. Why?</a></b> | ||
| 1168 : | <p> </p> | ||
| 1169 : | <p>The particular method you have chosen to populate your workspace | ||
| 1170 : | (i.e. create a new project and then sync against a large existing one) | ||
| 1171 : | happens to be one of the most ineffiecient operations in the Eclipse | ||
| 1172 : | CVS client. The CVS protocol does not support this type of operation | ||
| 1173 : | directly which results in the ineffiecient, communication intensive | ||
| 1174 : | operation. The proper way to populate your workspace is to use | ||
| 1175 : | "Checkout as Project" from the CVS Repositories view. Once the project | ||
| 1176 : | and its contents exists locally, the synchronize operatons should be | ||
| 1177 : | much faster.</p> | ||
| 1178 : | </li> | ||
| 1179 : | <p> </p> | ||
| 1180 : | <li><b><a name="misc_9">Does Eclipse support Watch/Edit?</a></b> | ||
| 1181 : | <p> </p> | ||
| 1182 : | <p>Eclipse 2.1 supports CVS Edit/Unedit. In 2.0, you can use the | ||
| 1183 : | following workaround:</p> | ||
| 1184 : | mvalenta | 1.54 | <pre> Run->External Tools->Configure...->New<br /> Name: CVS Watchers<br /> Tool Location: C:\cygwin\bin\cvs.exe<br /> Tool arguments: watchers<br /> Working directory: ${container_loc}<br /> After running, refresh: Nothing<br /> Check Show Execution Log on Console<br /> OK<br /> New<br /> Name: CVS Edit<br /> Tool Location: C:\cygwin\bin\cvs.exe<br /> Tool arguments: edit ${resource_name}<br /> Working directory: ${container_loc}<br /> After running, refresh: Nothing<br /> Check Show Execution Log on Console<br /> OK<br /> </pre> |
| 1185 : | jlemieux | 1.44 | <p> Unedit works the same as Edit, Editors works the same way as |
| 1186 : | Watchers. To use the tools, highlight the file or directory on which to | ||
| 1187 : | execute the CVS command, then select Run->External Tools-><tool | ||
| 1188 : | name=""> If you don't select the file/directory first, CVS will | ||
| 1189 : | complain that the CVSROOT variable must be set first. </tool></p> | ||
| 1190 : | </li> | ||
| 1191 : | <p> </p> | ||
| 1192 : | <li><b><a name="misc_12">Why do I get a "Pre-commit failed" error | ||
| 1193 : | with no detailed error message?</a></b> | ||
| 1194 : | <p> </p> | ||
| 1195 : | <p> The problem is that the CVS server communicates the error | ||
| 1196 : | details as M messages instead of E messages and so the error handling | ||
| 1197 : | in Eclipse doesn't display them. Eclipse has a CVS console which you | ||
| 1198 : | can open from the Window>Show View>Other menu command. If this | ||
| 1199 : | view is open and you run the failing commit, it will show you the error | ||
| 1200 : | details. </p> | ||
| 1201 : | </li> | ||
| 1202 : | <p> </p> | ||
| 1203 : | james | 1.1 | </ol> |
| 1204 : | jlemieux | 1.44 | </body> |
| 1205 : | </html> |
| help@eclipse.org | ViewVC Help |
| Powered by ViewVC 1.0.3 |