You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by jw...@apache.org on 2009/11/23 03:25:35 UTC

svn commit: r883214 - in /myfaces/trinidad-maven/trunk: maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/ maven-faces-plugin/src/main/resources/org/apache/myfaces/trinidadbuild/plugin/faces/resources/ maven-tagdoc-pl...

Author: jwaldman
Date: Mon Nov 23 02:25:35 2009
New Revision: 883214

URL: http://svn.apache.org/viewvc?rev=883214&view=rev
Log:
TRINIDAD-1583 Add tagdoc information for accessibility
committed for Maria Kaval

Added:
    myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AccessibilityGuidelineBean.java
Modified:
    myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AbstractTagBean.java
    myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AttributeBean.java
    myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacesConfigParser.java
    myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacetBean.java
    myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/resources/org/apache/myfaces/trinidadbuild/plugin/faces/resources/transform12.xsl
    myfaces/trinidad-maven/trunk/maven-tagdoc-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/tagdoc/TagdocReport.java

Modified: myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AbstractTagBean.java
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AbstractTagBean.java?rev=883214&r1=883213&r2=883214&view=diff
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AbstractTagBean.java (original)
+++ myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AbstractTagBean.java Mon Nov 23 02:25:35 2009
@@ -18,23 +18,26 @@
  */
 package org.apache.myfaces.trinidadbuild.plugin.faces.parse;
 
-import javax.xml.namespace.QName;
+import java.lang.reflect.Modifier;
+import java.util.ArrayList;
 import java.util.Iterator;
-import java.util.Map;
 import java.util.LinkedHashMap;
