bundles/org.eclipse.platform.doc.user/reference/ref-48a.htm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html lang="en">
<HEAD>

<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >

<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Ignoring resources from version control</title>

</HEAD>
<BODY BGCOLOR="#ffffff">
<H1 CLASS="Head"> Ignoring resources from version control</H1>
<P CLASS="Para" Label=Type>When synchronizing resources, it is possible that there 
  are some resources that you do not want to commit to the repository. There 
  are two ignore facilities provided, allowing you to specify what resources 
  should be excluded from update and commit operations.</P>
<P CLASS="Para" Label=Type>The first is a global ignore facility, provided by the
Workbench. The second is the CVS ignore facility, which reads the contents of a
special file .<i>cvsignore</i> to determine what to ignore.</P>
<h2 Label=Type>Why ignore files when synchronizing?</h2>
<P Label=Type>There are many files that a user may not want to commit to the repository.&nbsp;
For example, external editors may create temporary files in your project. Compilation of .java files creates .class files, and
likewise many build operations result in binary files. These files, when taken together, may
be quite large. In addition, they may be re-generated whenever a build is performed,
resulting in many&nbsp; outgoing changes.  Typically these are not files that one wants to share with other members of a team or persist in the repository.&nbsp;&nbsp;</P>
<DIV CLASS="Subtopic">
<h2>
Global ignore facility</h2>
<p CLASS="Head">A global ignore facility is provided by the Workbench via the
Team preference page.
There is a list of file patterns against which resources will be matched before they are
considered as version control candidates.&nbsp;
These patterns may contain the wildcard characters "*" and "?".&nbsp; "*"
represents any sequence of zero or more characters.&nbsp; "?" represents any one
character.&nbsp; For example, you can specify a pattern of "*~", which would match
any temporary files that end with "~".&nbsp;&nbsp; Any file or directory that matches any one of the
patterns will be ignored during&nbsp; update or commit operations.&nbsp; When
you specify a file pattern to ignore, you can temporarily disable ignoring the
file pattern by de-selecting it from the list; you do not have to remove the
specified file pattern from the list.<br>
<br>
The patterns in the global ignore facility are matched against resource names during a
synchronize operation.&nbsp; It is important to note that the path leading up to the resource name is not
included in the matching.&nbsp; For example, for the file &quot;/path/to/file.txt&quot;, only the string
&quot;file.txt&quot; is matched against the patterns.&nbsp; This facility is not intended for specifying fully-qualified
path names but for specifying globally-applicable patterns.<br>
</p>
<h2>CVS ignore facility</h2>
  <p CLASS="Head">The Eclipse CVS client recognizes a file named &quot;.cvsignore&quot; 
    in each directory of a project.&nbsp; This is a standard CVS facility and 
    many existing CVS projects may contain this file.<br>
    <br>
    This text file consists of a list of files, directories, or patterns.&nbsp; 
    In a similar way to the global ignore facility, the wildcards "*" and "?" 
    may be present in any entry in the .cvsignore file.&nbsp; Any file or sub-directory 
    <b> in the current directory</b> that matches any one of the patterns will 
    be ignored.&nbsp; It is important to note that the semantics of this file 
    differs from that of the global ignore facility in that it applies only to 
    files and&nbsp; directories in the same directory as the .cvsignore file itself.&nbsp; 
    A project may contain one .cvsignore file in each directory.&nbsp; For more 
    information, please visit&nbsp; <a href="http://ximbiot.com/cvs/" target="_blank">http://ximbiot.com/cvs/</a>.</p>
  <p CLASS="Head">Resources that have not been added to CVS control can be ignored 
    by selecting <b>Team &gt; Add to .cvsignore</b> from the pop-up menu of the 
    resource in one of the navigation views. This menu option is also available 
    in the Synchronize view.</p>
</DIV>


</BODY>
</HTML>