portals-jetspeed-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From vku...@apache.org
Subject svn commit: r711317 - in /portals/jetspeed-2/portal/trunk/src/site: site.xml xdoc/developers.xml xdoc/getting-started.xml xdoc/jetspeed-eclipse.xml
Date Tue, 04 Nov 2008 17:09:22 GMT
Author: vkumar
Date: Tue Nov  4 09:09:22 2008
New Revision: 711317

URL: http://svn.apache.org/viewvc?rev=711317&view=rev
Log:
Updating few more docs for maven2

Modified:
    portals/jetspeed-2/portal/trunk/src/site/site.xml
    portals/jetspeed-2/portal/trunk/src/site/xdoc/developers.xml
    portals/jetspeed-2/portal/trunk/src/site/xdoc/getting-started.xml
    portals/jetspeed-2/portal/trunk/src/site/xdoc/jetspeed-eclipse.xml

Modified: portals/jetspeed-2/portal/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/site.xml?rev=711317&r1=711316&r2=711317&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/site.xml (original)
+++ portals/jetspeed-2/portal/trunk/src/site/site.xml Tue Nov  4 09:09:22 2008
@@ -45,8 +45,6 @@
     <menu name="Building">
         <item name="From Source with Maven-2" href="maven-2-build.html" />
         <item name="From Maven-2 Plugin" href="maven-2-custom.html" />    	    
-        <item name="From Source with Maven-1 (deprecated)" href="getting-started-source.html"
/>
-        <item name="From Maven-1 Plugin (deprecated)" href="getting-started-binary.html"
/>
         <item name="From Eclipse" href="jetspeed-eclipse.html" />            
     </menu>
     <menu name="Configuring Jetspeed-2">

Modified: portals/jetspeed-2/portal/trunk/src/site/xdoc/developers.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/developers.xml?rev=711317&r1=711316&r2=711317&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/developers.xml (original)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/developers.xml Tue Nov  4 09:09:22 2008
@@ -1,20 +1,18 @@
 <?xml version="1.0"?>
-<!--
-	Licensed to the Apache Software Foundation (ASF) under one or more
-	contributor license agreements.  See the NOTICE file distributed with
-	this work for additional information regarding copyright ownership.
-	The ASF licenses this file to You under the Apache License, Version 2.0
-	(the "License"); you may not use this file except in compliance with
-	the License.  You may obtain a copy of the License at
-	
-	http://www.apache.org/licenses/LICENSE-2.0
-	
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
--->
+	<!--
+		Licensed to the Apache Software Foundation (ASF) under one or more
+		contributor license agreements. See the NOTICE file distributed with
+		this work for additional information regarding copyright ownership.
+		The ASF licenses this file to You under the Apache License, Version
+		2.0 (the "License"); you may not use this file except in compliance
+		with the License. You may obtain a copy of the License at
+		http://www.apache.org/licenses/LICENSE-2.0 Unless required by
+		applicable law or agreed to in writing, software distributed under the
+		License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+		CONDITIONS OF ANY KIND, either express or implied. See the License for
+		the specific language governing permissions and limitations under the
+		License.
+	-->
 <document>
 	<properties>
 		<title>Jetspeed for Developers</title>
@@ -26,78 +24,98 @@
 	</properties>
 	<body>
 		<section name="Jetspeed For Developers">
+			<p> When developing with Jetspeed, you may be creating portlet
+				applications, or building and creating extensions to the Jetspeed
+				portal. If you ar going to be creating portlet applications, check
+				out this fine e-book for an overall guide to writing portlets:</p>
+			<ul>
+				<li>
+					<a href='http://www.manning.com/hepper/' target='_blank'>Portlets
+						and Apache Portals Book</a>
+				</li>
+			</ul>
+			<h2>Custom Building with Maven2 and Eclipse</h2>
 			<p>
