hadoop-mapreduce-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Tom White (JIRA)" <j...@apache.org>
Subject [jira] Updated: (MAPREDUCE-1625) Improve grouping of packages in Javadoc
Date Wed, 24 Mar 2010 19:03:27 GMT

     [ https://issues.apache.org/jira/browse/MAPREDUCE-1625?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Tom White updated MAPREDUCE-1625:
---------------------------------

    Attachment: MAPREDUCE-1625.patch

Here's a patch which fixes these two problems.

Unfortunately Javadoc groups can't be used for contrib modules that have classes in the same
packages as core MapReduce (e.g. Mumak which includes classes in o.a.h.mapred), since they
are specified on a package basis, rather than a source directory basis. For this reason I
have removed these contrib classes from the user Javadoc, but I've left them in the "developer
Javadoc" which is generated using the "javadoc-dev" target. This only affected Mumak.

In the long run we can fix this by re-packaging the contrib modules that do this (in addition
to Mumak, this includes the scheduler implementations) and use the InterfaceAudience annotation
appropriately. (Related to MAPREDUCE-561.)

There are some contrib modules which should have their user Javadoc published. I have opened
MAPREDUCE-1626 to address this problem, since there are lots of warnings that need fixing
in doing this. 

> Improve grouping of packages in Javadoc
> ---------------------------------------
>
>                 Key: MAPREDUCE-1625
>                 URL: https://issues.apache.org/jira/browse/MAPREDUCE-1625
>             Project: Hadoop Map/Reduce
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Tom White
>            Assignee: Tom White
>         Attachments: MAPREDUCE-1625.patch
>
>
> There are a couple of problems with the current Javadoc:
> * The main MapReduce package documentation on the index page appears under "Other Packages"
below the fold.
> * Some contrib classes and packages are interspersed in the main MapReduce documentation,
which is very confusing for users.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message