Browse Prior Art Database

JavaDoc development environment

IP.com Disclosure Number: IPCOM000015735D
Original Publication Date: 2002-Mar-06
Included in the Prior Art Database: 2003-Jun-21
Document File: 2 page(s) / 49K

Publishing Venue

IBM

Abstract

A cumbersome process in Java development is the authoring of JavaDoc comments, which are comments imbedded in the Java source. It is cumbersome because JavaDoc comments are destined to become HTML comments displayable in a Web browser, but you cannot see them until the "javadoc" tool from the Java Development Kit (JDK) is run against the source files, and the resulting html files are brought up in a Web browser. It is only after these steps that you can see if the result is appealing and properly formatted. Depending on the Java IDE or editor used, the programmer often has to leave the IDE/editor to lauch the JavaDoc tool, and then has to manually launch the Web browser to see the results. Finessing JavaDoc comments can be an iterative and time-consuming task. Further, even reading JavaDoc comments of existing Java code is a process not integrated with the development environment, again as it requires launching a Web browser on the HTML files that are the output of the JavaDoc process. These are typically not at-hand in the Java development environment, which is focused on Java source editing.

This text was extracted from a PDF file.
This is the abbreviated version, containing approximately 38% of the total text.

Page 1 of 2

JavaDoc development environment

A cumbersome process in Java development is the authoring of JavaDoc comments, which are comments imbedded in the Java source. It is cumbersome because JavaDoc comments are destined to become HTML comments displayable in a Web browser, but you cannot see them until the "javadoc" tool from the Java Development Kit (JDK) is run against the source files, and the resulting html files are brought up in a Web browser. It is only after these steps that you can see if the result is appealing and properly formatted. Depending on the Java IDE or editor used, the programmer often has to leave the IDE/editor to lauch the JavaDoc tool, and then has to manually launch the Web browser to see the results. Finessing JavaDoc comments can be an iterative and time-consuming task. Further, even reading JavaDoc comments of existing Java code is a process not integrated with the development environment, again as it requires launching a Web browser on the HTML files that are the output of the JavaDoc process. These are typically not at-hand in the Java development environment, which is focused on Java source editing.

This idea is to extend any Java development environment to support the development and viewing of JavaDoc comments in an environment that integrates the development of Java source code with the development and display of JavaDoc comments.

Modern Java Integrated Development Environments (IDEs), such as the IBM WebSphere Studio Application Developer (WSAD) enable productive development of Java source code by showing a tree-view on the left which lists projects, inside of which are Java packages, inside of which are Java classes and interfaces (these last two are file system artifacts). The developer double clicks on a Java class or interface to open an editor on the right hand side, or right clicks and selects to open the file in the editor. Typically, multiple editor panes can be opened simultaneously and they are arranged in a tabbed view such that selecting a tab brings that editor pane to the foreground. It is within an editor pane the source code editing is done, including the editing and authoring of the JavaDoc comments within the source.

This invention would add a new menu item when a class or interface is right clicked, to bring up an imbedded or external Web browser to view the JavaDoc comments for the selected class or interface. If the IDE supports an imbedded Web browser, which shows up as a pane in the IDE versus an external window, then this would be shown within the real estate of the IDE. For example, it might show up as another tab among the editor tabs. If the IDE supports an external Web browser, then it is launched as a separate window. Often, Microsoft Internet Explorer is supported as an imbedded Web browser via its ActiveX control, while Netscape and others are launched. Regardless of where the Web browser is shown, its contents would be the output of the "javadoc" tool from the Java Deve...