-When developing with Jetspeed, you may be creating portlet applications, or building and
creating extensions to the Jetspeed portal.
-If you ar going to be creating portlet applications, check out this fine e-book for an overall
guide to writing portlets:
+				If you have never used Maven before, the easiest build option for
+				you may be to build with the Ant-Eclipse Build. This build allows
+				you to build a custom portal with Ant. We also provide a custom
+				installer builder. For your portlet applications, we provide Eclipse
+				WTP support. Although the actual programming tutorial is incomplete,
+				the tutorial describing building with Ant and Eclipse is completed.
+				For version 2.1.3, this is the recommended
+				<b>quickest</b>
+				build for getting custom projects up and running in no time.
 			</p>
-<ul>
-<li><a href='http://www.manning.com/hepper/' target='_blank'>Portlets and Apache
Portals Book</a></li>
-</ul>
-
-<h2>Custom Building with Ant and Eclipse</h2>
-<p>If you have never used Maven before, the easiest build option for you may be to
build with the Ant-Eclipse Build.
-This build allows you to build a custom portal with Ant. We also provide a custom installer
builder.
-For your portlet applications, we provide Eclipse WTP support. Although the actual programming
tutorial is incomplete, the tutorial describing 
-building with Ant and Eclipse is completed. For version 2.1.3, this is the recommended <b>quickest</b>
 build for getting custom projects up and running in no time.
