Add a description about webkit-patch setup-git-clone to checkout.html
[WebKit-https.git] / Websites / webkit.org / building / checkout.html
index 081fa5f..358420d 100644 (file)
@@ -12,48 +12,64 @@ include("../header.inc");
 <p>To work with the WebKit source tree, you will need a Subversion or a Git client installed.
 See <a href="tools.html">Installing Developer Tools</a> for information on how
 to install Subversion.</p>
 <p>To work with the WebKit source tree, you will need a Subversion or a Git client installed.
 See <a href="tools.html">Installing Developer Tools</a> for information on how
 to install Subversion.</p>
-<div class="mac-instructions">
-<h4>Mac OS X</h4>
+<div class="unix-instructions">
+<h4>Mac OS X or Linux</h4>
 <ol>
 <ol>
-<li><p>Open Terminal</p>
-<p>Terminal resides in /Applications/Utilities. The Finder Go menu provides a quick way to navigate there.</p>
+    <li>
+        <p>Open a shell.</p>
+        <p>On OS X, you can use the <i>Terminal</i> App, which resides in /Applications/Utilities.</p>
+    </li>
+    <li>
+        <p>You can download a snapshot of the WebKit source tree from
+            <a href="http://nightly.webkit.org/files/WebKit-SVN-source.tar.bz2">http://nightly.webkit.org/files/WebKit-SVN-source.tar.bz2</a>.
+            It is updated every six hours. Note the archived checkout uses an HTTP connection. We recommend running the following command to use HTTPS instead:</p>
+        <p class="code">svn switch --relocate http://svn.webkit.org/repository/webkit/trunk https://svn.webkit.org/repository/webkit/trunk</p>
+        <p>Type these commands to check out the WebKit source tree:</p>
+        <p class="code">tar jxvf WebKit-SVN-source.tar.bz2<br>cd webkit</p>
+        <div>
+            <p>Alternatively, type this command to check out the WebKit source tree:</p>
+            <p class="code">svn checkout https://svn.webkit.org/repository/webkit/trunk WebKit</p>
+        </div>
+    </li>
+    <li>
+        <p>Run the <code>./Tools/Scripts/update-webkit</code> <a href="/coding/scripts.html">script</a> to update your source tree.</p>
+    </li>
 </ol>
 </div>
 
 <div class="windows-instructions">
 <h4>Windows</h4>
 <ol>
 </ol>
 </div>
 
 <div class="windows-instructions">
 <h4>Windows</h4>
 <ol>
-<li><p>Open a Cygwin Shell</p>
-<p>Double-click the Cygwin icon on your Desktop to launch a new shell.
+    <li>
+        <p>Open a Cygwin Shell</p>
+        <p>Double-click the Cygwin icon on your Desktop to launch a new shell.</p>
+    </li>
+    <li>
+        <p>You can download a snapshot of the WebKit source tree from
+            <a href="http://nightly.webkit.org/files/WebKit-SVN-source.tar.bz2">http://nightly.webkit.org/files/WebKit-SVN-source.tar.bz2</a>.
+            It is updated every six hours. Note the archived checkout uses an HTTP connection. We recommend running the following command to use HTTPS instead:</p>
+        <p class="code">svn switch --relocate http://svn.webkit.org/repository/webkit/trunk https://svn.webkit.org/repository/webkit/trunk</p>
+        <p>Type these commands to check out the WebKit source tree:</p>
+        <p class="code">tar jxvf WebKit-SVN-source.tar.bz2<br>cd webkit</p>
+        <div>
+            <p>Alternatively, type this command to check out the WebKit source tree:</p>
+            <p class="code">svn checkout https://svn.webkit.org/repository/webkit/trunk WebKit</p>
+        </div>
+    </li>
+    <li>
+        <p>Install the WebKit Support Libraries</p>
+        <p>Download the <a href="http://developer.apple.com/opensource/internet/webkit_sptlib_agree.html">WebKit Support Libraries</a> to the root of your source tree (<code>C:\cygwin\home\&lt;username&gt;\WebKit</code>).</p>
+        <p>If the file is incorrectly named, rename it to <code>WebKitSupportLibrary.zip</code>. Do not extract its contents.</p>
+    </li>
+    <li>
+        <p>Run the <code>./Tools/Scripts/update-webkit</code> <a href="/coding/scripts.html">script</a> to update your source tree.</p>
+        <p>If you downloaded the tarball, this will bring it up to date.  Windows users
+            must always execute this command after first obtaining the code, since it will
+            download additional libraries that are needed to build.</p>
+    </li>
 </ol>
 </div>
 
 </ol>
 </div>
 
