Difference between revisions of "Git"

From Embedded Xinu
Jump to navigation Jump to search
(Created page)
 
 
Line 3: Line 3:
 
The official public repository is hosted on Github.  To get the code, install git and run:
 
The official public repository is hosted on Github.  To get the code, install git and run:
  
<code>
+
git clone <nowiki>https://github.com/xinu-os/xinu</nowiki>
git clone https://github.com/xinu-os/xinu
 
</code>
 
  
This will generate the directory "xinu" containing a local copy of the repository.  Note that this is a standalone repository that can be used without access to the Github repository. This constitutes a difference from Subversion, which is more centralized.
+
This will generate the directory <code>xinu/</code> containing a local copy of the repository.  Note that this is a standalone repository that can be used without Internet access to the Github repository. This constitutes a difference from Subversion, which is more centralized.
  
Git is documented extensively in many locations, for example in the [http://git-scm.com/book "Pro Git" book].  But in one sentence, a very basic workflow is to modify files, use "git add" and "git commit" or "git commit -a" to commit the changes to the repository, then use "git push" to push changes to a remote repository.
+
Git is documented extensively in many locations, for example in the [http://git-scm.com/book "Pro Git" book].  But briefly, a very basic workflow is to modify files, use <code>git add</code> and <code>git commit</code> or <code>git commit -a</code> to commit the changes to the repository, then use <code>git push</code> to push changes to a remote repository.
  
 
Branches in git are fast and easy to use, so please develop experimental features in their own branches.  Code pushed to the "master" branch should not be broken.
 
Branches in git are fast and easy to use, so please develop experimental features in their own branches.  Code pushed to the "master" branch should not be broken.

Latest revision as of 01:36, 12 September 2013

Embedded Xinu previously used a Subversion repository, but in 2013 switched to git as the preferred method of development.

The official public repository is hosted on Github. To get the code, install git and run:

git clone https://github.com/xinu-os/xinu

This will generate the directory xinu/ containing a local copy of the repository. Note that this is a standalone repository that can be used without Internet access to the Github repository. This constitutes a difference from Subversion, which is more centralized.

Git is documented extensively in many locations, for example in the "Pro Git" book. But briefly, a very basic workflow is to modify files, use git add and git commit or git commit -a to commit the changes to the repository, then use git push to push changes to a remote repository.

Branches in git are fast and easy to use, so please develop experimental features in their own branches. Code pushed to the "master" branch should not be broken.