Difference between revisions of "VTK/Git"

From KitwarePublic
< VTK
Jump to navigationJump to search
(Created page with '__TOC__ VTK version tracking and development will be hosted by [http://git-scm.com Git]. =Experimental Repository= We have published an ''experimental'' repository on public.k…')
 
(Replaced content with "The instructions previously available on this page have been superseded. See [https://gitlab.kitware.com/vtk/vtk/blob/master/Documentation/dev/git/README.md here].")
 
(137 intermediate revisions by 12 users not shown)
Line 1: Line 1:
__TOC__
+
The instructions previously available on this page have been superseded. See [https://gitlab.kitware.com/vtk/vtk/blob/master/Documentation/dev/git/README.md here].
 
 
VTK version tracking and development will be hosted by [http://git-scm.com Git].
 
 
 
=Experimental Repository=
 
 
 
We have published an ''experimental'' repository on public.kitware.com. '''WE REQUEST THAT NO ONE PUBLISH A CLONE OF THIS REPOSITORY AT AN ONLINE HOSTING SITE'''. This may or may not be the final version of history after conversion from CVS. It may be removed or rewritten at any time. We prefer to not have multiple incompatible histories out there. The final conversion will be available soon, at which point we may all begin sharing changes!
 
 
 
One may browse the repository online using the [http://git.wiki.kernel.org/index.php/Gitweb Gitweb] interface at http://public.kitware.com/vtk-tmp.git/.
 
 
 
At the time of this writing the repository does not have branches and tags older than VTK 5.0.
 
Conversion of older branches and tags from CVS will be completed later and added.
 
 
 
==Cloning==
 
 
 
One may clone the repository using [http://www.kernel.org/pub/software/scm/git/docs/git-clone.html git clone] through the native <code>git</code> protocol:
 
 
 
$ git clone git://public.kitware.com/vtk-tmp.git VTK
 
 
 
or through the (less efficient) <code>http</code> protocol:
 
 
 
$ git clone http://public.kitware.com/vtk-tmp.git VTK
 
 
 
All further commands work inside the local copy of the repository created by the clone:
 
 
 
$ cd VTK
 
 
 
 
 
=Development=
 
 
 
We provide here a brief introduction to development with Git.
 
See the [[#Resources|Resources]] below for further information.
 
 
 
First, use [http://www.kernel.org/pub/software/scm/git/docs/git-config.html git config] to introduce yourself to Git:
 
 
 
$ git config --global user.name "Your Name"
 
$ git config --global user.email "you@yourdomain.com"
 
 
 
Optionally enable color output from Git commands:
 
 
 
$ git config --global color.ui auto
 
 
 
The <code>--global</code> option stores the configuration settings in <code>~/.gitconfig</code> in your home directory so that they apply to all repositories.
 
 
 
=Resources=
 
 
 
Additional information about Git may be obtained at these sites:
 
 
 
* [http://git-scm.com Git Homepage]
 
* [http://git.wiki.kernel.org/index.php/GitDocumentation Git Documentation Wiki]
 
* [http://book.git-scm.com/ Git Community Book]
 
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday Git]
 
* [http://github.com/guides/git-cheat-sheet Git Cheat-Sheet]
 
* [http://progit.org/book/ Pro Git]
 
* [http://marklodato.github.com/visual-git-guide/ A Visual Git Reference]
 

Latest revision as of 15:42, 16 March 2015

The instructions previously available on this page have been superseded. See here.