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