myfaces-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sc...@apache.org
Subject svn commit: r209507 - in /myfaces/forrest/trunk/content/xdocs: community/buildhowto.xml community/versioning.xml index.xml news-archive.xml
Date Wed, 06 Jul 2005 19:55:47 GMT
Author: schof
Date: Wed Jul  6 12:55:44 2005
New Revision: 209507

URL: http://svn.apache.org/viewcvs?rev=209507&view=rev
Log:
added revised svn documentation and placeholder for build documentation

Added:
    myfaces/forrest/trunk/content/xdocs/community/buildhowto.xml
Modified:
    myfaces/forrest/trunk/content/xdocs/community/versioning.xml
    myfaces/forrest/trunk/content/xdocs/index.xml
    myfaces/forrest/trunk/content/xdocs/news-archive.xml

Added: myfaces/forrest/trunk/content/xdocs/community/buildhowto.xml
URL: http://svn.apache.org/viewcvs/myfaces/forrest/trunk/content/xdocs/community/buildhowto.xml?rev=209507&view=auto
==============================================================================
--- myfaces/forrest/trunk/content/xdocs/community/buildhowto.xml (added)
+++ myfaces/forrest/trunk/content/xdocs/community/buildhowto.xml Wed Jul  6 12:55:44 2005
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "document-v12.dtd">
+
+<document>
+
+<header>
+    <title>Apache MyFaces - Subversion Access</title>
+</header>
+
+<body>
+
+<section>
+<title>Building the MyFaces Source</title>
+    <p>
+        MyFaces uses Ant to build from the source.  Click <link href="http://ant.apache.org">here</link>
for more information on 
+        Apache Ant.  These instructions also assume you have already checked out the source
code.  If you have not done this, please 
+        see the SVN instructions <link href="versioning.html">here</here>.
+    </p>
+    <p>
+        There are two ways to build MyFaces.  The first is from the "top level" build directory
which is used to build "all" of the 
+        subprojects in the correct order.  The other method is to build one or more subprojects
directly.
+    </p>
+    
+    <table>
+        <tr>
+            <th>If you need ...</th>
+            <th>Use ...</th>
+        </tr>
+        <tr>
+            <td>
+                <strong>The latest source code for all relevant subprojects.</strong>
 This includes the MyFaces JSF implementation as well as 
+                the Tomahawk components and other goodies.  Also includes the example web
applications and sandbox components.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/repos/asf/myfaces/current</code>
+            </td>
+        </tr>    
+        <tr>
+            <td>
+                <strong>The source code for the MyFaces implementation only.</strong>
 Does not include the tomahawk subproject or any of the 
+                examples.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/repos/asf/myfaces/core</code>
+            </td>
+        </tr>            
+        <tr>
+            <td>
+                <strong>The source code for the Tomahawk subproject without any JSF
implementation stuff.</strong>  Ideal for those who 
+                use the RI and want to provide a quick patch to an existing tomahawk component.
 This requires that you 
+                provide your own JSF implementation.  If you are using MyFaces as your JSF
implementation it does not make 
+                much sense to use this option.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/repos/asf/myfaces/tomahawk-only</code>
+            </td>
+        </tr>    
+        <tr>
+            <td>
+                <strong>The xdocs used to build the MyFaces website.</strong>
 This is intended for committers only.  
+                Contains the forrest xdocs and build script used to build the website.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/viewcvs.cgi/myfaces/forrest/trunk</code>
+            </td>
+        </tr>            
+        <tr>
+            <td>
+                <strong>The source code in its original layout before the SVN reorg.</strong>
 This is meant for troubleshooting purposes only.  
+                Do not use this to submit patches or check in code.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/viewcvs.cgi/myfaces/legacy/tags/before_svn_reorg/</code>
+            </td>
+        </tr>               
+    </table>
+    <p>
+        <br/>
+        The source code can also be viewed online <link href="http://svn.apache.org/viewcvs.cgi/myfaces/">here</link>

+        using viewcvs.  
+    </p>    
+
+</section>
+
+</body>
+    
+<footer>
+    	<legal>Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems,
Inc. in the United States and other countries.<br />
+	&copy; 2004, Apache Software Foundation
+	</legal>
+</footer>
+
+</document>

