ChangeSet ID: 27477 CVSROOT: /opt/cvs-commit Module name: lostwages Changes by: jnewman@winehq.org 2006/08/17 12:20:57
Added files: templates/en : git.template
Log message: Mike McCormack mike@codeweavers.com Add a page on fetching Wine with GIT
Patch: http://cvs.winehq.org/patch.py?id=27477
Old revision New revision Changes Path Added 1.1 +0 -0 lostwages/templates/en/git.template
Index: lostwages/templates/en/git.template diff -u -p /dev/null lostwages/templates/en/git.template:1.1 --- /dev/null 17 Aug 2006 17:20:57 -0000 +++ lostwages/templates/en/git.template 17 Aug 2006 17:20:57 -0000 @@ -0,0 +1,102 @@ +<!--TITLE:[The Wine Git Tree]--> + +<h1>The Wine Git Tree</h1> + +<p>Wine uses an Open Source, open process development model. +Anyone may get the code, post opinions on what should be done, +and contribute patches. You will need to know C and/or perl, and something +about <a href="{$root}/site/resources">Unix and Windows</a>.</p> + +<p><a href="http://git.or.cz/" target="_blank">git</a> is a fast directory +content manager, originally written for use with large repositories, +such as the Linux Kernel source. </p> + +<p>You will need Git 1.3.1 or above. </p> + +<p>Read the sections below on how to use our Git tree or check the +<a href="http://wiki.winehq.org/GitWine">GitWine</a> guide on the Wine Wiki.</p> + +<ol> + <li><a href="#clone">Getting a local copy of Wine</a> + <li><a href="#uptodate">Staying Up-To-Date</a> + <li><a href="#sourcetree">Source Tree Browsing via the Web</a> +</ol> + +<p><img src="./images/grey_pixel.gif" width="100%" height=1 border=0 alt="-"></p> + +<a name="clone" class="hidden"></a> + +<h1>Getting a local copy of Wine</h1> + +<p>To check out the entire Wine source tree, do:</p> + + <table width="500" border=0 cellpadding=10><tr><td class=black> + <span class=inverse> + git clone git://source.winehq.org/git/wine.git wine<br> + </span> + </td></tr> + </table> + +<p><img src="./images/grey_pixel.gif" width="100%" height=1 border=0 alt="-"></p> + +<a name="uptodate" class="hidden"></a> + +<h1>Cleaning up your existing tree</h1> + +<p>A quick way to clean up your tree after you've been modifying + it and want to remove changes you haven't checked in is this: </p> + + <table width="500" border=0 cellpadding=10><tr><td class=black> + <span class=inverse> + cd wine<br> + git diff-index -p HEAD > total-<i>x.x.x</i>.diff<br> + patch -p1 -R < total-<i>x.x.x</i>.diff<br> + git reset<br> + </span> + </td></tr> + </table> + +<p>Using the current x.x.x tags, you can keep a history of changes +that were in your Wine tree.</p> + +<p>If you have made commits to the tree, and want to remove them all, +you can use the following more dangerous command:</p> + + <table width="500" border=0 cellpadding=10><tr><td class=black> + <span class=inverse> + git reset --hard origin<br> + </span> + </td></tr> + </table> + +<p>This will wipe out any local changes you have made, so use it with caution.</p> + +<h1>Staying Up-To-Date</h1> + +<p> First, make sure to clean your tree as described above, then +run the following commands from the top level wine directory:</p> + + <table width="500" border=0 cellpadding=10><tr><td class=black> + <span class=inverse> + git fetch<br> + git rebase origin<br> + </span> + </td></tr> + </table> + +<a name="sourcetree" class=hidden></a> +<h1>Source Tree Browsing via the Web</h1> +<p>The source code of the entire Wine tree is (<a href="http://lxr.linux.no/">LXR</a>-based) +cross-referenced and available for browsing, including a search engine. +This cross-references source is based on the snapshot-releases and is made available at: </p> +<ul> + <li><a href="http://source.winehq.org/">source.winehq.org</a> +</ul> + +<p> Direct access from the web to the complete Git tree is also possible, using +<a href="http://www.kernel.org/pub/software/scm/gitweb/">gitweb</a> package:</p> +<ul> + <li><a href="http://source.winehq.org/git">source.winehq.org/git</a>, on the primary Git repository +</ul> + +<p> </p>