openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] OpenJPA > Source Code
Date Wed, 11 Aug 2010 14:46:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1810/9/5/_/styles/combined.css?spaceKey=openjpa&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/openjpa/Source+Code">Source
Code</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~drwoods">Donald
Woods</a>
    </h4>
        <div id="versionComment">
        <b>Comment:</b>
        moved Building and Coding Standards links to this page<br />
    </div>
        <br/>
                         <h4>Changes (21)</h4>
                                 
    
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-unchanged" >{excerpt:hidden=true}Source code access{excerpt}
<br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h1.
Overview <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h1.
Source Code <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" >OpenJPA uses <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">[Subversion|http://subversion.tigris.org/]</span>
<span class="diff-added-words"style="background-color: #dfd;">[Subversion|http://subversion.apache.org/]</span>
to manage its source code. Instructions on Subversion use can be found [here|http://svnbook.red-bean.com].
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h1.
Main repository <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Web Access <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
Web Access <br> <br></td></tr>
            <tr><td class="diff-unchanged" >The source code for OpenJPA can be
freely browsed at [http://svn.apache.org/viewvc/openjpa/]. The source code can also be searched
and browsed using Cenqua&#39;s FishEye product at [http://fisheye6.cenqua.com/browse/openjpa].
<br> <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">h<span
class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">2</span><span
class="diff-added-chars"style="background-color: #dfd;">3</span>.</span> Anonymous
access <br></td></tr>
            <tr><td class="diff-unchanged" > <br>OpenJPA source can be checked
out anonymously with this command: <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Once
you have OpenJPA checked out you can update the source by executing the following command
from within the *openjpa* directory. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h3.
Developer Access <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{noformat}
<br>$&gt; svn update <br>{noformat} <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Everyone
can access the OpenJPA Subversion repository via HTTPS, but OpenJPA Committers must checkout
the Subversion repository via HTTPS in order to make updates, which will prompt for your ASF
uid/pwd. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Once
you&#39;ve got the code you&#39;ll probably want to build it; for instructions see
[Building OpenJPA|Building]. <br> <br>h2. Access from behind a firewall <br>
<br>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: <br> <br></td></tr>
            <tr><td class="diff-unchanged" >{noformat} <br>$&gt; svn
checkout https://svn.apache.org/repos/asf/openjpa/trunk openjpa <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h1.
Access through a proxy <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h1.
Compiling Source <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">The
Subversion client can go through a proxy, if you configure it to do so. First, edit your &quot;servers&quot;
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 &quot;~/.subversion&quot;.
On Windows it is in &quot;%APPDATA%\Subversion&quot;. (Try &quot;echo %APPDATA%&quot;,
note this is a hidden directory.) <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Once
you&#39;ve got the code you&#39;ll probably want to build it; for instructions see
[Building]. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">There
are comments in the file explaining what to do. If you don&#39;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. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Example
: Edit the &#39;servers&#39; file and add something like : <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h1.
Source Coding Standards <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">{noformat}
<br>[global] <br>http-proxy-host = your.proxy.name <br>http-proxy-port =
3128 <br>{noformat} <br> <br> <br>h1. Developer Access <br>
<br>Everyone can access the OpenJPA Subversion repository via HTTPS, but OpenJPA Committers
must checkout the Subversion repository via HTTPS. <br> <br>{noformat} <br>$&gt;
svn checkout https://svn.apache.org/repos/asf/openjpa/trunk openjpa <br>{noformat} <br>
<br> <br>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)
<br> <br>{noformat} <br>$&gt; svn commit --username your-username <br>Authentication
realm: &lt;https://svn.apache.org:443&gt; ASF Committers <br>Password for &#39;your-username&#39;:
your-password <br>{noformat} <br> <br> <br>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: <br> <br>{noformat} <br>$&gt;
svn commit --username your-username --password your-password <br>{noformat} <br>
<br> <br>Remember to replace &#39;your-username&#39; and &#39;your-password&#39;
with your actual username and password on svn.apache.org. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">The
community has agreed upon some common code formatting standards, which we request that everyone
follows when contributing patches and checking in changes to the svn repository.  Some of
these are enforced during the build, like 120 character line length by using the Checkstyle
plugin and checking for required ASL 2.0 source headers by using the apache-rat plugin.  Please
checkout the [Coding Standards] page for more details. <br></td></tr>
        </table>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        

<h1><a name="SourceCode-SourceCode"></a>Source Code</h1>

<p>OpenJPA uses <a href="http://subversion.apache.org/" class="external-link" rel="nofollow">Subversion</a>
to manage its source code. Instructions on Subversion use can be found <a href="http://svnbook.red-bean.com"
class="external-link" rel="nofollow">here</a>.</p>

<h3><a name="SourceCode-WebAccess"></a>Web Access</h3>

<p>The source code for OpenJPA can be freely browsed at <a href="http://svn.apache.org/viewvc/openjpa/"
class="external-link" rel="nofollow">http://svn.apache.org/viewvc/openjpa/</a>. The
source code can also be searched and browsed using Cenqua's FishEye product at <a href="http://fisheye6.cenqua.com/browse/openjpa"
class="external-link" rel="nofollow">http://fisheye6.cenqua.com/browse/openjpa</a>.</p>

<h3><a name="SourceCode-Anonymousaccess"></a>Anonymous access</h3>

<p>OpenJPA source can be checked out anonymously with this command:</p>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$&gt; svn checkout http://svn.apache.org/repos/asf/openjpa/trunk openjpa
</pre>
</div></div>


<h3><a name="SourceCode-DeveloperAccess"></a>Developer Access</h3>

<p>Everyone can access the OpenJPA Subversion repository via HTTPS, but OpenJPA Committers
must checkout the Subversion repository via HTTPS in order to make updates, which will prompt
for your ASF uid/pwd.</p>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent
panelContent">
<pre>$&gt; svn checkout https://svn.apache.org/repos/asf/openjpa/trunk openjpa
</pre>
</div></div>


<h1><a name="SourceCode-CompilingSource"></a>Compiling Source</h1>

<p>Once you've got the code you'll probably want to build it; for instructions see <a
href="/confluence/display/openjpa/Building" title="Building">Building</a>.</p>


<h1><a name="SourceCode-SourceCodingStandards"></a>Source Coding Standards</h1>

<p>The community has agreed upon some common code formatting standards, which we request
that everyone follows when contributing patches and checking in changes to the svn repository.
 Some of these are enforced during the build, like 120 character line length by using the
Checkstyle plugin and checking for required ASL 2.0 source headers by using the apache-rat
plugin.  Please checkout the <a href="/confluence/display/openjpa/Coding+Standards" title="Coding
Standards">Coding Standards</a> page for more details.</p>

    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/openjpa/Source+Code">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=23618&revisedVersion=8&originalVersion=7">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/openjpa/Source+Code?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message