[Hibernate-issues] [Hibernate-JIRA] Assigned: (HB-75) Some javadoc problems in build.xml

[<leg...@at...>]

Message:

   The following issue has been re-assigned.

   Assignee: Christian Bauer (mailto:chr...@bl...)
   Assigner: Gavin King (mailto:ga...@in...)
       Date: Sun, 8 Jun 2003 6:23 AM
    Comment:
The missing packages are intentionally not documented (they are internal impl).

Christian, if you get a change ... would you please look at the build script problem (not high priority).
---------------------------------------------------------------------
View the issue:

  http://opensource.atlassian.com/projects/hibernate/secure/ViewIssue.jspa?key=HB-75


Here is an overview of the issue:
---------------------------------------------------------------------
        Key: HB-75
    Summary: Some javadoc problems in build.xml
       Type: Bug

     Status: Assigned
   Priority: Major

    Project: Hibernate2
   Versions:
             2.0rc2

   Assignee: Christian Bauer
   Reporter: Lu Yunhai

    Created: Tue, 13 May 2003 11:40 PM
    Updated: Sun, 8 Jun 2003 6:23 AM
Environment: Win2000 JDK1.4.1 

Description:
1. line28-line29
    <property name="doc.api.dir" value="${doc.dir}/api"/>
    <property name="doc.ref.dir" value="${doc.dir}/reference"/>
should be 
    <property name="doc.api.dir" value="${doc.dir}/hib_docs/api"/>
    <property name="doc.ref.dir" value="${doc.dir}/hib_docs/reference"/>

2. line175
         Overview="${doc.api.dir}/package.html"
should be
         Overview="${doc.api.dir}/packages.html"

3. some packages missed in javadoc:
        net.sf.hibernate.collection
        net.sf.hibernate.hql
        net.sf.hibernate.impl
        net.sf.hibernate.jca
        net.sf.hibernate.lob
        net.sf.hibernate.proxy
        net.sf.hibernate.ps
        net.sf.hibernate.sql
        net.sf.hibernate.tool
        net.sf.hibernate.tool.*
        net.sf.hibernate.util
        net.sf.hibernate.xml
Maybe not all these packages should be put into javadoc, but there are some do need such as net.sf.hibernate.impl.SessionFactoryImpl, otherwise SessionFactoryImplementor's seealso will be incorrect.


---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:
   http://opensource.atlassian.com/projects/hibernate/Administrators.jspa

If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira