[jboss-user] [EJB3] - How to release the EJB3 tutorials and EJB3 reference guide

[Administrator Administrator]

Administrator Administrator [http://community.jboss.org/people/admin] modified the document:

"How to release the EJB3 tutorials and EJB3 reference guide"

To view the document, visit: http://community.jboss.org/docs/DOC-13320

--------------------------------------------------------------
This wiki explains the steps required to generate/package the EJB3 tutorial source, the tutorial guide and the reference guide.

h4. Tutorials:

To *generate* the tutorial deliverable (.zip/.tar.gz):

1) Checkout the tutorials from the EJB3 trunk

svn co https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk/docs/tutorial/

2) Ensure that you have set MAVEN_HOME to point to 2.0.9 version of Maven and ANT_HOME to 1.7 version of Ant (Note: The tutorials can be built with Ant and Maven). Also ensure that JBOSS_HOME points to a clean (unmodified) JBossAS-5.0 GA.

4) From the shell/command-prompt, 'cd' to the "tutorial/guide" folder

5) Run

mvn clean compile

This command will generate the guide (in target/docbook sub-folder). This is the guide which the user should use to *run* the tutorials.

6) The final step is to create the distributable. For this 'cd' to the "tutorial/dist" folder and run

ant -f build-dist.xml

Note: The plan was to generate the tutorial distributable(s) using Maven plugin. But because of plugin ordering issues in Maven 2.0.9, this runs into issues[1]. Hence we are going to use Ant to generate the final distributable.

The above command will generate "ejb3-tutorials.zip" and "ejb3-tutorials.tar.gz"  in the "tutorial/dist" folder. Use this to upload on the EJB3 docs site (only QA has permission)

The instructions for *running* the tutorials are in the Readme.txt available in those .zip/.tar.gz files.



h4. Reference Guide :

1) Checkout "reference" from the EJB3 trunk

svn co https://svn.jboss.org/repos/jbossas/projects/ejb3/trunk/docs/reference/

2) Ensure that you have set MAVEN_HOME to point to 2.0.9 version of Maven

3) From the shell/command-prompt, 'cd' to the "reference" folder (the place where you checked out from SVN)

4) Run

mvn clean compile

5) This command will generate the "html" and "html_single" versions of the reference guide under target/docbook subfolder. Use this guide to upload on the EJB3 docs site (only QA has permission).

[1] Maven references:
*  http://www.nabble.com/Plugin-execution-order-incorrect-in-Maven-2.0.9-when-multiple-plugins-are-associated-with-the-same-phase-td21113516.html#a21113516 http://www.nabble.com/Plugin-execution-order-incorrect-in-Maven-2.0.9-when-multiple-plugins-are-associated-with-the-same-phase-td21113516.html#a21113516
*  http://jira.codehaus.org/browse/MNG-3719 http://jira.codehaus.org/browse/MNG-3719
*  http://jira.codehaus.org/browse/MNG-2784 http://jira.codehaus.org/browse/MNG-2784
--------------------------------------------------------------

Comment by going to Community
[http://community.jboss.org/docs/DOC-13320]

Create a new document in EJB3 at Community
[http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2029]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-user/attachments/20110120/f1920c91/attachment.html