JPH04220721A - Prograom specification generation device - Google Patents

Abstract

PURPOSE:To take over comments, etc., that a user adds to an old program by automatically generating the specification of a program from the program and distinctively displaying alteration parts when the program is updated. CONSTITUTION:A specification generation part 3 generates the specification 5 from the new-version program 4. A difference extraction part 6 extracts remarks added to old specification in hypertext form together with their positions and puts them in difference information 7. Then the newly generated specification 5 are compared with the old specification 2 after the remarks are removed and their differences are added to the difference information 7. Then difference patch parts 8 are fitted according to the position information included in the difference information so that the remarks of the old version and difference points are linked with the specification 5 in the hypertext form. A hypertext control part 10 displays the filling difference information.

Description

[Detailed description of the invention]

0001

[Industrial Application Field] The present invention relates to a device that generates specifications for a program from a program, and in particular, when the program has been updated, it is possible to clearly display the changed parts when re-creating the specifications. The present invention relates to an automatic program specification generation device that is capable of inheriting comments, etc. particularly added by a user or the like to the specifications of an old program.

0002

[Prior Art] A large system such as a banking system uses large information processing equipment and an extremely large amount of software (
(OS, packages, applications, etc.) In order to facilitate the maintenance work of this huge amount of existing programs, it is required to electronically manage their specifications and facilitate reference searches. However, many existing program specifications are handwritten, and in order to create specifications that can be managed electronically, it is necessary to extract specification information from the program and automatically generate specifications. Conventionally, various methods have been considered for generating specifications for a program from such a program. Traditionally, whenever a program is updated, the method described above is used to update the program.
The practice was to generate a specification document and replace it with the old version of the specification document.

0003

[Problem to be Solved by the Invention] In the conventional method described above, in which a specification for the program is generated each time the program is updated, the specification is completely new from the updated program. This makes it difficult to understand differences from conventional program specifications, and valuable annotation information added by the user to the original specifications for reference or ease of understanding. Because the specifications are discarded, the automatically generated specifications are
There was a problem in that it was difficult for users to understand.

[0004] In view of these conventional problems, the present invention
When automatically generating the specifications for an updated program, it is possible to clearly display the differences from the specifications of the old version of the program, and also to display the annotation information added to the specifications of the old version of the program. It is an object of the present invention to provide a program specification generation device that can generate an easy-to-understand specification by adding information such as the following information.

[0005]

According to the invention, the above-mentioned objects are achieved by the means set out in the appended claims. That is, the present invention is an apparatus that automatically generates a specification for a program from a program, and after generating a specification for a new version of the program, the specification and an old version of the program corresponding to the program are generated. means for extracting difference information from the specifications of the above-described means, means for storing the difference information extracted by the means in a hypertext format, and adding the difference information to the specifications when a new version of the program specifications is generated. This is a program specification generation device provided with means.

[0006]

[Operation] FIG. 1 is an explanatory diagram of the operating principle of the present invention. In the figure, the number 1 is the old version of the program, 2 is the corresponding old version of the specification, 3 is the new version of the program, 4 is the specification generator, 5
is the new version of the specification, 6 is the difference extraction part, and 7 is the difference information (this difference information includes information on changes to automatically generated parts and notes added to the old version of the specification.) , 8
is the difference embedding part (this difference embedding part 8 is the difference information 7
will be converted into hypertext and added to the new version of Specification 5. ), 9 represents the resulting specification, and 10 represents a hypertext management section.

In the present invention, as shown in FIG. 1, the specification generation unit 4 generates the specification 5 from the new version of the program 3. The difference extraction unit 6 first extracts the annotations added to the old specification 2 in hypertext format along with their positions, and stores them in the difference information 7. Next, the newly generated specification 5 is compared with the old specification 2 from which the annotations have been removed, and the difference is added to the difference information 7. Next, the difference embedding section 8
embeds the annotations and differences of the previous version in the specification 5 in the form of connecting hypertext links based on the position information included in the difference information. The hypertext management section 10 displays the difference information embedded in this way. The hypertext management unit 10 also provides a function for the user to embed and edit annotations.

[0008]

[Embodiment] FIG. 2 is a block diagram showing the configuration of a system according to an embodiment of the present invention, in which 11 is a CPU, 12 is a memory, and 13 is a CPU.
is a channel device, 14 is an input/output control device, 15-1 to 1
5-n represents a magnetic disk device, 16 a printing device, 17 an input device, and 18 a display device. The old version program 1, old version specification 2, new version program 4, new version specification 5, difference information 7, specification 9, etc. shown in Fig. 1 are shown in Fig. 2.
The data is stored in any one of the magnetic disk drives 15-1 to 15-n, and is read out to the memory 12 and processed as needed.

[0009] Also, it consists of a specification generation section 3, a difference extraction section 6, a difference embedding section 8, a hypertext management section 10, etc., which are controlled by a program, which is shown in FIG.
is stored in one of the magnetic disk devices 15-1 to 15-n, and when the user gives an instruction using the input device 17 and display device 18, it is developed on the memory 12 and executed by the CPU 11. It works by:

The operation of this embodiment will be explained below based on a specific example. FIG. 3 is a diagram showing an old version (version 1) of the input program (COBOL is used as the language). Assume that a specification sheet is automatically generated from this program, and the user adds comments to it, so that the specification sheet becomes as shown in FIG. 4. In the figure, comments marked with * (for example, *no input error, *code error, etc.) are added by the user after the specification is generated.

[0011] These are actually managed by hypertext, and the hypertext display is shown in FIG.
The result is as shown in (a). That is, the display 19
The above display is "1" as shown as the reverse display 20 in the same figure.
When you select "Process (1001)" and execute the comment display command, "No input error" is displayed in the multi-window 21. This is the letter A in Figure 4 above.
It corresponds to the part shown.

[0012]The internal representation of the hypertext at this time is as shown in FIG. 5(b). That is, in the same figure, 22 is the specification file, and 23 is the specification file.
indicates an annotation file.

The case where the program shown in FIG. 3 is changed as a new version input program (version 2) as shown in FIG. 6 will be described. The specifications automatically generated from the program shown in FIG. 6 are as shown in FIG. Difference information (extracted by the difference extraction unit 6 in FIG. 1) between the new version (version 2) program specifications shown in FIG. 7 and the old version (version 1) program specifications shown in FIG. It will look like 8.

As can be seen in the same figure, the difference information here includes comments that existed in the specifications of the old version of the program, as shown in the comment part by the alphabetic character B, and the specifications of the old version of the program. The new version of the program specifications are compared line by line, and the differences are extracted by adding, deleting, changing lines, etc., as indicated by the letter C. (This information is (corresponds to difference information 7 in Figure 1)
.

The difference embedding unit 8 in FIG. 1 adds the above-mentioned difference information to the specification generated from the new version of the input program shown in FIG. As a result, a specification sheet as shown in FIG. 9 is generated. In the figure, comments marked with * are annotations, which are actually managed by hypertext.

That is, the hypertext display at this time is displayed on the display 2 as shown in FIG. 10(a).
The characters displayed above 4 “OTHER processing 1 (1002)”
By selecting and executing the comment display command, "OTHER process 1 (1002)" will be changed to number 25.
The comment is displayed in reverse video as shown in the multi-window 26. Further, the internal representation of the hypertext at this time is shown by the number 27 in the specification file, and by the number 28 in the annotation file.

[0017]

[Effects of the Invention] As explained above, according to the present invention,
It is possible to automatically add information on parts that differ from the previous version to the specifications automatically generated from the program, increasing convenience in program maintenance. Also, since annotations entered by the user can be carried over, quality is improved. It has the advantage of being able to generate high specification documents.

[Brief explanation of the drawing]

FIG. 1 is a diagram showing the principle of operation of the present invention.

FIG. 2 is a block diagram showing the configuration of a system according to an embodiment of the present invention.

FIG. 3 is a diagram showing an old version of the input program.

FIG. 4 is a diagram showing the specifications of an old version of the input program.

FIG. 5 is a diagram illustrating display of hypertext.

FIG. 6 is a diagram showing a new version of the input program.

FIG. 7 is a diagram showing a new version of the input program.

FIG. 8 is a diagram showing difference information.

FIG. 9 is a diagram showing a specification document in which difference information is embedded.

FIG. 10 is a diagram illustrating display of hypertext.

[Explanation of symbols]

1 Old version program 2 Old version specification 3 Specification generation section 4 New version program 5 New version specification 6 Difference extraction section 7 Difference information 8 Difference embedding section 9 Specification 10 Hypertext management section 11 CPU 12 Memory 13 Channel device 14 Input/output control device 15-1 to 15-n magnetic disk device 16
Printing device 17 Input device 18, 19, 24 Display device 20, 25 Reverse display 21, 26 Multi-window 22, 27 Specification file 23, 28 Comment file

Claims (1)

[Claims] Claim 1: A device that automatically generates a specification for a program from a program, which after generating a specification for a new version of the program, generates a specification between the specification and an old version of the program corresponding to the program. means for extracting difference information from the specifications; means for storing the difference information extracted by the means in a hypertext format; and means for adding the difference information to the specifications when generating a new version of the program specifications. A program specification generation device characterized by comprising: