docs: add MD5 checksums for 9.2.2 files
[mesa.git] / docs / repository.html
index 802c9a235cb28fa4e80188fc34b1d6265b1aff01..6f8d65ce366a4399fac3bf6ae5afa78b2f1e2d70 100644 (file)
@@ -2,19 +2,19 @@
 <html lang="en">
 <head>
   <meta http-equiv="content-type" content="text/html; charset=utf-8">
-  <title>Code Repository</title>
+  <title>Source Code Repository</title>
   <link rel="stylesheet" type="text/css" href="mesa.css">
 </head>
 <body>
 
 <div class="header">
-  <h1>The Mesa 3D Graphics Library</h1>
+  The Mesa 3D Graphics Library
 </div>
 
 <iframe src="contents.html"></iframe>
 <div class="content">
 
-<h1>Code Repository</h1>
+<h1>Source Code Repository</h1>
 
 <p>
 Mesa uses <a href="https://git-scm.com">git</a>
@@ -35,9 +35,9 @@ You may access the repository either as an
 
 <p>
 You may also 
-<a href="https://cgit.freedesktop.org/mesa/mesa/"
+<a href="https://gitlab.freedesktop.org/mesa/mesa"
 >browse the main Mesa git repository</a> and the
-<a href="https://cgit.freedesktop.org/mesa/demos"
+<a href="https://gitlab.freedesktop.org/mesa/demos"
 >Mesa demos and tests git repository</a>.
 </p>
 
@@ -49,19 +49,13 @@ To get the Mesa sources anonymously (read-only):
 </p>
 
 <ol>
-<li>Install the git software on your computer if needed.<br><br>
+<li>Install the git software on your computer if needed.
 <li>Get an initial, local copy of the repository with:
-    <pre>
-    git clone git://anongit.freedesktop.org/git/mesa/mesa
-    </pre>
+    <pre>git clone https://gitlab.freedesktop.org/mesa/mesa.git</pre>
 <li>Later, you can update your tree from the master repository with:
-    <pre>
-    git pull origin
-    </pre>
+    <pre>git pull origin</pre>
 <li>If you also want the Mesa demos/tests repository:
-    <pre>
-    git clone git://anongit.freedesktop.org/git/mesa/demos
-    </pre>
+    <pre>git clone https://gitlab.freedesktop.org/mesa/demos.git</pre>
 </ol>
 
 
@@ -98,24 +92,17 @@ on a particular driver, add a new extension, etc.) in the bugzilla record.
 </ol>
 
 <p>
-Once your account is established:
-</p>
+Once your account is established, you can update your push url to use SSH:
+<pre>
+git remote set-url --push <em>origin</em> git@gitlab.freedesktop.org:mesa/mesa.git
+</pre>
 
-<ol>
-<li>Get an initial, local copy of the repository with:
-    <pre>
-    git clone git+ssh://username@git.freedesktop.org/git/mesa/mesa
-    </pre>
-    Replace <em>username</em> with your actual login name.<br><br>
-<li>Later, you can update your tree from the master repository with:
-    <pre>
-    git pull origin
-    </pre>
-<li>If you also want the Mesa demos/tests repository:
-    <pre>
-    git clone git+ssh://username@git.freedesktop.org/git/mesa/demos
-    </pre>
-</ol>
+You can also use <a href="https://gitlab.freedesktop.org/profile/personal_access_tokens">personal access tokens</a>
+to push over HTTPS instead (useful for people behind strict proxies).
+In this case, create a token, and put it in the url as shown here:
+<pre>
+git remote set-url --push <em>origin</em> https://<em>USER</em>:<em>TOKEN</em>@gitlab.freedesktop.org/mesa/mesa.git
+</pre>
 
 
 <h2>Windows Users</h2>
@@ -136,7 +123,6 @@ and to LF on commit.
 <p>
 Unix users don't need to set this option.
 </p>
-<br>
 
 
 <h2>Development Branches</h2>
@@ -144,17 +130,17 @@ Unix users don't need to set this option.
 <p>
 At any given time, there may be several active branches in Mesa's
 repository.
-Generally, <tt>master</tt> contains the latest development (unstable)
+Generally, <code>master</code> contains the latest development (unstable)
 code while a branch has the latest stable code.
 </p>
 
 <p>
-The command <code>git-branch</code> will list all available branches.
+The command <code>git branch</code> will list all available branches.
 </p>
 
 <p>
 Questions about branch status/activity should be posted to the
-mesa3d-dev mailing list.
+mesa-dev mailing list.
 </p>
 
 <h2>Developer Git Tips</h2>
@@ -219,7 +205,8 @@ If you are familiar with CVS or similar system, this is similar to doing a
 the current repository state, instead of the time you did the last update.
 (CVS doesn't work like git in this respect, but this is easiest way
 to explain it.)
-<br>
+</p>
+<p>
 In any case, your repository now looks like you made your changes after
 all the other changes.
 </p>