Modified: myfaces/forrest/trunk/content/xdocs/community/versioning.xml
URL: http://svn.apache.org/viewcvs/myfaces/forrest/trunk/content/xdocs/community/versioning.xml?rev=209507&r1=209506&r2=209507&view=diff
==============================================================================
--- myfaces/forrest/trunk/content/xdocs/community/versioning.xml (original)
+++ myfaces/forrest/trunk/content/xdocs/community/versioning.xml Wed Jul  6 12:55:44 2005
@@ -17,12 +17,66 @@
         repositories.
     </p>
     <p>
-        <br/>        
-        Use the following command to get the latest source code:
+        The MyFaces source code is broken up into several subprojects.  Do <strong>not</strong>
checkout everything in the MyFaces directory 
+        (you will get every copy of every file ever checked into the repository!)  The MyFaces
developers rely on a SVN trick known 
+        as "externals."  These allow you to checkout (and update) the latest code from multiple
subprojects with a single SVN command.  
+        Use one of the commands below depending on your source code needs.
     </p>
+    
+    <table>
+        <tr>
+            <th>If you need ...</th>
+            <th>Use ...</th>
+        </tr>
+        <tr>
+            <td>
+                <strong>The latest source code for all relevant subprojects.</strong>
 This includes the MyFaces JSF implementation as well as 
+                the Tomahawk components and other goodies.  Also includes the example web
applications and sandbox components.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/repos/asf/myfaces/current</code>
+            </td>
+        </tr>    
+        <tr>
+            <td>
+                <strong>The source code for the MyFaces implementation only.</strong>
 Does not include the tomahawk subproject or any of the 
+                examples.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/repos/asf/myfaces/core</code>
+            </td>
+        </tr>            
+        <tr>
+            <td>
+                <strong>The source code for the Tomahawk subproject without any JSF
implementation stuff.</strong>  Ideal for those who 
+                use the RI and want to provide a quick patch to an existing tomahawk component.
 This requires that you 
+                provide your own JSF implementation.  If you are using MyFaces as your JSF
implementation it does not make 
+                much sense to use this option.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/repos/asf/myfaces/tomahawk-only</code>
+            </td>
+        </tr>    
+        <tr>
+            <td>
+                <strong>The xdocs used to build the MyFaces website.</strong>
 This is intended for committers only.  
+                Contains the forrest xdocs and build script used to build the website.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/viewcvs.cgi/myfaces/forrest/trunk</code>
+            </td>
+        </tr>            
+        <tr>
+            <td>
+                <strong>The source code in its original layout before the SVN reorg.</strong>
 This is meant for troubleshooting purposes only.  
+                Do not use this to submit patches or check in code.
+            </td>
+            <td>
+                <code>svn co https://svn.apache.org/viewcvs.cgi/myfaces/legacy/tags/before_svn_reorg/</code>
+            </td>
+        </tr>               
+    </table>
     <p>
-        <code>svn checkout http://svn.apache.org/repos/asf/myfaces/current myfaces-current</code>
-    </p>
     <p>
         <br/>
         The source code can also be viewed online <link href="http://svn.apache.org/repos/asf/myfaces">here</link>.
 

Modified: myfaces/forrest/trunk/content/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/myfaces/forrest/trunk/content/xdocs/index.xml?rev=209507&r1=209506&r2=209507&view=diff
==============================================================================
--- myfaces/forrest/trunk/content/xdocs/index.xml (original)
+++ myfaces/forrest/trunk/content/xdocs/index.xml Wed Jul  6 12:55:44 2005
@@ -20,6 +20,18 @@
     </section>
 
     <section>
+        <title>July 5, 2005 - MyFaces SVN reorg is complete</title>
+        <p>
+            We have recently completed a reorganization of the MyFaces project in the Subversion
(SVN) repository.  Several 
+            new subprojects have been created and a new build procedure has been implemented.
 There are new SVN instructions 