-import java.lang.reflect.Modifier;
+import java.util.List;
+import java.util.Map;
+import javax.xml.namespace.QName;
 
 public class AbstractTagBean extends ObjectBean {
-  private String  _description;
-  private String  _longDescription;
-  private QName   _tagName;
-  private String  _tagClass;
-  protected Map   _properties;
-  private int     _tagClassModifiers;
-  private Map     _examples;
-  private int     _exampleIdx = 0;
-  private Map     _screenshots;
-  private int     _screenshotIdx = 0;
+  private List<String> _accessibilityGuidelines = new ArrayList<String>();
+  private String       _description;
+  private String       _longDescription;
+  private QName        _tagName;
+  private String       _tagClass;
+  protected Map        _properties;
+  private int          _tagClassModifiers;
+  private Map          _examples;
+  private int          _exampleIdx = 0;
+  private Map          _screenshots;
+  private int          _screenshotIdx = 0;
   
   public AbstractTagBean() 
   {
@@ -273,6 +276,40 @@
     return _screenshots.values().iterator();
   }
 
+  /**
+   * Adds an Accessibility (e.g. section 508 compliance) Guideline to this component. The
+   * accessibility guidelines are used during tag doc generation to give the application
+   * developer hints on how to configure the component to be accessibility-compliant.
+   *
+   * @param accessibilityGuideline  the accessibility guideline to add
+   */
+  public void addAccessibilityGuideline(
+    String accessibilityGuideline)
+  {
+    _accessibilityGuidelines.add(accessibilityGuideline);    
+  }
+
+  /**
+   * Returns true if this component has any accessibility guidelines.
+   *
+   * @return  true   if this component has any accessibility guidelines,
+   *          false  otherwise
+   */
+  public boolean hasAccessibilityGuidelines()
+  {
+    return !_accessibilityGuidelines.isEmpty();
+  }
+
+  /**
+   * Returns an iterator for all accessibility guidelines on this component only.
+   *
+   * @return  the accessibility guidelines iterator
+   */
+  public Iterator<String> accessibilityGuidelines()
+  {
+    return _accessibilityGuidelines.iterator();
+  }
+
   public void parseTagClassModifier(
     String modifier)
   {

Added: myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AccessibilityGuidelineBean.java
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AccessibilityGuidelineBean.java?rev=883214&view=auto
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AccessibilityGuidelineBean.java (added)
+++ myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AccessibilityGuidelineBean.java Mon Nov 23 02:25:35 2009
@@ -0,0 +1,98 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ * 
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+package org.apache.myfaces.trinidadbuild.plugin.faces.parse;
+
+/**
+ * AccessibilityGuidelineBean is a Java representation of the faces-config mfp:accessibilityGuidelines
+ * XML element.
+ * An example of how the AccessibilityGuidelineBean would be represented as an XML element is:
+ * <mfp:accessibilityGuideline>
+ *   <mfp:type>required</mfp:type>
+ *   <mfp:description>
+ *     Title attribute must be set in order for a screenreader user to identify the purpose of the popup dialog.
+ *   </mfp:description>
+ * </mfp:accessibilityGuideline>
+ */
+public class AccessibilityGuidelineBean extends ObjectBean
+{
+  /**
+   * Get Description Text. The description text for the accessibility guideline.
+   * 
+   * @return Accessibility Guideline Description Text
+   */
+  public String getDescription()
+  {
+    return _description;
+  }
+
+  /**
+   * Set accessibility guideline Description Text.  
+   *
+   * @param description   Accessibility Guideline Description Text.
+   */
+  public void setDescription( String description )
+  {
+    _description = description;
+  }
+
+  /**
+   * Returns the type of the Accessibility Guideline (e.g. required, suggested, discouraged).
+   *
+   * @return type of Accessibility Guideline
+   */
+  public String getType()
+  {
+    return _type;
+  }
+
+  /**
+   * Set if element is required to meet Accessibility Guidelines
+   *
+   * @param required  whether or not the element is required to meet accessibility guidelines
+   */
+  public void setType( String type )
+  {
+    _type = type;
+  }
+
+  /**
+   * Returns AccessibilityGuideline hashmap key.
+   *
+   * @return AccessibilityGuideline hashmap key
+   */
+  public String getKey()
+  {
+    return _key;
+  }
+
+  /**
+   * Set hashmap key for this accessibility guideline.
+   *
+   * @param key Set key for this accessibility guideline put in 
+   *        ComponentBean _accessibilityGuidelines hashmap.
+   */
+  protected void setKey( String key )
+  {
+    _key = key;
+  }
+
+  private String _description  = null;
+  private String _type         = null;
+  private String _key          = null;
+}

Modified: myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AttributeBean.java
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AttributeBean.java?rev=883214&r1=883213&r2=883214&view=diff
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AttributeBean.java (original)
+++ myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/AttributeBean.java Mon Nov 23 02:25:35 2009
@@ -18,9 +18,12 @@
  */
 package org.apache.myfaces.trinidadbuild.plugin.faces.parse;
 
+import java.lang.Comparable;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
-import java.lang.Comparable;
 
 /**
  * AttributeBean is a Java representation of the faces-config component or
@@ -177,6 +180,40 @@
   }
 
   /**
+   * Adds an Accessibility (e.g. section 508 compliance) Guideline to this attribute. The
+   * accessibility guidelines are used during tag doc generation to give the application
+   * developer hints on how to configure the attribute to be accessibility-compliant.
+   *
+   * @param accessibilityGuideline  the accessibility guideline to add
+   */
+  public void addAccessibilityGuideline(
+    String accessibilityGuideline)
+  {
+    _accessibilityGuidelines.add(accessibilityGuideline);      
+  }
+
+  /**
+   * Returns true if this attribute has any accessibility guidelines.
+   *
+   * @return  true   if this component has any accessibility guidelines,
+   *          false  otherwise
+   */
+  public boolean hasAccessibilityGuidelines()
+  {
+    return !_accessibilityGuidelines.isEmpty();
+  }
+
+  /**
+   * Returns an iterator for all accessibility guidelines on this component only.
+   *
+   * @return  the accessibility guidelines iterator
+   */
+  public Iterator<String> accessibilityGuidelines()
+  {
+    return _accessibilityGuidelines.iterator();
+  }
+
+  /**
    * Sets the virtual flag of this property.
    *
    * @param virtual  the property required flag
@@ -219,6 +256,7 @@
   private String   _alternateClass;
   private boolean  _virtual;
   private MethodSignatureBean _signature;
+  private List<String> _accessibilityGuidelines = new ArrayList<String>();
 
   static private final Pattern _GENERIC_TYPE = Pattern.compile("([^<]+)<(.+)>");
   static private final String[] _EMPTY_ARRAY = new String[0];

Modified: myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacesConfigParser.java
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacesConfigParser.java?rev=883214&r1=883213&r2=883214&view=diff
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacesConfigParser.java (original)
+++ myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacesConfigParser.java Mon Nov 23 02:25:35 2009
@@ -128,6 +128,11 @@
     // faces-config/component/facet/facet-extension
     digester.addBeanPropertySetter("faces-config/component/facet/facet-extension/hidden");
 
+    // faces-config/component/facet/facet-extension/facet-metadata/accessibility-guideline
+    digester.addCallMethod("faces-config/component/facet/facet-extension/facet-metadata/accessibility-guideline",
+                           "addAccessibilityGuideline", 1);
+    digester.addCallParam("faces-config/component/facet/facet-extension/facet-metadata/accessibility-guideline", 0);
+
     // faces-config/component/facet/example
     digester.addObjectCreate("faces-config/component/facet/example",
                              ExampleBean.class);
@@ -178,6 +183,11 @@
     digester.addBeanPropertySetter("faces-config/component/component-extension/uix2-node-class",
                                    "nodeClass");
 
+    // faces-config/component/component-extension/accessibility-guideline
+    digester.addCallMethod("faces-config/component/component-extension/accessibility-guideline",
+                           "addAccessibilityGuideline", 1);
+    digester.addCallParam("faces-config/component/component-extension/accessibility-guideline", 0);
+
     // faces-config/component/component-extension/example
     digester.addObjectCreate("faces-config/component/component-extension/example",
                              ExampleBean.class);
@@ -281,12 +291,18 @@
     digester.addSetNext("faces-config/component/property/property-extension/method-binding-signature",
                         "setMethodBindingSignature",
                         MethodSignatureBean.class.getName());
-    // faces-config/component/property/property-extension/property-metada
+
+    // faces-config/component/property/property-extension/property-metadata
     digester.addBeanPropertySetter("faces-config/component/property/property-extension/property-metadata/use-max-time",
                                    "useMaxTime");
     digester.addBeanPropertySetter("faces-config/component/property/property-extension/property-metadata/deprecated");
     digester.addCallMethod("faces-config/component/property/property-extension/property-metadata/no-op", "makeNoOp");
 
+    // faces-config/component/property/property-extension/property-metadata/accessibility-guideline
+    digester.addCallMethod("faces-config/component/property/property-extension/property-metadata/accessibility-guideline",
+                           "addAccessibilityGuideline", 1);
+    digester.addCallParam("faces-config/component/property/property-extension/property-metadata/accessibility-guideline", 0);
+
     // jsr-276 metadata rules
     digester.setRuleNamespaceURI("http://java.sun.com/xml/ns/javaee/faces/design-time-metadata");
     digester.addCallMethod("faces-config/component/property/property-extension/property-metadata/property-values",

Modified: myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacetBean.java
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacetBean.java?rev=883214&r1=883213&r2=883214&view=diff
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacetBean.java (original)
+++ myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/faces/parse/FacetBean.java Mon Nov 23 02:25:35 2009
@@ -18,6 +18,10 @@
  */
 package org.apache.myfaces.trinidadbuild.plugin.faces.parse;
 
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+
 /**
  * FacetBean is a Java representation of the faces-config component or
  * renderer facet XML element.
@@ -104,9 +108,44 @@
   {
     this._hidden = hidden;
   }
+ 
+  /**
+   * Adds an Accessibility (e.g. section 508 compliance) Guideline to this facet. The
+   * accessibility guidelines are used during tag doc generation to give the application
+   * developer hints on how to configure the facet to be accessibility-compliant.
+   *
+   * @param accGuidelines  the accessibility guideline to add
+   */
+  public void addAccessibilityGuideline(
+    String accessibilityGuideline)
+  {
+    _accessibilityGuidelines.add(accessibilityGuideline);       
+  }
+
+  /**
+   * Returns true if this component has any accessibility guidelines.
+   *
+   * @return  true   if this component has any accessibility guidelines,
+   *          false  otherwise
+   */
+  public boolean hasAccessibilityGuidelines()
+  {
+    return !_accessibilityGuidelines.isEmpty();
+  }
+
+  /**
+   * Returns an iterator for all accessibility guidelines on this component only.
+   *
+   * @return  the accessibility guidelines iterator
+   */
+  public Iterator<String> accessibilityGuidelines()
+  {
+    return _accessibilityGuidelines.iterator();
+  }
 
-  private String  _description;
-  private String  _facetName;
-  private boolean _required;
-  private boolean _hidden;
+  private String       _description;
+  private String       _facetName;
+  private boolean      _required;
+  private boolean      _hidden;
+  private List<String> _accessibilityGuidelines = new ArrayList<String>();
 }

Modified: myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/resources/org/apache/myfaces/trinidadbuild/plugin/faces/resources/transform12.xsl
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/resources/org/apache/myfaces/trinidadbuild/plugin/faces/resources/transform12.xsl?rev=883214&r1=883213&r2=883214&view=diff
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/resources/org/apache/myfaces/trinidadbuild/plugin/faces/resources/transform12.xsl (original)
+++ myfaces/trinidad-maven/trunk/maven-faces-plugin/src/main/resources/org/apache/myfaces/trinidadbuild/plugin/faces/resources/transform12.xsl Mon Nov 23 02:25:35 2009
@@ -1041,6 +1041,7 @@
   </xsl:template>
 
   <!-- Blacklisted mfp: that should not be copied over into the faces-config.xml: -->
+  <xsl:template match="//mfp:accessibility-guideline" />
   <xsl:template match="//mfp:alternate-class" />
   <xsl:template match="//mfp:author" />
   <xsl:template match="//mfp:component-metadata/mfp:group" />

Modified: myfaces/trinidad-maven/trunk/maven-tagdoc-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/tagdoc/TagdocReport.java
URL: http://svn.apache.org/viewvc/myfaces/trinidad-maven/trunk/maven-tagdoc-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/tagdoc/TagdocReport.java?rev=883214&r1=883213&r2=883214&view=diff
==============================================================================
--- myfaces/trinidad-maven/trunk/maven-tagdoc-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/tagdoc/TagdocReport.java (original)
+++ myfaces/trinidad-maven/trunk/maven-tagdoc-plugin/src/main/java/org/apache/myfaces/trinidadbuild/plugin/tagdoc/TagdocReport.java Mon Nov 23 02:25:35 2009
@@ -408,6 +408,8 @@
 
       _writeExamples(out, component);
 
+      _writeAccessibilityGuidelines(out, component);
+
       if (component.hasEvents(true))
       {
         out.write(" <section name=\"Events\">\n");
@@ -1161,6 +1163,145 @@
     out.write(" </section>\n");
   }
 
+  // Write out the accessibility Guidelines for the component.  Accessibility Guidelines
+  // help the application developer to create an application that can be used by users that e.g.
+  // use a screen reader (e.g JAWS).  Oftentimes, in order to be accessibility compliant (e.g. section 508
+  // compliant) an application developer needs to specify metadata for the screenreader application
+  // to be able to correctly interpret the application for the blind user.  The accessibility guideline
+  // can be associated with the Component itself, with a specific attribute of the component
+  // or with a specific facet of the component.  All accessibility guidelines are printed out
+  // together in an "Accessibility Guidelines" section, with the component-generic guidelines
+  // listed first, followed by the attribute specific guidelines and finally the facet-specific
+  // guidelines
+  private void _writeAccessibilityGuidelines(Writer out, ComponentBean bean) throws IOException
+  {
+    // accAttributes and accFacets are sorted lists of attributes and facets, respectively, 
+    // that have an associated accessibility guideline
+    TreeSet<PropertyBean> accAttributes = new TreeSet<PropertyBean>();
+    TreeSet<String> accFacets = new TreeSet<String>();
+
+    // see if any of the component's properties has an associated accessibility guideline
+    Iterator<PropertyBean> attrs = bean.properties();
+    while (attrs.hasNext())
+    {
+      PropertyBean property = attrs.next();
+      if (!property.isTagAttributeExcluded() && property.hasAccessibilityGuidelines())
+      {
+        accAttributes.add(property);
+      }
+    }
+
+    // see if any of the component's facets has an associated accessibility guideline
+    if (bean.hasFacets()) 
+    {
+      Iterator<FacetBean> facets = bean.facets(true);
+      while (facets.hasNext())
+      {
+        FacetBean facetBean = facets.next();
+        if (!facetBean.isHidden() && facetBean.hasAccessibilityGuidelines())
+        {
+          accFacets.add(facetBean.getFacetName());
+        }
+      }
+    }
+
+    // if neither the component nor the component's attributes nor the component's facets
+    // has an accessibility guideline, return
+    if (!bean.hasAccessibilityGuidelines() && accAttributes.isEmpty() && accFacets.isEmpty())
+      return;
+
+    String accGuideline;
+
+    // Write header
+    out.write(" <section name=\"Accessibility Guideline(s)\">\n");
+    out.write(" <p>\n");
+    out.write("   <html>\n");
+    out.write("     <ul>");
+
+    // write out component-generic accessibility guidelines, i.e. accessibility
+    // guidelines that apply to the component as a whole, not associated with a
+    // specific attribute
+    if (bean.hasAccessibilityGuidelines())
+    {
+      Iterator iter = bean.accessibilityGuidelines();
+      while (iter.hasNext())
+      {
+        accGuideline = (String) iter.next();
+        _writeAccessibilityGuideline(out, "", accGuideline);
+      }
+    }
+
+    // Write out attribute-specific accessibility guidelines.  Each attribute can have
+    // one or more associated accessibility guidelines.
+    if (!accAttributes.isEmpty())
+    {
+      Iterator<PropertyBean> propIter = accAttributes.iterator();
+      while (propIter.hasNext())
+      {
+        PropertyBean property = propIter.next();
+        Iterator<String> propAccIter = property.accessibilityGuidelines();
+        while (propAccIter.hasNext())
+        {
+          accGuideline = propAccIter.next();
+          _writeAccessibilityGuideline(out, property.getPropertyName() + " attribute", accGuideline);
+        }
+      }
+    }
+
+    // Write out facet-specific accessibility guidelines. A facet in the accFacets iterator
+    // can have one or more associated accessibility guidelines
+    if (!accFacets.isEmpty())
+    {
+      Iterator<String> facetIter = accFacets.iterator();
+      while (facetIter.hasNext())
+      {
+        String facetName = facetIter.next();
+        FacetBean facet = bean.findFacet(facetName, true);
+
+        Iterator<String> facetAccIter = facet.accessibilityGuidelines();
+        while (facetAccIter.hasNext())
+        {
+          accGuideline = facetAccIter.next();
+          _writeAccessibilityGuideline(out, facetName + " facet", accGuideline);
+        }
+      }
+    }
+
+    out.write("     </ul>");
+    out.write("   </html>\n");
+    out.write(" </p>\n");
+    out.write(" </section>\n");
+  }
+
+  // Write out an Accessibility Guideline
+  // A bullet in an unordered list, followed by (optionally) the reference name in bold, e.g. the
+  // name of the attribute or name of the facet which the guideline applies to, then the text
+  // of the accessibility guideline.  For accessibility guidelines on the component, the referenceName
+  // attribute is left blank.
+  private void _writeAccessibilityGuideline(Writer out, String referenceName, String desc) throws IOException
+  {
+    out.write("    <div class=\'accGuideline\'>\n");
+    out.write("<li>");
+
+    if (!"".equals(referenceName)) 
+    {
+      out.write("<b>");
+      out.write(referenceName);
+      out.write("</b>: ");    
+    }
+
+    if (desc != null)
+    {
+      if (!"".equals(desc))
+      {
+        out.write(desc + "\n");
+      }
+    } 
+
+    out.write("</li>");
+    out.write("    </div>\n");
+  }
+
   protected MavenProject getProject()
   {
     return project;