-</p>
-<li><a href='http://portals.apache.org/tutorials/jetspeed-2-ant/' target='_blank'>Jetspeed
Tutorial - Building a Custom Portal with Ant and Eclipse</a></li>
-
-<h2>Custom Building with Maven Plugins</h2>
-<p>Jetspeed 2.1 can be built with either Maven-1 or Maven-2.
-You can actually build your own portal without the Jetspeed source. 
-You will want to customize your Jetspeed build, overriding the skins and themes, adding your
own portlet applications and perhaps overriding
-key components of the portal. To do so, we provide three custom build frameworks: one with
Maven-1, the second with Maven-2, the third and newest with Ant and Eclipse.
-With the custom build, you can easily build and create your own Jetspeed powered portal without
ever building Jetspeed itself.</p>
-<p>
-Many developers still prefer Maven-1. If you are new to Maven, then maybe its best to go
with the new version (2).
-</p>
-<h3>Maven-2 Custom build</h3>
-<ul>
-<li><a href='http://portals.apache.org/tutorials/jetspeed-2/' target='_blank'>Jetspeed
Tutorial - Building a Custom Portal with the Maven-2 Plugin</a></li>
-<li><a href='maven-2-custom.html' target='_blank'>Building a Custom Portal with
the Maven-2 Plugin</a></li>
-</ul>
-<h3>Maven-1 Custom build (deprecated)</h3>
-<ul>
-<li><a href='getting-started-binary.html' target='_blank'>Building a Custom Portal
with the Maven-1 Plugin</a></li>
-<li><a href='j2-maven-plugin.html' target='_blank'>Maven-1 Plugin Documentation</a></li>
-</ul>
-<h3>Future Directions: Jetspeed 2.2</h3>
-<p>With the next major release version 2.2, the current Maven2 build will be deprecated,
and replaced with a new Maven2 build.
-The Maven1 build will be completely dropped.
-</p>
-<h2>Building from Source</h2>
-<p>If you need to build the source, here are the guides:</p>
-<ul>
-<li><a href='maven-2-build.html' target='_blank'>Building Jetspeed from Source
with Maven-2</a></li>
-<li><a href='getting-started-binary.html' target='_blank'>Building Jetspeed Source
with Maven-1</a></li>
-
-</ul>
-<p>
-Jetspeed is built from the command line with Maven. However, you can still develop, compile,
debug, remote debug, all from within Eclipse.
-Eclipse is a good tool for developing portlet applications as well as Jetspeed extensions.
-</p>
-<ul>
-<li><a href='jetspeed-eclipse.html' target='_blank'>Developing with Eclipse</a></li>
-</ul>
-<p>
-To get the binary installation of an official Jetspeed release, go here:
-</p>
-<ul>
-<li><a href='download.html' target='_blank'>Getting the Binary Installer</a></li>
-</ul>
-<p>
-You can checkout from the SVN HEAD from here:
-</p>
-<ul>
-<li><a href='http://svn.apache.org/repos/asf/portals/jetspeed-2/trunk/' target='_blank'>Checking
out the Source Code from Subversion</a></li>
-</ul>
-<p>
-Get your Javadocs here:
-</p>
-<ul>
-<li><a href='http://www.bluesunrise.com/portlet-api/index.html' target='_blank'>Portlet
API Docs</a></li>
-<li><a href='http://portals.apache.org/jetspeed-2/multiproject/jetspeed-api/apidocs/index.html'
target='_blank'>Jetspeed API Docs</a></li>
-</ul>			
+			<li>
+				<a href='http://portals.apache.org/tutorials/jetspeed-2-ant/'
+					target='_blank'>Jetspeed Tutorial - Building a Custom Portal with
+					Ant and Eclipse</a>
+			</li>
+			<h2>Custom Building with Maven Plugins</h2>
+			<p>Jetspeed 2.1 can be built with Maven-2.
+				You can actually build your own portal without the Jetspeed source.
+				You will want to customize your Jetspeed build, overriding the skins
+				and themes, adding your own portlet applications and perhaps
+				overriding key components of the portal. To do so, we provide two most popular build
frameworks e.g maven2 and Ant with eclipse.
+				With the custom build, you can easily build and create your own Jetspeed powered portal
+				without ever building Jetspeed itself.</p>
+			<h3>Maven-2 Custom build</h3>
+			<ul>
+				<li>
+					<a href='http://portals.apache.org/tutorials/jetspeed-2/' target='_blank'>
+						Jetspeed Tutorial - Building a Custom Portal with the Maven-2
+						Plugin</a>
+				</li>
+				<li>
+					<a href='maven-2-custom.html' target='_blank'>Building a Custom
+						Portal with the Maven-2 Plugin</a>
+				</li>
+			</ul>
+			<h2>Building from Source</h2>
+			<p>If you need to build the source, here are the guides:</p>
+			<ul>
+				<li>
+					<a href='maven-2-build.html' target='_blank'>Building Jetspeed
+						from Source with Maven-2</a>
+				</li>
+			</ul>
+			<p> Jetspeed is built from the command line with Maven. However, you
+				can still develop, compile, debug, remote debug, all from within
+				Eclipse. Eclipse is a good tool for developing portlet applications
+				as well as Jetspeed extensions.</p>
+			<ul>
+				<li>
+					<a href='jetspeed-eclipse.html' target='_blank'>Developing with
+						Eclipse</a>
+				</li>
+			</ul>
+			<p> To get the binary installation of an official Jetspeed release,
+				go here:</p>
+			<ul>
+				<li>
+					<a href='download.html' target='_blank'>Getting the Binary
+						Installer</a>
+				</li>
+			</ul>
+			<p> You can checkout from the SVN HEAD from here:</p>
+			<ul>
+				<li>
+					<a href='http://svn.apache.org/repos/asf/portals/jetspeed-2/portal/trunk/'
+						target='_blank'>Checking out the Source Code from Subversion</a>
+				</li>
+			</ul>
+			<p> Get your Javadocs here:</p>
+			<ul>
+				<li>
+					<a href='http://www.bluesunrise.com/portlet-api/index.html'
+						target='_blank'>Portlet API Docs</a>
+				</li>
+				<li>
+					<a
+						href='http://portals.apache.org/jetspeed-2/multiproject/jetspeed-api/apidocs/index.html'
+						target='_blank'>Jetspeed API Docs</a>
+				</li>
+			</ul>
 		</section>
 	</body>
 </document>
