river-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache River: Source Code (page edited)
Date Fri, 03 Apr 2009 23:10:00 GMT
Source Code (RIVER) edited by Jukka Zitting
      Page: http://cwiki.apache.org/confluence/display/RIVER/Source+Code
   Changes: http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=72559&originalVersion=4&revisedVersion=5






Content:
---------------------------------------------------------------------

h1. River source code

River uses [Subversion|http://subversion.tigris.org/] to manage its source code. Instructions
on Subversion use can be found [here|http://svnbook.red-bean.com].

The source code for the various deliverables of Apache River can be freely browsed at [http://svn.apache.org/viewvc/incubator/river/].


h2. Anonymous access

The Apache River source can be checked out anonymously with this command (for the jtsk deliverable):

{noformat}
svn checkout http://svn.apache.org/repos/asf/incubator/river/jtsk/trunk river
{noformat}

h2. Access from behind a firewall

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 HTTPS:

{noformat}
svn checkout https://svn.apache.org/repos/asf/incubator/river/jtsk/trunk river
{noformat}

h2. Access through a proxy

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 use. The files location depends on
your operating system. On Linux or Unix it is located in the directory "~/.subversion". On
Windows it is in "%APPDATA%\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 that file, get the
latest Subversion client and run any command; this will cause the configuration directory
and template files to be created.

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

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

h2. Submitting a Patch

If you make changes to River, and would like to contribute the to the project, you should
create a patch and post it to the [River JIRA issue tracker|http://issues.apache.org/jira/browse/RIVER].
To create a patch, simply execute the following command:

{noformat}
svn diff > your-changes.patch
{noformat}

If you've added new files, remember to "svn add" them so they get included in the diff.

h2. Developer Access

Everyone can access the River Subversion repository via HTTPS, but River Committers must checkout
the Subversion repository via HTTPS.

{noformat}
svn checkout https://svn.apache.org/repos/asf/incubator/river/jtsk/trunk river
{noformat}

To commit changes to the repository, 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 following command
to commit your changes (svn will prompt you for your password)

{noformat}
svn commit --username your-username
Authentication realm: <https://svn.apache.org:443> ASF Committers
Password for 'your-username': your-password
{noformat}

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 are available via the ps command).
Here is the command if you are Windows or a single user unix computer:

{noformat}
svn commit --username your-username --password your-password
{noformat}

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



---------------------------------------------------------------------
CONFLUENCE INFORMATION
This message is automatically generated by Confluence

Unsubscribe or edit your notifications preferences
   http://cwiki.apache.org/confluence/users/viewnotifications.action

If you think it was sent incorrectly contact one of the administrators
   http://cwiki.apache.org/confluence/administrators.action

If you want more information on Confluence, or have a bug to report see
   http://www.atlassian.com/software/confluence



Mime
View raw message