Navigation links in generated documentation
First Claim
Patent Images
1. A method in a data processing system for generating documentation for a source code file in a software project, the method comprising the steps of:
- selecting a source code file from the project;
identifying the language of the source code;
generating a transient meta model for the source code;
determining whether the file is new, and if the file is new,adding symbols from the file to the transient meta model by,obtaining a template for the language, andparsing the source code with the symbols to the transient meta model;
determining whether the file is updated, and if the file is updated,updating the symbols from the file to the transient meta model by,obtaining a template for the language, andparsing the source code with the updated symbols to the transient meta model;
determining whether the file is deleted, and if the file is deleted,deleting symbols of the file from the transient meta model by,obtaining a template for the language, andparsing the source code with the symbols from the transient meta model;
generating a textual documentation that describes the source code, the textual documentation having portions that correspond to portions of the source code;
generating a diagram including at least one diagram element that visually represents the corresponding portion of the source code; and
correlating the diagram elements to the corresponding portions of the textual documentation by providing hyperlinked references in the diagram that link diagram elements to the corresponding portions of the textual documentation.
9 Assignments
0 Petitions
Accused Products
Abstract
Methods and systems consistent with the present invention provide an improved software development tool that generates HTML documentation for source code in a software project. The HTML documentation includes graphical and textual documentation. The software development tool utilizes the linking capabilities of HTML to provide navigation links between the graphical and textual documentation, thus facilitating navigation through and viewing of the documentation.
-
Citations
16 Claims
-
1. A method in a data processing system for generating documentation for a source code file in a software project, the method comprising the steps of:
-
selecting a source code file from the project; identifying the language of the source code; generating a transient meta model for the source code; determining whether the file is new, and if the file is new, adding symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols to the transient meta model; determining whether the file is updated, and if the file is updated, updating the symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the updated symbols to the transient meta model; determining whether the file is deleted, and if the file is deleted, deleting symbols of the file from the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols from the transient meta model; generating a textual documentation that describes the source code, the textual documentation having portions that correspond to portions of the source code; generating a diagram including at least one diagram element that visually represents the corresponding portion of the source code; and correlating the diagram elements to the corresponding portions of the textual documentation by providing hyperlinked references in the diagram that link diagram elements to the corresponding portions of the textual documentation. - View Dependent Claims (2, 3, 4)
-
-
5. A data processing system for generating documentation for a source code file in a software project, comprising:
-
means for selecting a source code file from the project; means for identifying the language of the source code; means for generating a transient meta model for the source code; means for determining whether the file is new, and if the file is new, means for adding symbols from the file to the transient meta model by, means for obtaining a template for the language, and means for parsing the source code with the symbols to the transient meta model; means for determining whether the file is updated, and if the file is updated, means for updating the symbols from the file to the transient meta model by, means for obtaining a template for the language, and means for parsing the source code with the updated symbols to the transient meta model; means for determining whether the file is deleted, and if the file is deleted, means for deleting symbols of the file from the transient meta model by, means for obtaining a template for the language, and means for parsing the source code with the symbols from the transient meta model; means for generating a textual documentation that describes the source code, the textual documentation having portions that correspond to portions of the source code; means for generating a diagram including at least one diagram elements that visually represents the corresponding portion of the source code; and means for correlating the diagram elements to the corresponding portions of the textual documentation by providing hyperlink references in the diagram that link diagram elements to the corresponding portions of the textual documentation. - View Dependent Claims (6, 7)
-
-
8. A computer-readable storage medium containing instructions for controlling a data processing system to perform a method for generating documentation for source code in a software project, the method comprising the steps of:
-
selecting a source code file from the project; identifying the language of the source code; generating a transient meta model for the source code; determining whether the file is new, and if the file is new, adding symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols to the transient meta model; determining whether the file is updated, and if the file is updated, updating the symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the undated symbols to the transient meta model; determining whether the file is deleted, and if the file is deleted, deleting symbols of the file from the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols from the transient meta model; generating a textual documentation that describes the source code, the textual documentation having portions that correspond to portions of the source code; generating a diagram including at least one diagram element that visually represents the corresponding portion of the source code; and correlating the diagram elements to the corresponding portions of the textual documentation by providing hyperlink references in the diagram that link diagram elements to the corresponding portions of the textual documentation. - View Dependent Claims (9, 10, 11)
-
-
12. A data processing system, comprising:
-
a secondary storage device containing a software project, the software project comprising source code; a memory comprising a software development tool that selects a source code file from the project, identifies the language of the source code, generates a transient meta model for the source code, determines whether the file is new, and if the file is new, acids symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols to the transient meta model, and determines whether the file is updated, and if the file is updated, updates the symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the updated symbols to the transient meta model, and determines whether the file is deleted, and if he file is deleted, deletes symbols of the file from the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols from the transient meta model, and generates a documentation that describes the source code, the documentation including a diagram portion and a text portion and having hypertext markup language (HTML) links between the diagram portion and the text portion; and a processor for running the software development tool.
-
-
13. A method for generating a documentation for source code in a software project wherein the documentation includes a diagram portion and a text portion, the method comprising the steps of:
-
selecting a source code file from the project; choosing to generate a documentation that describes the source code, the textual documentation having portions that correspond to portions of the source code; selecting the desired options for the documentation; identifying the language of the source code; generating a transient meta model for the source code; determining whether the file is new, and if the file is new, adding symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols to the transient meta model; determining whether the file is undated, and if the file is update, updating the symbols from the file to the transient meta model by, obtaining a template for the language, and parsing the source code with the updated symbols to the transient meta model; determining whether the file is deleted, and if the file is deleted, deleting symbols of the file from the transient meta model by, obtaining a template for the language, and parsing the source code with the symbols from the transient meta model; generating the textual portion of the source code documentation; generating images for diagram elements that correspond to portions of the textual documentation; mapping the images into regions of the image map according to predefined diagram rules and options selected by the user; and generating hyperlink references from the regions of the image map of the diagram to the textual documentation. - View Dependent Claims (14, 15, 16)
-
Specification