anv: fix alignments for uniform buffers
[mesa.git] / docs / repository.html
index adbfcf90914a7bd77bb6ebf7c40554c6e31852f1..e78ffc01fb4a86617008b8471281e75ebfc8f0e3 100644 (file)
@@ -2,21 +2,28 @@
 <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>
 
-<h1>Code Repository</h1>
+<div class="header">
+  The Mesa 3D Graphics Library
+</div>
+
+<iframe src="contents.html"></iframe>
+<div class="content">
+
+<h1>Source Code Repository</h1>
 
 <p>
-Mesa uses <a href="http://git-scm.com"target="_parent">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" target="_parent">freedesktop.org</a>.
+<a href="https://www.freedesktop.org">freedesktop.org</a>.
 </p>
 
 <p>
@@ -28,10 +35,10 @@ You may access the repository either as an
 
 <p>
 You may also 
-<a href="http://cgit.freedesktop.org/mesa/mesa/"
-target="_parent">browse the main Mesa git repository</a> and the
-<a href="http://cgit.freedesktop.org/mesa/demos"
-target="_parent">Mesa demos and tests git repository</a>.
+<a href="https://gitlab.freedesktop.org/mesa/mesa"
+>browse the main Mesa git repository</a> and the
+<a href="https://gitlab.freedesktop.org/mesa/demos"
+>Mesa demos and tests git repository</a>.
 </p>
 
 
@@ -42,65 +49,60 @@ 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>
 
 
 <h2 id="developer">Developer git Access</h2>
 
 <p>
-Mesa developers need to first have an account on
-<a href="http://www.freedesktop.org" target="_parent">freedesktop.org</a>.
-To get an account, please ask Brian or the other Mesa developers for
-permission.
-Then, if there are no objections, follow this
-<a href="http://www.freedesktop.org/wiki/AccountRequests" target="_parent">
-procedure</a>.
-</p>
-
-<p>
-Once your account is established:
+If you wish to become a Mesa developer with gitlab merge privilege, please
+follow this procedure:
 </p>
-
 <ol>
-<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+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>
+<li>Subscribe to the
+<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>.  Specifically,
+<ul>
+<li>Use <a href="https://gitlab.freedesktop.org/">gitlab</a> to create your merge requests.
+<li>Wait for someone to review the code and give you a <code>Reviewed-by</code>
+statement.
+<li>You'll have to rely on another Mesa developer to push your initial patches
+after they've been reviewed.
+</ul>
+<li>After you've demonstrated the ability to write good code and have had
+a dozen or so patches accepted, a maintainer may use their discretion to give
+you access to merge your own code.
 </ol>
 
+<h2>Pushing code to your gitlab account via HTTPS</h2>
+
+<p>Useful for people behind strict proxies</p>
+
+You can use <a href="https://gitlab.freedesktop.org/profile/personal_access_tokens">personal access tokens</a>
+to push over HTTPS if ssh will does not suit your needs.
+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/your~user~name/mesa.git
+</pre>
 
 <h2>Windows Users</h2>
 
 <p>
-If you're <a href="http://git.wiki.kernel.org/index.php/WindowsInstall" target="_parent">
+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>
 <pre>
-   git config --global core.autocrlf true
+git config --global core.autocrlf true
 </pre>
 
 <p>
@@ -110,7 +112,6 @@ and to LF on commit.
 <p>
 Unix users don't need to set this option.
 </p>
-<br>
 
 
 <h2>Development Branches</h2>
@@ -118,17 +119,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, <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>
@@ -140,8 +141,8 @@ If you try to do a pull by just saying<code> git pull </code>
 and git complains that you have not specified a
 branch, try:
 <pre>
-    git config branch.master.remote origin
-    git config branch.master.merge master
+git config branch.master.remote origin
+git config branch.master.merge master
 </pre>
 <p>
 Otherwise, you have to say<code> git pull origin master </code>
@@ -149,7 +150,7 @@ each time you do a pull.
 </p>
 <li>Small changes to master
 <p>
-If you are an experienced git user working on substancial modifications,
+If you are an experienced git user working on substantial modifications,
 you are probably
 working on a separate branch and would rebase your branch prior to
 merging with master.
@@ -160,7 +161,7 @@ unnecessary and distracting branch in master.
 <p>
 If it has been awhile since you've done the initial clone, try
 <pre>
-    git pull
+git pull
 </pre>
 <p>
 to get the latest files before you start working.
@@ -168,8 +169,8 @@ to get the latest files before you start working.
 <p>
 Make your changes and use
 <pre>
-    git add &lt;files to commit&gt;
-    git commit
+git add &lt;files to commit&gt;
+git commit
 </pre>
 <p>
 to get your changes ready to push back into the fd.o repository.
@@ -184,8 +185,8 @@ where you did your last pull and merging it to a point after the other changes.
 <p>
 To avoid this, 
 <pre>
-    git pull --rebase
-    git push
+git pull --rebase
+git push
 </pre>
 <p>
 If you are familiar with CVS or similar system, this is similar to doing a
@@ -193,7 +194,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>
@@ -205,13 +207,14 @@ those before doing the push.
 <p>
 If you want the rebase action to be the default action, then
 <pre>
-    git config branch.master.rebase true
-    git config --global branch.autosetuprebase=always
+git config branch.master.rebase true
+git config --global branch.autosetuprebase=always
 </pre>
 <p>
-See <a href="http://www.eecs.harvard.edu/~cduan/technical/git/" target="_parent">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>
 
+</div>
 </body>
 </html>