gitignore/Global
Carl Suster 8bc0e535bb Merge Pull Request #1338 for Eclipse
Fixes #1217.

Once again ignore .classpath and .project in the Eclipse template. This has
been requested in multiple PRs such as #1338 and #1221 and is essentially a
reversion of #805. I copy the explanation for this change from the discussion
in #1217 by @segfly:

*In short*:

I can't point to any counter-documentation off the top of my head. I just know
from experience these files pollute a project's repo without adding value
- that is, unless everyone contributing is using Eclipse and no-one is using
dependency management. And even then, the guidance provided by the eclipse docs
is bad advice.

*In Long*:

The .classpath file is used by Eclipse to maintain the project's classpath
during automatic compile (every save of a file). In the olden days, one would
manually configure the project within the Eclipse UI and include all the
dependent jars necessary to compile your project. Eclipse then wrote that
configuration out to the .classpath file.

In theory, this file could be shared with others so they did not have to
manually configure their eclipse classpath. In practice, I never saw it work
out quite so well due to eventual bloating of the classpath with needless jars
or jars that only existed on one person's machine. Mind you, many people back
then also used to check their dependent jars into version control along with
their source.

Dependency management tools like Gradle and Maven have done away with all that
of course. But they also integrate nicely with Eclipse and manage the project
classpath dynamically. The .classpath file is basically rebuilt based on
changes to the build.gradle file or pom.xml file. Effectively, this renders the
whole point of checking in the .classpath moot as it is easily rebuilt by the
Maven or Gradle plugin.

