Difference between revisions of "Ignoring files"

From Geos-chem
Jump to: navigation, search
(The .gitignore files used in the GEOS-Chem repository)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
'''''[[Cloning (i.e. downloading for the first time)|Previous]] | [[Next]] | [[Guide to using Git with GEOS-Chem]] | [[Getting Started with GEOS-Chem]] | [[Main Page|GEOS-Chem Main Page]]'''''
+
'''''[[Cloning (i.e. downloading for the first time)|Previous]] | [[Viewing the revision history|Next]] | [[Guide to using Git with GEOS-Chem]]'''''
 +
 
 +
#[[Introduction to Git]]
 +
#[[Installing Git]]
 +
#[[First-time Git setup]]
 +
#[[Cloning (i.e. downloading for the first time)]]
 +
#<span style="color:blue">'''Ignoring files'''</span>
 +
#[[Viewing the revision history]]
 +
#[[Using Git GUI]]
 +
#[[Branching]]
 +
#[[Committing]]
 +
#[[Tagging]]
 +
#[[Merging]]
 +
#[[Receiving updates (aka pulling)]]
 +
#[[Using patches to share your updates with others]]
 +
#[[Advanced Git usage]]
 +
#[[Git and Github tutorials]]
 +
 
  
 
== Overview ==
 
== Overview ==
Line 56: Line 73:
 
#[https://www.atlassian.com/git/tutorials/saving-changes/gitignore ''Gitignore'' (Atlassian documentation)]
 
#[https://www.atlassian.com/git/tutorials/saving-changes/gitignore ''Gitignore'' (Atlassian documentation)]
 
#[https://help.github.com/en/articles/ignoring-files ''Ignoring files'' (Github help)]
 
#[https://help.github.com/en/articles/ignoring-files ''Ignoring files'' (Github help)]
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:36, 19 June 2019 (UTC)
+
 
  
 
----
 
----
'''''[[Cloning (i.e. downloading for the first time)|Previous]] | [[Next]] | [[Guide to using Git with GEOS-Chem]] | [[Getting Started with GEOS-Chem]] | [[Main Page|GEOS-Chem Main Page]]'''''
+
'''''[[Cloning (i.e. downloading for the first time)|Previous]] | [[Viewing the revision history|Next]] | [[Guide to using Git with GEOS-Chem]]'''''

Latest revision as of 20:26, 5 August 2019

Previous | Next | Guide to using Git with GEOS-Chem

  1. Introduction to Git
  2. Installing Git
  3. First-time Git setup
  4. Cloning (i.e. downloading for the first time)
  5. Ignoring files
  6. Viewing the revision history
  7. Using Git GUI
  8. Branching
  9. Committing
  10. Tagging
  11. Merging
  12. Receiving updates (aka pulling)
  13. Using patches to share your updates with others
  14. Advanced Git usage
  15. Git and Github tutorials


Overview

On this page, we provide information on how you can tell Git to ignore certain types of files that should not be included in the version control.

Excluding files from the Git version history

Git also allows you to ignore certain types of files that we don't need to track (e.g. anything that can be built from the source code). These typically include:

  • Object files (*.o)
  • Library files (*.a)
  • Module files (*.mod)
  • Autosave files (*~)
  • Executable files (geos, geostomas)

To exclude these types of files, you must create a .gitignore file. This is a text file containing the files (or file types, using the * wildcard) that you do not wish Git to track. Each folder in a Git source code repository must have its own .gitignore file. For most purposes, you can copy the same .gitignore file to each subfolder.

To check if a source code folder has a .gitignore file, type:

ls -a .gitignore

The .gitignore files used by GEOS-Chem

Here is what the .gitignore files that are found in each GEOS-Chem source code subfolder look like. You can of course edit these for your own purposes:

*.[oax]
*.mod
*.MOD
*~*
*.swp
*.bak
*.patch
*.diff
geos
geostomas
geosapm
diffs
bak
misc
test
GCHP
GIGC
*.pp.*
*.pdb
*.inst.*
*.continue.*
*.ppk
*.log
bin/*

Further reading

  1. The .gitignore file (Official Git documentation)
  2. Gitignore (Atlassian documentation)
  3. Ignoring files (Github help)



Previous | Next | Guide to using Git with GEOS-Chem