[HADOOP-8500] Fix javadoc jars to not contain entire target directory

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.0.0-alpha
• Fix Version/s: 3.0.0-alpha2
• Component/s: build

Environment

N/A

• Target Version/s: 3.0.0-alpha1
• Hadoop Flags: Reviewed

Release Note

Hadoop's javadoc jars should be significantly smaller, and contain only javadoc.

As a related cleanup, the dummy hadoop-dist-* jars are no longer generated as part of the build.

• Assignee: Andrew Wang
• Reporter: EJ Ciramella
• Created: 08/Jun/12 23:22
• Updated: 02/Nov/16 00:52
• Resolved: 31/Oct/16 23:38

Description

The javadoc jars contain the contents of the target directory - which includes classes and all sorts of binary files that it shouldn't.

Sometimes the resulting javadoc jar is 10X bigger than it should be.

The fix is to reconfigure maven to use "api" as it's destDir for javadoc generation.

I have a patch/diff incoming.