Differences

This shows you the differences between two versions of the page.

--- guides:software:git [2020/07/20 00:38] – Add options subsection jhoggard
+++ guides:software:git [2024/07/25 15:01] (current) – external edit 127.0.0.1
@@ Line 12: / Line 12: @@
   * In the working directory, with changes not yet tracked by git.
   * In the //staging area//. This is a temporary holding area where the current files are copied, in preparation for adding them to the repository.
-  * Recorded in the repository. Files in the staging area are moved into a //commit// in the repository, which is a permanent snapshot of the state of all files at that point in time. If we make further changes to any files, these will be untracked changes until will stage and commit them.
+  * Recorded as a snapshot in the repository. Files in the staging area are moved into a //commit// in the repository, which is a permanent snapshot of the state of all files at that point in time. If we make further changes to any files, these will be untracked changes until will stage and commit them.
 (Note that there may also be a //remote repository//, on a service like GitLab or GitHub, which keeps a copy of all of our commits.)
@@ Line 23: / Line 23: @@
   - (Optional) If we have a connection to an archive on a remote repository (on a service like GitLab or GitHub), we can //push// those changes to remote repository. This stage is needed to share the project with others, if we wish.
-As a simple example, we will look at the process of setting up a git repository for a simple "Hello, World!" program:
+As a simple example, we will look at the process of setting up a git repository for a simple "Hello, World!" program. In the following, we will be using git on the command line.  This is easy if you are logged in to cslab103, for example, where git is already installed.  (There are also GUI interfaces to git; we won't cover those.)
-  * First, let's make a directory to store the program in. We'll create a directory ''HelloTest''and change to that directory in the usual way. (In the following, we will work on cslab100, and we will use ''$'' to indicate the Linux prompt.)
+  * First, let's make a directory to store the program in. We'll create a directory ''HelloTest'' and change to that directory in the usual way. (In the following, we will work on cslab100, and we will use ''$'' to indicate the Linux prompt.)
 <code>
 $ mkdir HelloTest
@@ Line 97: / Line 97: @@
  create mode 100644 hello.cpp
 </code>
-  * We used the commit message "Initial commit: Hello world program." as our commit message. If we didn't include the ''-m'' and the string in the command, git would automatically open an editor to let you write a lengthy commit message. (It should use nano by default on cslab100, although it may default to vi on Windows.)
+  * We used the commit message "Initial commit: Hello world program." as our commit message. If we didn't include the ''-m'' and the string in the command, git would automatically open an editor to let you write a lengthy commit message. (It should use nano by default on cslab103, although it may default to vi on Windows.)
+==== Server: GitLab, GitHub, etc ====
+We can also work with a //remote// repository, which holds a copy of all our work on a server.  Common servers include GitHub and GitLab.
-Local repository: files, staging area, repository
+The department maintains its own GitLab server at codestore.cs.edinboro.edu.  See your professor if you need to set up an account.
-init, add, status, commit
+=== Create and clone ===
-==== Server: GitLab, GitHub, etc ====
+If you want to set up a remote repository on codestore, you can click the "New" button in the upper-left after you log in:
+You can select "Create a blank project", then fill in the name of your project, a description, set the privacy level, and create the project.
+Afterwards, you will see instructions for cloning your repository to your local machine, but it is not hard: On your project's main page, click the "Clone" button and select the https address to copy. (There is a button that will copy it.)
+Then on your machine (possibly cslab103), type the following in the directory where you want to clone the repository:
+<code>
+git clone <address>
+</code>
+where ''<address>'' is the https address you copied from codestore.  (The repository will be copied into a directory named for the repo.)
+Now you have a local copy of the repository, and by default, it is connected to the remote repository.  (The remote repository gets the nickname ''origin''.)  You can work on your local copy, committing files as usual.
+However, ''origin'' doesn't know about the commits on your local machine, and your local repository won't know about any updates to ''origin'' until you //push// or //pull// them.
+=== Push and Pull ===
+To send your commits up to ''origin'' (the remote repo) you need to //push// the files:
+<code>
+git push origin master
+</code>
+(The above sends your //master// branch commits to ''origin''.  In our case, ''origin'' is the remote repository at codestore.)
+To update your local repository with any changes added to the remote repository, you need to //pull// the files.  (Or //fetch// them.)  The easiest way to update your local repository is to type
+<code>
+git pull
+</code>
+This will fetch any commits made on your current branch (probably master) and merge them into your current directory.
+You can also separate this into two steps. The first retrieves any new snapshots on the remote repository, and the second merges the changes into your current files.
+<code>
+git fetch
+git merge
+</code>
+==== Fork Another Repository ====
-Create and clone
+You may sometimes want to copy someone else's repository on codestore into your very own version of the repository.  This is called a //fork//.  (For example, your professor might provide you a basic repository for an assignment, and ask you to fork it so you can work on your own copy.)
-Push and pull
+In GitLab (for example, at codestore), you can click on the "Fork" button at the top of a repository to make your own copy:
-Fork another repository
+Then you can clone //your// fork of the project to your own computer, and proceed as usual.
-=== Setting up SSH Credentials ===
 ==== Setting Options ====
@@ Line 123: / Line 160: @@
 The following are common tasks to complete using git. Where we refer to GitLab, the same task can be completed with other git servers, such as GitHub, usually with very little or no change.
-  * ''fork'': Make your own copy of someone else's repository on GitLab.
+  * ''fork'': Make your own copy of someone else's repository on GitLab.\\ This is done on a GitLab web page by clicking the "fork" button.
-  * ''clone'': Copy a GitLab archive to your personal computer.
+  * ''clone'': Copy a GitLab archive to your personal computer. \\ Usage: ''git clone <address>''
-  * ''init'': Initialize a new git repository on your own computer. (Will not be connected to a server.)
+  * ''init'': Initialize a new git repository on your own computer. (Will not be connected to a server, but it is possible to add one later.) \\ Usage: ''git init''.
-  * ''status'': Show what files are untracked, changed, staged, etc., in the current local repository.
+  * ''status'': Show what files are untracked, changed, staged, etc., in the current local repository.  \\ Usage: ''git status''
-  * ''add'': Add files to your local staging area.
+  * ''add'': Add files to your local staging area. \\ Usage: ''git add <filename>''
-  * ''commit'': Move files from the staging area to your local repository.
+  * ''commit'': Move files from the staging area to your local repository. \\ Usage: ''git commit -m "Commit message"''.  \\ If the ''-m "Commit message"'' is left out, an editor will open for you write your commit message.
-  * ''pull'': Update your local archive with changes/additions made to the server. (Assumes that you have an "upstream" repository on a server to pull from.)
+  * ''pull'': Update your local archive with changes/additions made to the server. (Assumes that you have an "upstream" repository on a server to pull from.) \\ Usage: ''git pull''
-  * ''push'': Push changes in your local repository upstream to the server repository.  (Assumes that you have an "upstream" repository on a server to pull from.)
+  * ''push'': Push changes in your local repository upstream to the server repository.  (Assumes that you have an "upstream" repository on a server to pull from.  \\ Usage: ''git push''.  For more control, use ''git push origin <branchname>''
-  * ''log'': See a list of commits made to your repository.
+  * ''log'': See a list of commits made to your repository.  \\ Usage: ''git log''
-  * ''checkout'': Switch to a new branch.
+  * ''checkout'': Switch to a new branch.  \\ Usage: ''git checkout <branchname>''
-  * ''diff'': See differences between various branches.
+  * ''diff'': See differences between various branches.  \\ Usage: ''git diff'' for the difference between current files and last commit.  \\ ''git diff <branchname>'' compares to another branch.