\ No newline at end of file

Modified: portals/jetspeed-2/portal/trunk/src/site/xdoc/getting-started.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/getting-started.xml?rev=711317&r1=711316&r2=711317&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/getting-started.xml (original)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/getting-started.xml Tue Nov  4 09:09:22
2008
@@ -34,10 +34,11 @@
 				<a href="http://maven.apache.org">Apache Maven</a>
 				project management tool.
 			</p>
+			<ul>
 				<li>
 					<a
 						href="http://maven.apache.org/download.html">
-						Maven 2.x.x
+						Maven 2.0.9
 					</a>
 				</li>
 				<li>Java 1.4.2_02 or higher</li>

Modified: portals/jetspeed-2/portal/trunk/src/site/xdoc/jetspeed-eclipse.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/src/site/xdoc/jetspeed-eclipse.xml?rev=711317&r1=711316&r2=711317&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/src/site/xdoc/jetspeed-eclipse.xml (original)
+++ portals/jetspeed-2/portal/trunk/src/site/xdoc/jetspeed-eclipse.xml Tue Nov  4 09:09:22
2008
@@ -36,37 +36,26 @@
                 Eclipse provides a .classpath GUI editor from the Project->Properties
menu option. 
             </p>
 			</subsection>
-			<subsection name="JAR files and the Maven-1 repository">
+			<subsection name="JAR files and the Maven-2 repository">
 				<p>
                   Jetspeed requires quite a few JAR files to be able to compile.
-                  The .classpath file that comes with Jetspeed is setup to get its JAR files
out of a local Maven-1 repository.
+                  The .classpath file that comes with Jetspeed is setup to get its JAR files
out of a local Maven-2 repository.
                   You can see all the JAR file dependencies from Eclipse. Go to Project->Properties->Java
Build Path->Libraries.
                   Notice all the JAR files are configured as VARIABLE library entries.
                   Take one example: 
 					<source>
-                    MAVEN_REPO/commons-lang/jars/commons-lang-2.0.jar                   
        
+                    M2_REPO/commons-lang/jars/commons-lang-2.0.jar                      
     
 					</source>                    
-                  The Variable is portion is MAVEN_REPO.
+                  The Variable is portion is M2_REPO.
                   The Extension portion is /commons-lang/jars/commons-lang-2.0.jar
                   Eclipse locates the JAR dependency from a Variable location root.
-                  In order for this classpath to work correctly, the variable root is dependent
on a Maven-1 local repository file structure.                  
+                  In order for this classpath to work correctly, the variable root is dependent
on a Maven-2 local repository file structure.                  
 				</p>
 				<p>
-                    To configure the MAVEN_REPO variable, go to Window->Preferences->Java->Build
Path->Classpath Variables,
-                    click on New, and define a new variable named MAVEN_REPO, pointing it
out the root of your local Maven-1 repository,
-                    usually someplace like your $HOME/.maven/repository. 
-				</p>
-			</subsection>
-			<subsection name="JAR files and the Maven-2 repository">
-			   <p>The same procedure applies for working a local Maven-2 repository. 
-			   We provide an alternative .classpath file found in the source code under <b>etc/editors/m2.classpath</b>.
-			   Copy m2.classpath over the .classpath file in the project root.
-			   </p>
-			   <p>This classpath requires a different Eclipse classpath variable: M2_REPO.
-			   To configure the M2_REPO variable, go to Window->Preferences->Java->Build
Path->Classpath Variables,
+                    To configure the M2_REPO variable, go to Window->Preferences->Java->Build
Path->Classpath Variables,
                     click on New, and define a new variable named MAVEN_REPO, pointing it
out the root of your local Maven-2 repository,
                     usually someplace like your $HOME/.m2/repository. 
-               </p>
+				</p>
 			</subsection>
 		</section>
 		<section name="Debugging with Eclipse and Tomcat">



---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org


Mime
View raw message