Marek Schmidt created JBSEAM-4987:
-------------------------------------
Summary: Seam2.3.0.Beta2 documentation issues
Key: JBSEAM-4987
URL: https://issues.jboss.org/browse/JBSEAM-4987
Project: Seam 2
Issue Type: Bug
Components: Documentation Issues
Affects Versions: 2.3.0.BETA2
Reporter: Marek Schmidt
Assignee: Marek Novotny
Priority: Critical
Fix For: 2.3.0.CR1
Introduction to JBoss Seam
* Hibernate3
** should be Hibernate4 now
* "Java EE 5" should be updated to Java EE 5 or 6, or just 6 where it makes
sense. Some additional paragraph should be added to the introduction that would
explain how Seam2.3 now works on EE6 server, which part of EE6 it uses, mention
the relation to CDI, etc.
Using the Seam examples
* examples directory is now examples-ee6 (although that should be probably
changed for Final)
* "The example applications run both on JBoss AS and Tomcat with no
additional configuration"
** I don't believe tomcat works ATM, so should be removed
* "Note that all the examples are built and run from the Ant build.xml, so
you'll need a recent version of Ant installed before you get started. "
** should be Maven now
Running the examples on JBoss AS
* "The examples are configured for use on JBoss AS 4.2 or 5.0. "
** Should be "JBoss AS 7.1"
* build and deploy steps should be changed to "mvn clean package" and
$JBOSS_HOME/bin/jboss-cli.sh --connect 'deploy example-ear/target/example.ear'
* "Most of the examples can be deployed as a WAR to Tomcat with Embedded
JBoss by typing ant tomcat.deploy."
** not true anymore AFAIK, should be removed.
Running the examples on Tomcat
* Should be removed, as embedded jboss is no more and the examples have not
been updated for tomcat yet.
Running the example tests
* TestNG should be changed to JUnit.
* Not ant test, but "mvn clean verify -Darquillian=jbossas-managed-7"
1.2.1. Understanding the code
1.2.1.1. The entity bean: User.java
* @Length should be changed to @Size
Example 1.7. web.xml
* web.xml version and schema should be updated to 3.0 and 3_0.xsd
respectively.
1.2.1.7. The JSF configuration: faces-config.xml
* The <application> element with the view-handler should be removed.
* version should be updated to 2.1 (2_1.xsd) (actually, the whole file is not
necessarry, so this section could be removed.
1.2.1.9. The EJB persistence deployment descriptor: persistence.xml
* version should be upgraded to 2.0
* java:/DefaultDS should be changed to java:jboss/datasources/ExampleDS
1.3.1.1. The entity bean: Message.java ... and others
* @Length should be changed to @Size, see also other examples
1.3.1.4. The view: messages.jsp .. and other JSP and JSPX examples
* should be converted to xhtml facelets, as we use JSF2 now, so we should
not recommend JSP. See also other examples.
1.6. A complete Seam application: the Hotel Booking example
* s/Hibernate3/Hibernate4
* Richfaces AJAX examples need to be migrated to richfaces4, see the updated
examples.
2.1. Before you start
* "Make sure you have JDK 5 or JDK 6 (see Section 42.1, “JDK
Dependencies†for details), JBoss AS 4.2 or 5.0 and Ant 1.7.0, along with
recent versions of Eclipse, the JBoss IDE plugin for Eclipse and the TestNG
plugin for Eclipse correctly installed before starting"
** should probably be "JDK 6 or JDK 7 ... JBoss AS 7.1, Maven 3.0.4, ... "
and TestNG plugin is no longer necessary.
* there are other references to JDK5 in the text that should be fixed
2.9. Using Seam with JBoss 4.0
* section should be removed
3.1. Before you start
* "Make sure you have JDK 5, JBoss AS 4.2 or 5.0, Eclipse 3.3"
** dependencies should be updated, (JDK6, AS7.1, )
3.2. Setting up a new Seam project
* Should be updated according to however it works not in the current jboss
tools (at least JBoss AS versions and Seam versions need to be updated in the
text)
16.1.1. Application server configuration
* should be updated to AS7.1, if it is still needed there.
21.3. Configuration
* "The Seam Mail module requires the use of Facelets as the view technology.
Future versions of the library may also support the use of JSP. Additionally,
it requires the use of the seam-ui package. " this note should probably be
removed.
21.4. Meldware
* buni.org is a dead link.
26.4. GWT Ant Targets
* should be updated to Maven
29.2. Configuration
* "It is not longer necessary the register the event listeners if Hibernate
Annotations or EntityManager 3.3.x are used. When using Hibernate Search 3.1.x
more eventlisteners are needed, but these are registered automatically by
Hibernate Annotations; refer to the Hibernate Search reference for configuring
it without EntityManager and Annotations." should be removed then, as we now
have Hibernate4
* "hibernate-commons-annotations.jar is not needed in JBossAS6." should be
removed or updated to AS7
30.1.2. Using Facelets
* not required for JSF2
30.1.5. Integrating Seam with your EJB container
* JNDI names should be updated to those that are true for AS7
30.6. Configuring Seam in Java SE, with JBoss Embedded
* should probably be removed, together with any other jboss
embedded-specific piece of documentation
30.8. Configuring SFSB and Session Timeouts in JBoss AS
* should be updated for AS7
Chapter 35. Clustering and EJB Passivation
* should be updated for AS7
37.2. Integration testing Seam components
* JBoss Embedded parts should probably be removed
Chapter 39. Seam on BEA's Weblogic
Chapter 40. Seam on IBM's WebSphere AS v7
Chapter 41. Seam on GlassFish application server
* Seam2.3 has not been tested on these platforms, so the docs should at
least have a note that this part has not been updated to Seam2.3 and it has not
been tested.
* Also, the ee5/ example is no longer there, so these guides are pretty much
useless.
Chapter 42. Dependencies
* Should be updated for AS7
42.3. Dependency Management using Maven
* should be updated.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.jboss.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
_______________________________________________
seam-issues mailing list
[email protected]
https://lists.jboss.org/mailman/listinfo/seam-issues
