Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@geronimo.apache.org
Content-Type: text/plain; charset="iso-8859-1"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
From: scm@geronimo.apache.org
To: scm@geronimo.apache.org
Subject: =?iso-8859-1?q?=5BApache_Geronimo_Wiki=5D_New=3A__GettingSourceCode?=
Date: Fri, 11 Feb 2005 17:18:13 -0000
Message-ID: <20050211171813.35897.17531@minotaur.apache.org>

   Date: 2005-02-11T09:18:12
   Editor: TobyCabot
   Wiki: Apache Geronimo Wiki
   Page: GettingSourceCode
   URL: http://wiki.apache.org/geronimo/GettingSourceCode

   no comment

New Page:

[[TableOfContents]]

=3D Overview =3D

Geronimo uses [http://subversion.tigris.org/ Subversion] to manage its sour=
ce code. =

Instructions on Subversion use can be found [http://svnbook.red-bean.com he=
re].

=3D Web Access =3D

[http://svn.apache.org/viewcvs.cgi/geronimo/trunk/?root=3DApache-SVN]

=3D Anonymous access =3D

Geronimo source can be checked out anonymously with this command:
 {{{
$> svn checkout http://svn.apache.org/repos/asf/geronimo/trunk geronimo
}}}

Once you have Geronimo checked out you can update the source by executing t=
he following command from within the '''geronimo''' directory.

 {{{
$> svn update
}}}

Once you've got the code you'll probably want to build it; for instructions=
 see [wiki:Building Building].

=3D Web access =3D
    =

[http://svn.apache.org/viewcvs.cgi/geronimo/trunk/?root=3DApache-SVN]

=3D Access from behind a firewall =3D

For those users who are stuck behind a corporate firewall which is blocking=
 http access to the Subversion repository, you can try to access it via HTT=
PS:

 {{{
$> svn checkout https://svn.apache.org/repos/asf/geronimo/trunk geronimo
}}}

=3D Access through a proxy =3D

The Subversion client can go through a proxy, if you configure it to do so.=
 First, edit your "servers" configuration file to indicate which proxy to u=
se. The files location depends on your operating system. On Linux or Unix i=
t is located in the directory "~/.subversion". On Windows it is in "%APPDAT=
A%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)

There are comments in the file explaining what to do. If you don't have tha=
t file, get the latest Subversion client and run any command; this will cau=
se the configuration directory and template files to be created.

Example : Edit the 'servers' file and add something like :

 {{{
[global]
http-proxy-host =3D your.proxy.name
http-proxy-port =3D 3128
}}}

=3D Submitting a Patch =3D
    =

If you make changes to Geronimo, and would like to contribute the to the pr=
oject, you should create a patch and post it to the [http://nagoya.apache.o=
rg/jira/secure/BrowseProject.jspa?id=3D10220 Geronimo JIRA issue tracker]. =
 To create a patch, simply execute the following command:

 {{{
$> svn diff > your-changes.patchInstructions on [http://subversion.tigris.o=
rg/ Subversion] use can be found [http://svnbook.red-bean.com here].

=3D Developer Access =3D
    =

Everyone can access the Geronimo Subversion repository via HTTPS, but Geron=
imo Committers must checkout the Subversion repository via HTTPS.
 {{{
$> svn checkout https://svn.apache.org/repos/asf/geronimo/trunk geronimo
}}}
    =

To commit changes to the repository must, you must set your password on the=
 Apache Subversion server.  To set your password, use ssh to connect to svn=
.apache.org, and enter the command '''svnpasswd'''. This will prompt you to=
 enter a svn password of your choice (Pick a safe password).  Now, now your=
 are ready to commit changes using your username/password.  Execute the fol=
lowing command to commit your changes (svn will prompt your for your passwo=
rd)
  {{{
$> svn commit --username your-username
Authentication realm: <https://svn.apache.org:443> ASF Committers
Password for 'your-username': your-password
}}}
    =

You can also pass your password on the command line directly, but this is a=
 security problem on multiuser unix computers (the command line arguments a=
re available via the ps command).  Here is the command if you are Windows o=
r a single user unix computer:
  {{{
$> svn commit --username your-username --password your-password
}}}
    =

Remember to replace 'your-username' and 'your-password' with your actual us=
ername and password on svn.apache.org.