Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 356541

Summary:	Exclude package.html from binary plugins
Product:	[Modeling] EMF	Reporter:	Eike Stepper <stepper>
Component:	Releng	Assignee:	Ed Merks <Ed.Merks>
Status:	RESOLVED WONTFIX	QA Contact:
Severity:	enhancement
Priority:	P3	CC:	Ed.Merks
Version:	2.8.0
Target Milestone:	---
Hardware:	All
OS:	All
Whiteboard:

Description Eike Stepper

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

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

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.