You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by sc...@apache.org on 2005/07/06 21:55:47 UTC
svn commit: r209507 - in /myfaces/forrest/trunk/content/xdocs:
community/buildhowto.xml community/versioning.xml index.xml news-archive.xml
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 />
+ © 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. :-)
+ </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/>