+            available <link href="community/versioning.html">here</link> and
new build instructions available 
+            <link href="community/buildhowto.html">here</link>.  As a result
of the reorg, the nightly builds and updated javadocs 
+            are not available from this site.  We hope to bring them online shortly.  Please
be patient while we gradually 
+            recover from the move.  &nbsp;  :-)
+        </p>
+    </section>
+    
+    <section>
         <title>May 23, 2005 - Upcoming MyFaces sessions</title>
         <p>
             The MyFaces committers will be presenting their framework at <link href="http://java.sun.com/javaone/">JavaOne</link>

@@ -35,32 +47,7 @@
             <link href="community/versioning.html">here </link> for more details
on how to access the source code.  
         </p>
     </section>
-    
-    <section>
-        <title>April 16, 2005 - MyFaces 1.0.9(m9) has been released</title>
-        <p>
-            MyFaces 1.0.9(m9) is now available.  The (m9) stands for milestone 9.  The license
agreement covering JSF and all other JCP based
-            specifications require that we use this terminology and avoid the word "final."
 Once MyFaces passes the TCK we will be able to
-            refer to our releases as final.  This is one of the reasons why we initially
pulled the release announcement from the website a
-            few days ago.  But the release is official now and is available through your
nearest Apache mirror.  Enjoy!
-        </p>
-    </section>
-
-    <section>
-        <title>April 5, 2005 - MyFaces 1.0.9 RC3 now available</title>
-        <p>
-            MyFaces 1.0.9 RC3 is now available <link href="http://cvs.apache.org/builds/myfaces/release">here</link>.
-            Please help us prepare for the official release by testing and providing feedback.
 If you think you have found a
-            bug, please report it <link href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10600">here</link>.
-        </p>
-    </section>
-    <section>
-        <title>April 1, 2005 - Nightly builds are now available</title>
-        <p>
-            Nightly builds are now available <link href="http://cvs.apache.org/builds/myfaces/nightly">here</link>.
 Go ahead and download
-            them if you wish to use the latest and greatest source code before the next official
release.
-        </p>
-    </section>
+   
     <section>
         <title>Resources</title>
         <p>If you are new to JavaServer Faces Technology look at the following resources
to become familar with JSF:</p>

Modified: myfaces/forrest/trunk/content/xdocs/news-archive.xml
URL: http://svn.apache.org/viewcvs/myfaces/forrest/trunk/content/xdocs/news-archive.xml?rev=209507&r1=209506&r2=209507&view=diff
==============================================================================
--- myfaces/forrest/trunk/content/xdocs/news-archive.xml (original)
+++ myfaces/forrest/trunk/content/xdocs/news-archive.xml Wed Jul  6 12:55:44 2005
@@ -6,6 +6,30 @@
   </header>
   <body>
     <section>
+        <title>April 16, 2005 - MyFaces 1.0.9(m9) has been released</title>
+        <p>
+            MyFaces 1.0.9(m9) is now available.  The (m9) stands for milestone 9.  The license
agreement covering JSF and all other JCP based
+            specifications require that we use this terminology and avoid the word "final."
 Once MyFaces passes the TCK we will be able to
+            refer to our releases as final.  This is one of the reasons why we initially
pulled the release announcement from the website a
+            few days ago.  But the release is official now and is available through your
nearest Apache mirror.  Enjoy!
+        </p>
+    </section>
+    <section>
+        <title>April 5, 2005 - MyFaces 1.0.9 RC3 now available</title>
+        <p>
+            MyFaces 1.0.9 RC3 is now available <link href="http://cvs.apache.org/builds/myfaces/release">here</link>.
+            Please help us prepare for the official release by testing and providing feedback.
 If you think you have found a
+            bug, please report it <link href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10600">here</link>.
+        </p>
+    </section>
+    <section>
+        <title>April 1, 2005 - Nightly builds are now available</title>
+        <p>
+            Nightly builds are now available <link href="http://cvs.apache.org/builds/myfaces/nightly">here</link>.
 Go ahead and download
+            them if you wish to use the latest and greatest source code before the next official
release.
+        </p>
+    </section>      
+    <section>
         <title>February 24, 2005 - MyFaces is Hot</title>
         <note label="David Geary (JSF Author and Creator of Tiles) Blogs on MyFaces">
             MyFaces is Hot<br/><br/>



Mime
View raw message