CVS: Tapestry/framework/src/net/sf/tapestry INamespace.java,1.7.2.3,1.7.2.4

Update of /cvsroot/tapestry/Tapestry/framework/src/net/sf/tapestry
In directory sc8-pr-cvs1:/tmp/cvs-serv9994/framework/src/net/sf/tapestry

Modified Files:
      Tag: hship-2-3
	INamespace.java 
Log Message:
Add missing JavaDoc comments, deprecate old, poorly named methods.

Index: INamespace.java
===================================================================
RCS file: /cvsroot/tapestry/Tapestry/framework/src/net/sf/tapestry/INamespace.java,v
retrieving revision 1.7.2.3
retrieving revision 1.7.2.4
diff -C2 -d -r1.7.2.3 -r1.7.2.4
*** INamespace.java	15 Dec 2002 16:26:12 -0000	1.7.2.3
--- INamespace.java	2 Jan 2003 03:13:13 -0000	1.7.2.4
***************
*** 11,14 ****
--- 11,22 ----
   *  Organizes different libraries of Tapestry pages, components
   *  and services into "frameworks", used to disambiguate names.
+  * 
+  *  <p>
+  *  Tapestry release 2.4 includes dynamic discovery of pages and components; an application
+  *  or library may contain a page or component that won't be "known" until the name
+  *  is resolved (because it involves searching for a particular named file).
+  * 
+  *  @see net.sf.tapestry.resolver.PageSpecificationResolver
+  *  @see net.sf.tapestry.resolver.ComponentSpecificationResolver
   *
   *  @author Howard Lewis Ship
***************
*** 166,174 ****
  
      /**
!      *  Returns a sorted list of component aliases.  May return 
!      *  an empty list, but won't return null.  The return list
!      *  is immutable.
!      * 
!      *  <p>Is this method even needed?
       * 
       *  @deprecated use {@link #getComponentTypes()} instead.
--- 174,178 ----
  
      /**
!      *  Deprecated name for {@link #getComponentTypes()}.
       * 
       *  @deprecated use {@link #getComponentTypes()} instead.
***************
*** 179,187 ****
  
      /**
!      *  Returns a sorted list of component aliases.  May return 
       *  an empty list, but won't return null.  The return list
!      *  is immutable.
       * 
       *  <p>Is this method even needed?
       * 
       **/
--- 183,194 ----
  
      /**
!      *  Returns a sorted list of component types.  May return 
       *  an empty list, but won't return null.  The return list
!      *  is immutable.  Represents just the known component types
!      *  (additional types may be discoverred dynamically).
       * 
       *  <p>Is this method even needed?
+      * 
+      *  @since 2.4
       * 
       **/



-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf