Javadoc Report

  Generating Javadoc
  Javadoc execution
  Loading source files for package org.astrogrid...
  Loading source files for package org.astrogrid.common.bean...
  Loading source files for package org.astrogrid.common.creator...
  Loading source files for package org.astrogrid.common.delegate...
  Loading source files for package org.astrogrid.common.j2ee...
  Loading source files for package org.astrogrid.common.j2ee.environment...
  Loading source files for package org.astrogrid.common.namegen...
  Loading source files for package org.astrogrid.common.registry...
  Loading source files for package org.astrogrid.community...
  Loading source files for package org.astrogrid.community.common.util...
  Loading source files for package org.astrogrid.component...
  Loading source files for package org.astrogrid.component.descriptor...
  Loading source files for package org.astrogrid.config...
  Loading source files for package org.astrogrid.devtools...
  Loading source files for package org.astrogrid.i18n...
  Loading source files for package org.astrogrid.io...
  Loading source files for package org.astrogrid.log...
  Loading source files for package org.astrogrid.store...
  Loading source files for package org.astrogrid.test...
  Loading source files for package org.astrogrid.util...
  Constructing Javadoc information...
  Standard Doclet version 1.4.2_11
  Generating target/docs/apidocs/constant-values.html...
  Copying file /home/integration/.maven/cache/maven-javadoc-plugin-1.7/plugin-resources/stylesheet.css to file target/docs/apidocs/stylesheet.css...
  Building tree for all the packages and classes...
  src/java/org/astrogrid/TemplateManager.java:32: warning - @see tag has no arguments.
  src/java/org/astrogrid/TemplateManager.java:32: warning - @see tag has no arguments.
  src/java/org/astrogrid/Configurator.java:39: warning - Tag @see:illegal character: ":" in "http://www.jconfig.org"
  Generating target/docs/apidocs/org/astrogrid/common/delegate/class-use/Delegate.html...
  "<h1>Base Interface and Abstract Class for delegates"
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what will be interpreted as the first sentence in the
  next major release (when that interpretation will be internationalized), which is:
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  To avoid this note, change the doc comment to make this a proper first sentence, then
  use -breakiterator from that point forward, which will output this new sentence.
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/namegen/class-use/NameGen.html...
  "<h1>Name Generators"
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/class-use/ComponentDescriptor.html...
  "<h1>Component Descriptors"
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  		Optional interface that components can implement to be self-documenting. 
  		"
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:21: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/bean/BaseBean.java:27: warning - Tag @see:illegal character: ":" in "http://jakarta.apache.org/commons/jxpath/apidocs/org/apache/commons/jxpath/JXPathContext.html"
  src/java/org/astrogrid/common/bean/BaseBean.java:89: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/CommonsLoggingFacade.java:19: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:21: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/community/User.java:86: warning - @return tag has no arguments.
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:174: warning - Tag @see: missing #: "getList()"
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:174: warning - Tag @see: can't find getList() in org.astrogrid.util.TypeSafeEnumerator
  src/java/org/astrogrid/community/User.java:93: warning - @return tag has no arguments.
  Generating target/docs/apidocs/org/astrogrid/common/delegate/package-use.html...
  "<h1>Base Interface and Abstract Class for delegates"
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:30: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:187: warning - The first sentence is interpreted to be:
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  src/java/org/astrogrid/community/common/util/CommunityMessage.java:20: warning - @return tag has no arguments.
  src/java/org/astrogrid/util/DomHelper.java:245: warning - @return tag has no arguments.
  src/java/org/astrogrid/util/DomHelper.java:257: warning - @return tag has no arguments.
  Generating target/docs/apidocs/org/astrogrid/common/namegen/package-use.html...
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/component/ComponentManager.java:38: warning - The first sentence is interpreted to be:
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  src/java/org/astrogrid/community/User.java:100: warning - @return tag has no arguments.
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  src/java/org/astrogrid/community/User.java:172: warning - @return tag has no arguments.
  src/java/org/astrogrid/community/User.java:172: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/util/DomHelper.java:42: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/ComponentManager.java:30: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/log/Log.java:84: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/package-use.html...
  "<h1>Component Descriptors"
  src/java/org/astrogrid/common/bean/BaseBean.java:95: warning - @return tag has no arguments.
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "An interface that components should implement to be self-documenting
   "
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "An interface that components should implement to be self-documenting
   <p>
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
   Note that although it's nice for components to implement this interface, it is not mandatory - hence none of the component interfaces extend this one."
  src/java/org/astrogrid/test/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/test/AstrogridAssert.java:68: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/test/package.html: warning - The first sentence is interpreted to be:
  Building index for all the packages and classes...
  src/java/org/astrogrid/common/bean/BaseBean.java:89: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/index-all.html...
  "class of functions added to jxpath context
   "
  This sentence is different from what would be generated using -breakiterator: 
  "class of functions added to jxpath context
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
   <p>has to be public, else lib is not callable from jxpath"
  "irritating - jakarta transactions doesn't integration with commons logging yet."
  src/java/org/astrogrid/common/namegen/CommonsLoggingFacade.java:19: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  "irritating - jakarta transactions doesn't integration with commons logging yet. need to write my own facade for it... ho hum"
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:21: warning - The first sentence is interpreted to be:
  "An interface that components should implement to be self-documenting
   "
  This sentence is different from what would be generated using -breakiterator: 
  "An interface that components should implement to be self-documenting
   <p>
  src/java/org/astrogrid/log/Log.java:84: warning - The first sentence is interpreted to be:
   Note that although it's nice for components to implement this interface, it is not mandatory - hence none of the component interfaces extend this one."
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   "
  src/java/org/astrogrid/test/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   <p>
   may return null if no tests are applicable."
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
  src/java/org/astrogrid/Configurator.java:39: warning - @TODO is an unknown tag.
   the following method:
   "
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/Configurator.java:39: warning - Tag @see: reference not found: http://www.jconfig.org
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
   the following method:
   <pre>
      public static <SubClass>[] getAll() {
  src/java/org/astrogrid/Configurator.java:147: warning - Tag @see: reference not found: org.jconfig.jConfig
          return (<SubClass>[] getList(<SubClass>.class).toArray(new <SubClass>[])
      }"
  "return a suite of installation tests for the components in the container 
   "
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/TemplateManager.java:32: warning - Tag @see: reference not found: 
  "return a suite of installation tests for the components in the container 
   <p>
  src/java/org/astrogrid/TemplateManager.java:32: warning - Tag @see: reference not found: 
   this suite is the composition of all installation tests returned by objects in the container that implement the
   {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "gets the userid part of the account string - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/common/bean/BaseBean.java:27: warning - Tag @see: reference not found: http://jakarta.apache.org/commons/jxpath/apidocs/org/apache/commons/jxpath/JXPathContext.html
  "gets the userid part of the account string - i.e. that before the @"
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element."
  src/java/org/astrogrid/common/bean/BaseBean.java:27: warning - Tag @see: reference not found: BaseBeanTest
  This sentence is different from what would be generated using -breakiterator: 
  "Convenience routine for returning the value of an element of the given
  src/java/org/astrogrid/common/bean/BaseBean.java:89: warning - The first sentence is interpreted to be:
   name that is a *direct* child of the given parent Element"
  "output human-readable description of contents of container as HTML
    "
  This sentence is different from what would be generated using -breakiterator: 
  "output human-readable description of contents of container as HTML
    <p>
   used for debugging / output to JSP 
   Uses descriptions from components that implement the {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   "
  This sentence is different from what would be generated using -breakiterator: 
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   <pre>
       Log.logError("Could not do task xxx");
   or
       Log.logError("Could not do task xxxx",exception);
   </pre>
   if you have an exception to log.
   "
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "<h1>Useful classes for writing unit tests"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Useful classes for writing unit tests</h1>"
  "system id for votable dtd - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "system id for votable dtd - i.e. absolute location on classpath of votable dtd"
  Building index for all classes...
  Generating target/docs/apidocs/overview-summary.html...
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "<h1>Useful classes for writing unit tests"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Useful classes for writing unit tests</h1>"
  src/java/org/astrogrid/community/User.java:172: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/ComponentManager.java:38: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/ComponentManager.java:30: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/EmptyComponentManager.java:79: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/bean/package-summary.html...
  "class of functions added to jxpath context
   "
  This sentence is different from what would be generated using -breakiterator: 
  "class of functions added to jxpath context
   <p>has to be public, else lib is not callable from jxpath"
  src/java/org/astrogrid/component/EmptyComponentManager.java:42: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:30: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/SimpleComponentDescriptor.java:52: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/delegate/package-summary.html...
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  Generating target/docs/apidocs/org/astrogrid/common/namegen/package-summary.html...
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  src/java/org/astrogrid/store/Ivorn.java:75: warning - @deprecated? is an unknown tag.
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  "irritating - jakarta transactions doesn't integration with commons logging yet."
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/test/AstrogridAssert.java:68: warning - The first sentence is interpreted to be:
  "irritating - jakarta transactions doesn't integration with commons logging yet. need to write my own facade for it... ho hum"
  src/java/org/astrogrid/test/AstrogridAssert.java:89: warning - @asserts is an unknown tag.
  src/java/org/astrogrid/test/AstrogridAssert.java:95: warning - @asserts is an unknown tag.
  src/java/org/astrogrid/test/AstrogridAssert.java:318: warning - @asserts is an unknown tag.
  src/java/org/astrogrid/util/DomHelper.java:42: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/util/DomHelper.java:245: warning - @param argument "doc" is not a parameter name.
  src/java/org/astrogrid/util/DomHelper.java:245: warning - @param argument "prefix" is not a parameter name.
  src/java/org/astrogrid/util/DomHelper.java:257: warning - @param argument "doc" is not a parameter name.
  src/java/org/astrogrid/util/DomHelper.java:257: warning - @param argument "prefix" is not a parameter name.
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:187: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/package-summary.html...
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "An interface that components should implement to be self-documenting
   "
  This sentence is different from what would be generated using -breakiterator: 
  "An interface that components should implement to be self-documenting
   <p>
   Note that although it's nice for components to implement this interface, it is not mandatory - hence none of the component interfaces extend this one."
  Generating target/docs/apidocs/org/astrogrid/log/package-summary.html...
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   "
  This sentence is different from what would be generated using -breakiterator: 
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   <pre>
       Log.logError("Could not do task xxx");
   or
       Log.logError("Could not do task xxxx",exception);
   </pre>
   if you have an exception to log.
   "
  Generating target/docs/apidocs/org/astrogrid/test/package-summary.html...
  "<h1>Useful classes for writing unit tests"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Useful classes for writing unit tests</h1>"
  Generating target/docs/apidocs/org/astrogrid/common/bean/BaseBean.html...
  "class of functions added to jxpath context
   "
  This sentence is different from what would be generated using -breakiterator: 
  "class of functions added to jxpath context
   <p>has to be public, else lib is not callable from jxpath"
  Generating target/docs/apidocs/org/astrogrid/community/User.html...
  "gets the userid part of the account string - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "gets the userid part of the account string - i.e. that before the @"
  Generating target/docs/apidocs/org/astrogrid/component/ComponentManager.html...
  "return a suite of installation tests for the components in the container 
   "
  This sentence is different from what would be generated using -breakiterator: 
  "return a suite of installation tests for the components in the container 
   <p>
   this suite is the composition of all installation tests returned by objects in the container that implement the
   {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "output human-readable description of contents of container as HTML
    "
  This sentence is different from what would be generated using -breakiterator: 
  "output human-readable description of contents of container as HTML
    <p>
   used for debugging / output to JSP 
   Uses descriptions from components that implement the {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  Generating target/docs/apidocs/org/astrogrid/component/EmptyComponentManager.html...
  "return a suite of installation tests for the components in the container 
   "
  This sentence is different from what would be generated using -breakiterator: 
  "return a suite of installation tests for the components in the container 
   <p>
   this suite is the composition of all installation tests returned by objects in the container that implement the
   {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "output human-readable description of contents of container as HTML
    "
  This sentence is different from what would be generated using -breakiterator: 
  "output human-readable description of contents of container as HTML
    <p>
   used for debugging / output to JSP 
   Uses descriptions from components that implement the {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/ComponentDescriptor.html...
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   <p>
   may return null if no tests are applicable."
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/SimpleComponentDescriptor.html...
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   <p>
   may return null if no tests are applicable."
  Generating target/docs/apidocs/org/astrogrid/test/AstrogridAssert.html...
  "system id for votable dtd - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "system id for votable dtd - i.e. absolute location on classpath of votable dtd"
  Generating target/docs/apidocs/org/astrogrid/util/DomHelper.html...
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element."
  This sentence is different from what would be generated using -breakiterator: 
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element"
  Generating target/docs/apidocs/org/astrogrid/util/TypeSafeEnumerator.html...
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
   the following method:
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
   the following method:
   <pre>
      public static <SubClass>[] getAll() {
          return (<SubClass>[] getList(<SubClass>.class).toArray(new <SubClass>[])
      }"
  Generating target/docs/apidocs/help-doc.html...
  Note: Custom tags that could override future standard tags:  @modified, @todo, @future. To avoid potential overrides, use at least one period character (.) in custom tag names.
  Note: Custom tags that were not seen:  @future
  74 warnings
  Generating Javadoc
  Javadoc execution
  Loading source files for package org.astrogrid...
  Loading source files for package org.astrogrid.common.bean...
  Loading source files for package org.astrogrid.common.creator...
  Loading source files for package org.astrogrid.common.delegate...
  Loading source files for package org.astrogrid.common.j2ee...
  Loading source files for package org.astrogrid.common.j2ee.environment...
  Loading source files for package org.astrogrid.common.namegen...
  Loading source files for package org.astrogrid.common.registry...
  Loading source files for package org.astrogrid.community...
  Loading source files for package org.astrogrid.community.common.util...
  Loading source files for package org.astrogrid.component...
  Loading source files for package org.astrogrid.component.descriptor...
  Loading source files for package org.astrogrid.config...
  Loading source files for package org.astrogrid.devtools...
  Loading source files for package org.astrogrid.i18n...
  Loading source files for package org.astrogrid.io...
  Loading source files for package org.astrogrid.log...
  Loading source files for package org.astrogrid.store...
  Loading source files for package org.astrogrid.test...
  Loading source files for package org.astrogrid.util...
  Constructing Javadoc information...
  Standard Doclet version 1.4.2_11
  Generating target/docs/apidocs/constant-values.html...
  Copying file /home/integration/.maven/cache/maven-javadoc-plugin-1.7/plugin-resources/stylesheet.css to file target/docs/apidocs/stylesheet.css...
  Building tree for all the packages and classes...
  src/java/org/astrogrid/TemplateManager.java:32: warning - @see tag has no arguments.
  src/java/org/astrogrid/TemplateManager.java:32: warning - @see tag has no arguments.
  src/java/org/astrogrid/Configurator.java:39: warning - Tag @see:illegal character: ":" in "http://www.jconfig.org"
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/delegate/class-use/Delegate.html...
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what will be interpreted as the first sentence in the
  next major release (when that interpretation will be internationalized), which is:
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  To avoid this note, change the doc comment to make this a proper first sentence, then
  use -breakiterator from that point forward, which will output this new sentence.
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/namegen/class-use/NameGen.html...
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:21: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/class-use/ComponentDescriptor.html...
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  src/java/org/astrogrid/common/bean/BaseBean.java:27: warning - Tag @see:illegal character: ":" in "http://jakarta.apache.org/commons/jxpath/apidocs/org/apache/commons/jxpath/JXPathContext.html"
  src/java/org/astrogrid/common/bean/BaseBean.java:89: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/CommonsLoggingFacade.java:19: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:21: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/community/User.java:86: warning - @return tag has no arguments.
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:174: warning - Tag @see: missing #: "getList()"
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:174: warning - Tag @see: can't find getList() in org.astrogrid.util.TypeSafeEnumerator
  src/java/org/astrogrid/community/User.java:93: warning - @return tag has no arguments.
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:30: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:187: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/community/common/util/CommunityMessage.java:20: warning - @return tag has no arguments.
  src/java/org/astrogrid/util/DomHelper.java:245: warning - @return tag has no arguments.
  src/java/org/astrogrid/util/DomHelper.java:257: warning - @return tag has no arguments.
  Generating target/docs/apidocs/org/astrogrid/common/delegate/package-use.html...
  "<h1>Base Interface and Abstract Class for delegates"
  src/java/org/astrogrid/component/ComponentManager.java:38: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  src/java/org/astrogrid/community/User.java:100: warning - @return tag has no arguments.
  src/java/org/astrogrid/community/User.java:172: warning - @return tag has no arguments.
  src/java/org/astrogrid/community/User.java:172: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/namegen/package-use.html...
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/util/DomHelper.java:42: warning - The first sentence is interpreted to be:
  "<h1>Name Generators</h1>
  src/java/org/astrogrid/component/ComponentManager.java:30: warning - The first sentence is interpreted to be:
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  src/java/org/astrogrid/log/Log.java:84: warning - The first sentence is interpreted to be:
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  src/java/org/astrogrid/common/bean/BaseBean.java:95: warning - @return tag has no arguments.
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/package-use.html...
  "<h1>Component Descriptors"
  src/java/org/astrogrid/test/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  src/java/org/astrogrid/test/AstrogridAssert.java:68: warning - The first sentence is interpreted to be:
  		Optional interface that components can implement to be self-documenting. 
  		"
  "An interface that components should implement to be self-documenting
   "
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "An interface that components should implement to be self-documenting
   <p>
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
   Note that although it's nice for components to implement this interface, it is not mandatory - hence none of the component interfaces extend this one."
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/test/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/bean/BaseBean.java:89: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/delegate/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/package.html: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/common/namegen/CommonsLoggingFacade.java:19: warning - The first sentence is interpreted to be:
  Building index for all the packages and classes...
  src/java/org/astrogrid/component/descriptor/package.html: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/index-all.html...
  "class of functions added to jxpath context
   "
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:21: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "class of functions added to jxpath context
   <p>has to be public, else lib is not callable from jxpath"
  "irritating - jakarta transactions doesn't integration with commons logging yet."
  This sentence is different from what would be generated using -breakiterator: 
  "irritating - jakarta transactions doesn't integration with commons logging yet. need to write my own facade for it... ho hum"
  "An interface that components should implement to be self-documenting
   "
  This sentence is different from what would be generated using -breakiterator: 
  "An interface that components should implement to be self-documenting
   <p>
  src/java/org/astrogrid/log/Log.java:84: warning - The first sentence is interpreted to be:
   Note that although it's nice for components to implement this interface, it is not mandatory - hence none of the component interfaces extend this one."
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   <p>
   may return null if no tests are applicable."
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
  src/java/org/astrogrid/test/package.html: warning - The first sentence is interpreted to be:
   the following method:
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
   the following method:
   <pre>
      public static <SubClass>[] getAll() {
          return (<SubClass>[] getList(<SubClass>.class).toArray(new <SubClass>[])
      }"
  "return a suite of installation tests for the components in the container 
   "
  This sentence is different from what would be generated using -breakiterator: 
  "return a suite of installation tests for the components in the container 
   <p>
  src/java/org/astrogrid/Configurator.java:39: warning - @TODO is an unknown tag.
   this suite is the composition of all installation tests returned by objects in the container that implement the
   {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  src/java/org/astrogrid/Configurator.java:39: warning - Tag @see: reference not found: http://www.jconfig.org
  "gets the userid part of the account string - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "gets the userid part of the account string - i.e. that before the @"
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element."
  src/java/org/astrogrid/Configurator.java:147: warning - Tag @see: reference not found: org.jconfig.jConfig
  This sentence is different from what would be generated using -breakiterator: 
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element"
  "output human-readable description of contents of container as HTML
    "
  src/java/org/astrogrid/TemplateManager.java:32: warning - Tag @see: reference not found: 
  This sentence is different from what would be generated using -breakiterator: 
  "output human-readable description of contents of container as HTML
    <p>
  src/java/org/astrogrid/TemplateManager.java:32: warning - Tag @see: reference not found: 
   used for debugging / output to JSP 
   Uses descriptions from components that implement the {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   "
  src/java/org/astrogrid/common/bean/BaseBean.java:27: warning - Tag @see: reference not found: http://jakarta.apache.org/commons/jxpath/apidocs/org/apache/commons/jxpath/JXPathContext.html
  This sentence is different from what would be generated using -breakiterator: 
  src/java/org/astrogrid/common/bean/BaseBean.java:27: warning - Tag @see: reference not found: BaseBeanTest
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   <pre>
       Log.logError("Could not do task xxx");
   or
  src/java/org/astrogrid/common/bean/BaseBean.java:89: warning - The first sentence is interpreted to be:
       Log.logError("Could not do task xxxx",exception);
   </pre>
   if you have an exception to log.
   "
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "<h1>Useful classes for writing unit tests"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Useful classes for writing unit tests</h1>"
  "system id for votable dtd - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "system id for votable dtd - i.e. absolute location on classpath of votable dtd"
  Building index for all classes...
  Generating target/docs/apidocs/overview-summary.html...
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "<h1>Useful classes for writing unit tests"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Useful classes for writing unit tests</h1>"
  src/java/org/astrogrid/community/User.java:172: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/ComponentManager.java:38: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/bean/package-summary.html...
  "class of functions added to jxpath context
   "
  src/java/org/astrogrid/component/ComponentManager.java:30: warning - The first sentence is interpreted to be:
  This sentence is different from what would be generated using -breakiterator: 
  "class of functions added to jxpath context
   <p>has to be public, else lib is not callable from jxpath"
  src/java/org/astrogrid/component/EmptyComponentManager.java:79: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/EmptyComponentManager.java:42: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/ComponentDescriptor.java:30: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/component/descriptor/SimpleComponentDescriptor.java:52: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/common/delegate/package-summary.html...
  "<h1>Base Interface and Abstract Class for delegates"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Base Interface and Abstract Class for delegates</h1>"
  Generating target/docs/apidocs/org/astrogrid/common/namegen/package-summary.html...
  "<h1>Name Generators"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Name Generators</h1>
  This package defines an interface for generating new unique names, and two implementations - one that uses randomness and system time, and the other that
  uses a database-style technique to maintain a safe, ever increasing, persistent number sequence (implemented using commons-transaction)"
  "irritating - jakarta transactions doesn't integration with commons logging yet."
  src/java/org/astrogrid/store/Ivorn.java:75: warning - @deprecated? is an unknown tag.
  This sentence is different from what would be generated using -breakiterator: 
  "irritating - jakarta transactions doesn't integration with commons logging yet. need to write my own facade for it... ho hum"
  src/java/org/astrogrid/test/AstrogridAssert.java:68: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/test/AstrogridAssert.java:89: warning - @asserts is an unknown tag.
  src/java/org/astrogrid/test/AstrogridAssert.java:95: warning - @asserts is an unknown tag.
  src/java/org/astrogrid/test/AstrogridAssert.java:318: warning - @asserts is an unknown tag.
  src/java/org/astrogrid/util/DomHelper.java:42: warning - The first sentence is interpreted to be:
  src/java/org/astrogrid/util/DomHelper.java:245: warning - @param argument "doc" is not a parameter name.
  src/java/org/astrogrid/util/DomHelper.java:245: warning - @param argument "prefix" is not a parameter name.
  src/java/org/astrogrid/util/DomHelper.java:257: warning - @param argument "doc" is not a parameter name.
  src/java/org/astrogrid/util/DomHelper.java:257: warning - @param argument "prefix" is not a parameter name.
  src/java/org/astrogrid/util/TypeSafeEnumerator.java:187: warning - The first sentence is interpreted to be:
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/package-summary.html...
  "<h1>Component Descriptors"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Component Descriptors</h1>
  		Optional interface that components can implement to be self-documenting. 
  		"
  "An interface that components should implement to be self-documenting
   "
  This sentence is different from what would be generated using -breakiterator: 
  "An interface that components should implement to be self-documenting
   <p>
   Note that although it's nice for components to implement this interface, it is not mandatory - hence none of the component interfaces extend this one."
  Generating target/docs/apidocs/org/astrogrid/log/package-summary.html...
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   "
  This sentence is different from what would be generated using -breakiterator: 
  "A covenience singleton, providing easy to use access to logging facilities,
   for example:
   <pre>
       Log.logError("Could not do task xxx");
   or
       Log.logError("Could not do task xxxx",exception);
   </pre>
   if you have an exception to log.
   "
  Generating target/docs/apidocs/org/astrogrid/test/package-summary.html...
  "<h1>Useful classes for writing unit tests"
  This sentence is different from what would be generated using -breakiterator: 
  "<h1>Useful classes for writing unit tests</h1>"
  Generating target/docs/apidocs/org/astrogrid/common/bean/BaseBean.html...
  "class of functions added to jxpath context
   "
  This sentence is different from what would be generated using -breakiterator: 
  "class of functions added to jxpath context
   <p>has to be public, else lib is not callable from jxpath"
  Generating target/docs/apidocs/org/astrogrid/community/User.html...
  "gets the userid part of the account string - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "gets the userid part of the account string - i.e. that before the @"
  Generating target/docs/apidocs/org/astrogrid/component/ComponentManager.html...
  "return a suite of installation tests for the components in the container 
   "
  This sentence is different from what would be generated using -breakiterator: 
  "return a suite of installation tests for the components in the container 
   <p>
   this suite is the composition of all installation tests returned by objects in the container that implement the
   {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "output human-readable description of contents of container as HTML
    "
  This sentence is different from what would be generated using -breakiterator: 
  "output human-readable description of contents of container as HTML
    <p>
   used for debugging / output to JSP 
   Uses descriptions from components that implement the {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  Generating target/docs/apidocs/org/astrogrid/component/EmptyComponentManager.html...
  "return a suite of installation tests for the components in the container 
   "
  This sentence is different from what would be generated using -breakiterator: 
  "return a suite of installation tests for the components in the container 
   <p>
   this suite is the composition of all installation tests returned by objects in the container that implement the
   {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  "output human-readable description of contents of container as HTML
    "
  This sentence is different from what would be generated using -breakiterator: 
  "output human-readable description of contents of container as HTML
    <p>
   used for debugging / output to JSP 
   Uses descriptions from components that implement the {@link org.astrogrid.jes.component.descriptor.ComponentDescriptor} interface"
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/ComponentDescriptor.html...
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   <p>
   may return null if no tests are applicable."
  Generating target/docs/apidocs/org/astrogrid/component/descriptor/SimpleComponentDescriptor.html...
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Access a junit test suite that when run will verify that the component instance and configured correctly
   <p>
   may return null if no tests are applicable."
  Generating target/docs/apidocs/org/astrogrid/test/AstrogridAssert.html...
  "system id for votable dtd - i.e."
  This sentence is different from what would be generated using -breakiterator: 
  "system id for votable dtd - i.e. absolute location on classpath of votable dtd"
  Generating target/docs/apidocs/org/astrogrid/util/DomHelper.html...
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element."
  This sentence is different from what would be generated using -breakiterator: 
  "Convenience routine for returning the value of an element of the given
   name that is a *direct* child of the given parent Element"
  Generating target/docs/apidocs/org/astrogrid/util/TypeSafeEnumerator.html...
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
   the following method:
   "
  This sentence is different from what would be generated using -breakiterator: 
  "Provides a way for subclasses to do a typesafe getAll(), by implementing
   the following method:
   <pre>
      public static <SubClass>[] getAll() {
          return (<SubClass>[] getList(<SubClass>.class).toArray(new <SubClass>[])
      }"
  Generating target/docs/apidocs/help-doc.html...
  Note: Custom tags that could override future standard tags:  @modified, @todo, @future. To avoid potential overrides, use at least one period character (.) in custom tag names.
  Note: Custom tags that were not seen:  @future
  74 warnings