The .project file is another animal completely. It basically describes what
plugins should be applied to the project as configured in the Eclipse UI. Again
the theory is it could be shared and creates a happy world. But due to
different eclipse versions people may have, different plugins installed, etc.
sharing the .project file actually causes more issues. And I've seen many
projects unable to open due to a bad .project file - requiring one to delete it
anyway (which then of course, when someone recreates it, they inevitably check
it in over the old one and end up breaking someone else's environment).

The bottom line is, regardless of what the eclipse documentation says, these
are very much internal configuration files for eclipse and best left out of
a repo.
2015-01-15 11:41:35 +11:00
..
Anjuta.gitignore Ignore the symbole database which is a generated binary file. 2014-11-07 14:09:57 -05:00
Archives.gitignore add Windows Installer files 2013-10-16 18:45:13 +02:00
BricxCC.gitignore Add comment to BricxCC.gitignore 2013-11-12 06:28:53 +11:00
CVS.gitignore ensure single trailing newline 2013-10-06 14:40:01 +02:00
Cloud9.gitignore Update Cloud9.gitignore 2014-01-02 16:51:35 -08:00
CodeKit.gitignore Create CodeKit.gitignore 2014-10-21 14:59:29 -07:00
DartEditor.gitignore Move editor specific files into a new DartEditor.gitignore 2013-11-10 17:28:41 +01:00
Dreamweaver.gitignore DW Dreamweaver added files 2013-07-31 12:56:24 -05:00
Eclipse.gitignore Added Eclipse JDT .classpath file, and the Eclipse core .project file to 2014-12-26 22:23:09 -05:00
EiffelStudio.gitignore Move the EiffelStudio.gitignore in the Global directory 2014-02-27 21:41:28 -05:00
Emacs.gitignore Adding .cask directory to Global/Emacs.gitignore 2014-10-15 16:06:43 +09:00
Ensime.gitignore ensure single trailing newline 2014-03-27 17:04:56 +01:00
Espresso.gitignore ensure single trailing newline 2013-10-06 14:40:01 +02:00
FlexBuilder.gitignore Added bin-release folder 2014-03-25 15:14:14 -05:00
IPythonNotebook.gitignore Remove stray whitespace 2014-05-07 21:22:24 +10:00
JDeveloper.gitignore doc JDeveloper.gitignore 2014-12-10 06:50:42 +08:00
JetBrains.gitignore Merge pull request #1232 from thunsaker/patch-1 2014-10-20 17:47:22 +11:00
KDevelop4.gitignore adding global gitignore for KDevelop4 2012-04-20 10:12:43 +02:00
Kate.gitignore Added Kate ignore file 2013-08-04 22:25:21 -05:00
Lazarus.gitignore Update Lazarus.gitignore 2014-10-24 16:34:24 +03:00
LibreOffice.gitignore Move LibreOffice.gitignore to /Global 2014-11-22 20:22:52 -02:00
Linux.gitignore add .Trash-* to ignore Linux partition or ext disk trash folders 2015-01-13 15:31:58 -07:00
LyX.gitignore Create LyX.gitignore 2014-08-19 14:11:11 +10:00
Matlab.gitignore ensure single trailing newline 2013-10-06 14:40:01 +02:00
Mercurial.gitignore Added newline in order to allow multiple adds of 2011-05-27 08:54:48 +02:00
MicrosoftOffice.gitignore Create MicrosoftOffice 2014-11-05 18:09:27 -08:00
ModelSim.gitignore added initial version of ModelSim.gitignore 2011-03-14 16:41:28 +01:00
Momentics.gitignore Add user-specific settings to Momentics.gitignore 2014-09-23 01:07:37 -04:00
MonoDevelop.gitignore Added support for MonoDevelop .gitignore 2011-05-23 21:31:25 -05:00
NetBeans.gitignore Added missing gradle netbeans directory 2014-12-04 17:43:52 +01:00
Ninja.gitignore Make ninja a global template. 2014-07-08 18:13:34 +10:00
NotepadPP.gitignore ensure single trailing newline 2014-03-27 17:04:56 +01:00
OSX.gitignore Fixed typo in comment 2014-04-15 16:19:56 +02:00
README.md READMEs and globals and you 2010-11-08 15:00:28 -08:00
Redcar.gitignore Masking Redcar project files. 2010-11-09 15:48:06 +08:00
Redis.gitignore Add a global redis ignore file. 2014-12-22 17:08:52 -05:00
SBT.gitignore Fix URL in SBT template 2014-05-06 17:19:27 +10:00
SVN.gitignore Ignore all the .svn folders. 2011-01-28 04:11:05 +08:00
SlickEdit.gitignore ensure single trailing newline 2014-03-27 17:04:56 +01:00
SublimeText.gitignore Remove *.pyc 2014-09-01 17:24:30 +02:00
Tags.gitignore Ignores for gtags and cscope added. 2012-06-10 01:32:00 +03:00
TextMate.gitignore add "*.tmproject" to ignore list 2010-11-22 17:40:06 -08:00
TortoiseGit.gitignore Create TortoiseGit.gitignore 2014-10-17 14:17:08 +02:00
Vagrant.gitignore Allow the Vagrantfile to be tracked as that's the intended purpose. 2013-11-05 22:41:37 -05:00
Vim.gitignore Capitalise initial letter in template filenames for consistency/sorting 2015-01-07 15:16:27 +11:00
VirtualEnv.gitignore Ignore the pip self check marker file in a Virtualenv. 2015-01-10 17:49:44 +11:00
WebMethods.gitignore Capitalise initial letter in template filenames for consistency/sorting 2015-01-07 15:16:27 +11:00
Windows.gitignore add shortcut files 2014-08-21 20:45:30 +02:00
Xcode.gitignore Ignore xcuserstate 2014-04-15 18:59:29 +02:00
XilinxISE.gitignore Added Xilinx ISE gitignore 2012-04-09 21:21:28 -04:00

README.md

Globally Useful gitignores

This directory contains globally useful gitignores, e.g. OS-specific and editor specific.

For more on global gitignores: http://help.github.com/git-ignore/

And a good blog post about 'em: http://augustl.com/blog/2009/global_gitignores