On Tue, Mar 18, 2008 at 10:54 AM, [EMAIL PROTECTED] <
[EMAIL PROTECTED]> wrote:

>
> [1] I'm not sure what the later property examples on that page are meant
> to be; as Leonardo has written them they are attached to no function
> which is not what I had in mind...
>

The examples that does not have methods on bottom are this:

  /** //Sometimes this should be used for exclude one unwanted
inherited property from the tld.
   *  //The exclusion only works for the class where is defined.
   * @mfp.property
   *   name = "parentProperty1"
   *   exclude = "true"
   **/

Example: org.apache.myfaces.custom.HtmlTag has value property on tld,
but org.apache.myfaces.custom.Div do not, becase
it always returns a static value: div. This comment does just affect
tld generation.

  /** //Sometimes this should be used for override documentation
   * <p>
   * This property is used here for .....
   * </p>
   *
   * @mfp.property
   *   name = "parentProperty2"
   *   desc = "This property is used here for ..... "
   **/

Example: On 1.2 javax.faces.component.HtmlPanelGroup has layout property.
There are a lot of components that override this method
changing its meaning, so it's necessary that on tld javadoc (constructed
from .tld) we can find the real meaning for this component.

Other common example is value property. It could be good if we can override
the doc on some components. This comment does just affect tld generation.

>
> Regards,
> Simon
>
>

Reply via email to