-<ol>
-<li><p>Type this command to check out the WebKit source tree:</p>
-<p class="code">svn checkout https://svn.webkit.org/repository/webkit/trunk WebKit</p>
-<p>Alternatively you can download a snapshot of the WebKit source tree from 
-<a href="http://nightly.webkit.org/files/WebKit-SVN-source.tar.bz2">http://nightly.webkit.org/files/WebKit-SVN-source.tar.bz2</a>.  It is updated every six hours. Note the archived checkout uses an HTTP connection. We recommend running the following command to use HTTPS instead:</p>
-<p class="code">svn switch --relocate http://svn.webkit.org/repository/webkit/trunk https://svn.webkit.org/repository/webkit/trunk</p>
-</li>
-</ol>
-
-<div class="windows-instructions">
-<h4>Windows</h4>
-<ol>
-<li><p>Install the WebKit Support Libraries</p>
-<p>Download the <a href="http://developer.apple.com/opensource/internet/webkit_sptlib_agree.html">WebKit Support Libraries</a> to the root of your source tree (<code>C:\cygwin\home\&lt;username&gt;\WebKit</code>).</p>
-<p>If the file is incorrectly named, rename it to <code>WebKitSupportLibrary.zip</code>. Do not extract its contents.</p>
-</ol>
-</div>
-
-<ol>
-<li><p>Run the <code>update-webkit</code> <a href="/coding/scripts.html">script</a>
-to update your source tree.</p>
-<p>If you downloaded the tarball, this will bring it up to date.  Windows users
-must always execute this command after first obtaining the code, since it will
-download additional libraries that are needed to build.</p>
-</ol>
-
 <p>Once you have a current tree, the next step is
 <a href="build.html">building WebKit</a>.</p>
 
 <p>Once you have a current tree, the next step is
 <a href="build.html">building WebKit</a>.</p>
 
@@ -61,7 +77,10 @@ download additional libraries that are needed to build.</p>
 <p>To work with the WebKit source tree using a Git client, install a Git client with Subversion support and run the following command on your terminal:</p>
 <p class="code">git clone git://git.webkit.org/WebKit.git WebKit</p>
 
 <p>To work with the WebKit source tree using a Git client, install a Git client with Subversion support and run the following command on your terminal:</p>
 <p class="code">git clone git://git.webkit.org/WebKit.git WebKit</p>
 
-<p>If you want to be able to commit changes to the Subversion repository, or just want to check out branches that aren't contained in WebKit.git, you will need track the Subversion repository. For information about this, and other aspects of using Git with WebKit, read <a href="http://trac.webkit.org/wiki/UsingGitWithWebKit">the wiki page</a>.</p>
+<p>If you want to be able to commit changes to the Subversion repository, or just want to check out branches that aren't contained in WebKit.git, you will need track the Subversion repository. You can run the following command to configure this and other options of the new Git clone for WebKit development.</p>
+<p class="code">Tools/Scripts/webkit-patch setup-git-clone</p>
+
+<p>For information about this, and other aspects of using Git with WebKit, read <a href="https://trac.webkit.org/wiki/UsingGitWithWebKit">the wiki page</a>.</p>
 
 <h2>Keeping up to Date</h2>
 <p>At any time, you can rerun the <code>update-webkit</code> script to update
 
 <h2>Keeping up to Date</h2>
 <p>At any time, you can rerun the <code>update-webkit</code> script to update