[Myfaces Wiki] Update of "FAQ" by SimonKitching

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The following page has been changed by SimonKitching:
http://wiki.apache.org/myfaces/FAQ

The comment on the change is:
Add info about shared project; update 1.1.3 links to 1.1.4

------------------------------------------------------------------------------
  There are various ways, you can send a note in the mailing list of !MyFaces for direct contact with the developers and guidance on what to do, you can put your component into the inofficial !MyFaces sandbox at [http://sourceforge.net/projects/jsf-comp]. There are no strict rules for the participation at the sandbox, all you need is some good components and a sourceforge account. If you have that, send a mail to the maintainers of the project (link can be found at the sourceforge page) for write access to the repository.
  
  [[Anchor(download-other-stuff)]]
+ 
  === Where can I download a sandbox jar? or source code jars? ===
  [#download-other-stuff permlink]
  
+ Binaries of not-yet-released code can be grabbed from the maven build repositories.
- Many things that are not in our official download site can be grabbed from the maven build repositories.
- 
- http://people.apache.org/maven-snapshot-repository/org/apache/myfaces/
+   http://people.apache.org/maven-snapshot-repository/org/apache/myfaces/
+ For example, the sandbox jar is available beneath here:
- 
- For example, the sandbox jar
- http://people.apache.org/maven-snapshot-repository/org/apache/myfaces/tomahawk/tomahawk-sandbox/1.1.*-SNAPSHOT/tomahawk-sandbox-1.1.*-SNAPSHOT.jar         
+  * http://people.apache.org/maven-snapshot-repository/org/apache/myfaces/tomahawk/tomahawk-sandbox/        
- and the shared-impl refactored source jar
- http://people.apache.org/maven-snapshot-repository/org/apache/myfaces/shared/myfaces-shared-impl/*-SNAPSHOT/myfaces-shared-impl-2.0.4-SNAPSHOT-sources.jar   
  
- Source for MyFaces 1.1.3:
+ Source for !MyFaces 1.1.4:
-  *  http://svn.apache.org/repos/asf/myfaces/core/tags/1_1_3/ 
+  *  http://svn.apache.org/repos/asf/myfaces/core/tags/1_1_4/ 
-  *  http://svn.apache.org/repos/asf/myfaces/shared/tags/2_0_1/ 
+  *  http://svn.apache.org/repos/asf/myfaces/shared/tags/2_0_3/ 
  
  Source for Tomahawk 1.1.3:
   *  http://svn.apache.org/repos/asf/myfaces/tomahawk/tags/1_1_3/ 
   *  http://svn.apache.org/repos/asf/myfaces/shared/tags/2_0_2/ 
  
  You can also find builds at this location:
- 
- http://people.apache.org/builds/myfaces/
+   http://people.apache.org/builds/myfaces/
+ 
+ The core 1.1.4 release download available from the Apache site doesn't include -sources jarfiles (useful in IDEs to view source code).
+ The sources jars are available from the maven2 repository directories, however:
+   * http://www.ibiblio.org/maven2/org/apache/myfaces/core/
+   * http://www.ibiblio.org/maven2/org/apache/myfaces/shared/
+ 
+ === What is the "shared" project? ===
+ 
+ If myfaces-core, tomahawk, tobago and trinidad were completely separate projects, then there would be no need for a "shared" code project;
+ each project would maintain its own code in its own namespace. However there would be lots of code duplication and wasted effort. As
+ these projects are all under the "myfaces" umbrella, code that is common to multiple projects can be placed into the "shared" project
+ thus reducing development and maintenance effort, and making the projects more consistent with each other.
+ 
+ However these projects all have separate release cycles, and in addition tomahawk/tobago/trinidad should be runnable on JSF implementations
+ other than myfaces-core. The solution currently in use is a compilation hack that renames the shared class package; the code is renamed to
+ "org.apache.myfaces.shared_impl" for inclusion in the myfaces-impl jarfile, "org.apache.myfaces.shared_tomahawk" for inclusion in the
+ tomahawk jarfile etc. In this manner, each project can be deployed with all the shared support classes it needs (with the right features
+ and fixes) without needing a separate shared jarfile, and without worrying about conflicting definitions of the same class. An upgrade to
+ one of these projects won't affect any other deployed in the same environment.
+ 
+ The shared code has release numbers that are separate from the release numbers of projects that use it. For example, 
+    http://svn.apache.org/repos/asf/myfaces/tomahawk/tags/1_1_3/core/pom.xml
+ shows that tomahawk 1.1.3 has a dependency on version 2.0.2 of the shared project.
+ 
+ Note that file myfaces-impl-1.1.4.jar includes the .class files for the shared project, but myfaces-impl-1.1.4-sources.jar does not include the 
+ matching source files; myfaces-shared-impl-2.0.3.jar needs to be added to access the java source.
  
  === How can I get pretty-formatted HTML output from Myfaces? ===