docs/repository.html

   1 <HTML>
   2
   3 <TITLE>Code Repository</TITLE>
   4
   5 <link rel="stylesheet" type="text/css" href="mesa.css"></head>
   6
   7 <BODY>
   8
   9 <h1>Code Repository</h1>
  10
  11 <p>
  12 Mesa uses <a href="http://git.or.cz/"target="_parent">git</a>
  13 as its source code management system.
  14 </p>
  15
  16 The master git repository is hosted on
  17 <a href="http://www.freedesktop.org" target="_parent">freedesktop.org</a>.
  18 </p>
  19
  20 <p>
  21 You may access the repository either as an
  22 <a href="#anonymous">anonymous user</a> (read-only) or as a
  23 <a href="#developer">developer</a>
  24 (read/write).
  25 </p>
  26
  27 <p>
  28 You may also
  29 <a href="http://gitweb.freedesktop.org/?p=mesa/mesa.git"
  30 target="_parent">browse the git repository</a>.
  31 </p>
  32
  33
  34 <a name="anonymous">
  35 <H2>Anonymous git Access</H2>
  36
  37 <p>
  38 To get the Mesa sources anonymously (read-only):
  39 </p>
  40
  41 <ol>
  42 <li>Install the git software on your computer if needed.<br><br>
  43 <li>Get an initial, local copy of the repository with:
  44     <pre>
  45     git clone git://anongit.freedesktop.org/git/mesa/mesa
  46     </pre>
  47 <li>Later, you can update your tree from the master repository with:
  48     <pre>
  49     git pull origin
  50     </pre>
  51 </ol>
  52
  53
  54 <a name="developer">
  55 <H2>Developer git Access</H2>
  56
  57 <p>
  58 Mesa developers need to first have an account on
  59 <a href="http://www.freedesktop.org" target="_parent">freedesktop.org</a>.
  60 To get an account, please ask Brian or the other Mesa developers for
  61 permission.
  62 Then, if there are no objections, follow this
  63 <a href="http://www.freedesktop.org/wiki/AccountRequests" target="_parent">
  64 procedure</a>.
  65 </p>
  66
  67 <p>
  68 Once your account is established:
  69 </p>
  70
  71 <ol>
  72 <li>Install the git software on your computer if needed.<br><br>
  73 <li>Get an initial, local copy of the repository with:
  74     <pre>
  75     git clone git+ssh://username@git.freedesktop.org/git/mesa/mesa
  76     </pre>
  77     Replace <em>username</em> with your actual login name.<br><br>
  78 <li>Later, you can update your tree from the master repository with:
  79     <pre>
  80     git pull origin
  81     </pre>
  82 </ol>
  83
  84
  85 <H2>Windows Users</H2>
  86
  87 <p>
  88 If you're <a href="http://git.or.cz/gitwiki/WindowsInstall" target="_parent">
  89 using git on Windows</a> you'll want to enable automatic CR/LF conversion in
  90 your local copy of the repository:
  91 </p>
  92 <pre>
  93    git config --global core.autocrlf true
  94 </pre>
  95
  96 <p>
  97 This will cause git to convert all text files to CR+LF on checkout,
  98 and to LF on commit.
  99 </p>
 100 <p>
 101 Unix users don't need to set this option.
 102 </p>
 103 <br>
 104
 105
 106 <a name="developer">
 107 <H2>Development Branches</H2>
 108
 109 <p>
 110 At any given time, there may be several active branches in Mesa's
 111 repository.
 112 Generally, the trunk contains the latest development (unstable)
 113 code while a branch has the latest stable code.
 114 </p>
 115
 116 <p>
 117 The command <code>git-branch</code> will list all available branches.
 118 </p>
 119
 120 <p>
 121 Questions about branch status/activity should be posted to the
 122 mesa3d-dev mailing list.
 123 </p>
 124
 125
 126 </body>
 127 </html>
 128
 129