Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 356541 - Exclude package.html from binary plugins
Summary: Exclude package.html from binary plugins
Status: RESOLVED WONTFIX
Alias: None
Product: EMF
Classification: Modeling
Component: Releng (show other bugs)
Version: 2.8.0   Edit
Hardware: All All
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: Ed Merks CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-09-02 00:06 EDT by Eike Stepper CLA
Modified: 2018-01-22 11:58 EST (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Eike Stepper CLA 2011-09-02 00:06:34 EDT
Many EMF plugins contain package.html files that have been copied from src/ to bin/ by the Java builder. This not only adds no value and increases the jar size, it also confuses dependend JavaDoc generations (JavaDoc builds that refer to EMF and have EMF in their classpath). Here's an example from my build:

  [javadoc] Constructing Javadoc information...
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore.impl"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.common"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.common.notify"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.common.util"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore.util"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore.resource"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore.plugin"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore.resource.impl"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.common.notify.impl"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.ecore.provider"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.edit"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.edit.provider"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.edit.command"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.common.command"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.edit.domain"
  [javadoc] javadoc: warning - Multiple sources of package comments found for package "org.eclipse.emf.edit.ui"

This can be solved by opening the project properties dialog, select the Java Compiler/Building category, enabling project specific settings and adding "doc-files/,package.html" to Filtered resources.
Comment 1 Eike Stepper CLA 2012-09-01 03:44:37 EDT
http://help.eclipse.org/juno/index.jsp?topic=/org.eclipse.pde.doc.user/reference/pde_feature_generating_build.htm :

exclude.<library> - lists the files that should not be copied into the library by the compiler;
Comment 2 Ed Merks CLA 2018-01-22 11:58:17 EST
I'm resolving all old releng bugs because the build has been replaced with a Tycho build:

https://bugs.eclipse.org/bugs/show_bug.cgi?id=529487

And the update site has been superseded by:

http://download.eclipse.org/modeling/emf/emf/builds/

If there are outstanding issues, please report a new bug based on the new build infrastructure and the new update site.