JDK-4034052 : stddoclet: Restore the -doctype MIF option
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.1,1.2.0
  • Priority: P5
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic,solaris_2.5.1
  • CPU: generic
  • Submitted: 1997-02-24
  • Updated: 2014-05-05
  • Resolved: 2001-05-22
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.0 betaFixed
Related Reports
Duplicate :  
Relates :  
Relates :  
Relates :  
Relates :  
Relates :  
Description
The "-doctype MIF" option, which generated FrameMaker intermediate files (called MIF), was in Javadoc 1.0 and removed from javadoc as of JDK1.1.  This functionality should be restored, possibly time through the use of the HotJava class library.   See the "Comments" for the background and suggestions on how to reimplement this feature.

Specification:
Doug has written a specification for the MIF doclet at:

  http://javaweb.eng/~dkramer/javadoc/mifdoclet-spec.html

Justification:
The MIF doclet needs to be flexible, since it is needed by several groups:
- Guy Steele to generate the class API chapters of the Java 
  Language Specification (chapters 20-22 in 1st Edition), for java.lang,
  java.reflect and java.ref.  This enables the source code doc comments
  to the be master source for all API specs (rather than Framemaker files).
- Jonathan Gibbons of JCK team to include API docs with other FrameMaker
  docs
- Graham Hamilton to include API specs with Bean spec (written in FrameMaker)
- JDK docs team to duplicate the current standard doclet functionality in 
  MIF so that it can be generated in PostScript and PDF.

To get this variety, perhaps we could implement a mif package that contains 
the abstracted behavior common to all mif doclets, then a standardmif 
doclet to duplicate the standard doclet, a jckmif doclet for the JCK team,
a jlsmif doclet for the JLS book, and so forth.

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: merlin-beta FIXED IN: merlin-beta INTEGRATED IN: merlin-beta
14-06-2004

WORK AROUND
11-06-2004

SUGGESTED FIX
11-06-2004

PUBLIC COMMENTS This bug has been fix through the inplementation of the MIF doclet. jamie.ho@Eng 2001-02-26
26-02-2001

EVALUATION We need to do this MIF doclet, and can do it after the standard doclet code freeze. doug.kramer@Eng 1998-04-03 The MIF Doclet is almost ready for the fourth relase so far. Recently, we have been facing few problems with "Windows version of the fmbatch - dzbatcher". Once we get around with that, we can definitely go ahead and fix this bug. atul.dambalkar@eng 2000-03-07 This bug has been fix through the inplementation of the MIF doclet. jamie.ho@Eng 2001-02-26
07-03-2000