gitlab-ci: add make Gallium Drivers RadeonSI build
[mesa.git] / docs / repository.html
index 1fb88bf71737a1f653100d0d6d9fea7a5d326060..10e90fba2edd4ce68f4cd10039067564b27435e2 100644 (file)
 <h1>Code Repository</h1>
 
 <p>
-Mesa uses <a href="http://git-scm.com">git</a>
+Mesa uses <a href="https://git-scm.com">git</a>
 as its source code management system.
 </p>
 
 <p>
 The master git repository is hosted on
-<a href="http://www.freedesktop.org">freedesktop.org</a>.
+<a href="https://www.freedesktop.org">freedesktop.org</a>.
 </p>
 
 <p>
@@ -35,9 +35,9 @@ You may access the repository either as an
 
 <p>
 You may also 
-<a href="http://cgit.freedesktop.org/mesa/mesa/"
+<a href="https://gitlab.freedesktop.org/mesa/mesa"
 >browse the main Mesa git repository</a> and the
-<a href="http://cgit.freedesktop.org/mesa/demos"
+<a href="https://gitlab.freedesktop.org/mesa/demos"
 >Mesa demos and tests git repository</a>.
 </p>
 
@@ -52,7 +52,7 @@ To get the Mesa sources anonymously (read-only):
 <li>Install the git software on your computer if needed.<br><br>
 <li>Get an initial, local copy of the repository with:
     <pre>
-    git clone git://anongit.freedesktop.org/git/mesa/mesa
+    git clone https://gitlab.freedesktop.org/mesa/mesa.git
     </pre>
 <li>Later, you can update your tree from the master repository with:
     <pre>
@@ -60,7 +60,7 @@ To get the Mesa sources anonymously (read-only):
     </pre>
 <li>If you also want the Mesa demos/tests repository:
     <pre>
-    git clone git://anongit.freedesktop.org/git/mesa/demos
+    git clone https://gitlab.freedesktop.org/mesa/demos.git
     </pre>
 </ol>
 
@@ -73,7 +73,7 @@ follow this procedure:
 </p>
 <ol>
 <li>Subscribe to the
-<a href="http://lists.freedesktop.org/mailman/listinfo/mesa-dev">mesa-dev</a>
+<a href="https://lists.freedesktop.org/mailman/listinfo/mesa-dev">mesa-dev</a>
 mailing list.
 <li>Start contributing to the project by
 <a href="submittingpatches.html" target="_parent">submitting patches</a> to
@@ -92,36 +92,29 @@ only if they're being supervised by another Mesa developer at the same
 organization and planning to work in a limited area of the code or on a
 separate branch.
 <li>To apply for an account, follow
-<a href="http://www.freedesktop.org/wiki/AccountRequests">these directions</a>.
+<a href="https://www.freedesktop.org/wiki/AccountRequests">these directions</a>.
 It's also appreciated if you briefly describe what you intend to do (work
 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>
 
 <p>
-If you're <a href="http://git.wiki.kernel.org/index.php/WindowsInstall">
+If you're <a href="https://git.wiki.kernel.org/index.php/WindowsInstall">
 using git on Windows</a> you'll want to enable automatic CR/LF conversion in
 your local copy of the repository:
 </p>
@@ -144,17 +137,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, the trunk contains the latest development (unstable)
+Generally, <tt>master</tt> 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>
@@ -235,7 +228,7 @@ If you want the rebase action to be the default action, then
     git config --global branch.autosetuprebase=always
 </pre>
 <p>
-See <a href="http://www.eecs.harvard.edu/~cduan/technical/git/">Understanding Git Conceptually</a> for a fairly clear explanation about all of this.
+See <a href="https://www.eecs.harvard.edu/~cduan/technical/git/">Understanding Git Conceptually</a> for a fairly clear explanation about all of this.
 </p>
 </ol>