<title>The Source Code Repository</title>

<para>

The <productname>PostgreSQL</productname> source code is stored and managed using the

<productname>Git</productname> version control system. An public mirror of this

is available and updated within a minute of the master repository.

The <productname>PostgreSQL</productname> source code is stored and managed

using the <productname>Git</productname> version control system. A public

mirror of the master repository is available; it is updated within a minute

of any change to the master repository.

</para>

<para>

Our wiki, <ulink

url="http://wiki.postgresql.org/wiki/Working_with_Git"></ulink>,

hasadditional details on working with Git.

hassome discussion on working with Git.

</para>

<para>

Note that building <productname>PostgreSQL</productname> from the source

repository requires reasonably up-to-date versions of <application>bison</>

and <application>flex</>. These tools are not needed to build from a

distribution tarball sincetheir output is included in the file.

You will need Perl as well, but otherwise thetool requirements are the

same.

repository requires reasonably up-to-date versions of <application>bison</>,

<application>flex</>,and <application>Perl</>. These tools are not needed

to build from adistribution tarball sincethe files they are used to build

are included in the tarball. Othertool requirements are the same as shown

in <xref linkend="installation">.

</para>

<sect1 id="git">

<title>Getting The Source Via <productname>Git</></title>

<para>

With <productname>Git</> you will make a copy of the entire code repository

to your local machine, so you will have access to all history and branches

on your local machine, so you will have access to all history and branches

offline. This is the fastest and most flexible way to develop or test

patches.

</para>

<step>

<para>

You will need an installed version of <productname>Git</>, which you can get

from <ulink url="http://git-scm.com"></ulink>. Many systemsalso have a recent

version of <application>Git</> installed by default, or available in their

packagerepository system.

You will need an installed version of <productname>Git</>, which you can

getfrom <ulink url="http://git-scm.com"></ulink>. Many systemsalready

have a recentversion of <application>Git</> installed by default, or

available in theirpackagedistribution system.

</para>

</step>

<step>

<para>

Tobeing using the Git repository, make a clone of the official mirror:

Tobegin using the Git repository, make a clone of the official mirror:

<programlisting>

git clone git://git.postgresql.org/git/postgresql.git

</programlisting>

This will copy the full repository to your local machine, so it may take

a while to complete, especially if you have a slow Internet connection.

The files will be placed in a new subdirectory <filename>postgresql</> of

your current directory.

</para>

<para>

The Git mirror can also be reached via the HTTP protocol in case for example

a firewall is blocking access to the Git protocol. Justreplace the URL

like:

The Git mirror can also be reached via the HTTP protocol, if for example

a firewall is blocking access to the Git protocol. Justchange the URL

prefix to <literal>http</>, as in:

<programlisting>

git clone http://git.postgresql.org/git/postgresql.git

</para>

</step>

</procedure>

<para>

<productname>Git</> can do a lot more things than just fetch the source. For

more information, consult the man pages for the product, orthe website at

<ulink url="http://git-scm.com"></>.

more information, consult the<productname>Git</>man pages, orsee the

website at<ulink url="http://git-scm.com"></>.

</para>

</sect1>