JPH03137727A - Editor with program explanation file generator function - Google Patents

Abstract

PURPOSE:To generate a file for the explanation of a program source using a graphic, a table and the like apart from the text file of the program source by providing a function which arbitrarily generates the graphic, a curve line and a straight line and a function making a list. CONSTITUTION:The program source 2 is described in the left side of a separation line 4 provided in the list 1 (document) and a program explanation source 3 including the graphic in addition to a character is described on the right side of the line 4 in correspondence with a necessary row in the source 2. Namely, the function generating the graphic such as a circle, an oval, a square, a triangle, an arc, a semicircle, the curve line such as a dotted line, a broken line, a thin line, a thick line and double lines and the straight line, a function which paints out a designated area and a designated pattern and an external character registration/delection function and an external character display function are given to an editor. Thus, the function which can edit the graphic, the table and the document for explaining the source 2 apart from the source 2 as the source 3 and which correspondingly makes the source 2 and the source 3 into the list is given. Thus, the file for program source explanation is generated apart from the text file.

Description

[Detailed description of the invention] [Industrial application field]

The present invention relates to an editor as an editing program for creating and modifying a text file of a program source, and to an editor with a function for creating a program explanatory file, which is further added with a function for creating a program explanatory file. Note that in the following figures, the same reference numerals indicate the same or corresponding parts.

[Conventional technology]

In conventional editors, when adding an explanation (comment) to a program source, the comment is written in the program source using a prescribed writing method in the language in which the program is created. The compiler ignored this comment section and created an object program.

[Problem to be solved by the invention]

However, with conventional editors, comments can only be written using the prescribed writing method in the programming language, so they cannot be written with illustrated explanations or tables. There was a problem in that it was not possible to explain the program source using graphs or the like. That is, if an attempt is made to write an illustrated explanation, the compiler cannot resolve this description as content other than the program source, and cannot compile correctly. SUMMARY OF THE INVENTION An object of the present invention is to provide an editor with a program explanation file creation function that can create a program explanation file for explaining a program source using tables and graphs in FIG. 1 separately from a text file of the program source.

[Means to solve the problem]

In order to solve the above-mentioned problems, the editor of the present invention is an editor for creating and modifying a text file of r program source (2, etc.), and further includes an explanation of the program source and its corresponding information. It is assumed that it has a function for creating and modifying explanation files (such as 3F).

[For use]

Figure 2 table for explanation of program source in conventional editor,
By providing functions for editing graphs and documents, and further providing a function for listing the results of these edits together with program sources, a document for explaining the program sources can be created without changing the program sources.

Embodiments The present invention will be described in detail below with reference to FIGS. 1 to 3. FIG. 1 shows a part of a list (document) as one embodiment of the present invention, and FIGS. 2 and 3 each show a different embodiment of the structure of a program explanation file. In FIG. 1, 1 is a part of a list (a document to be described later), and 4 is a dividing line that separates this list from left to right. On the left side of this dividing line 4, a program source 2 is written, and on the right side of the dividing line 4, a program explanation source 3 that can include figures in addition to characters is written in correspondence with the necessary lines in the sologram source 2. It has been described. That is, the present invention has a function to arbitrarily create figures such as circles, ellipses, squares, squares, arcs, semicircles, etc., curves such as dotted lines, broken lines, thin lines, thick lines, double lines, and straight lines, and a function to specify designated areas. The editor that can create and modify program sources has the function of filling in with a pattern, the function of registering/deletion of external characters, and the function of displaying external characters. A document can be edited as a program explanation source 3, and the software has a function of making the edited program explanation source 3 and program source 2 correspond to each other and creating a list. This list is called document 1. For example, to input the original data of list (document) 1 as shown in Figure 1 into a personal computer, use the editor based on the present invention, set it to document creation mode, and use the operation keys to display the screen as shown in Figure 1. On the left side of the separator line 4, each line of the program source 2 is written, and on the right side of the separator line 4, a program explanation source 3 consisting of tables, graphs, or text for explanations corresponding to the lines on the left side is written.
Describe. After this description, if the edit mode is entered, the data of program source 2 is stored in an auxiliary storage device (not shown) as a program source text file similar to the conventional one, and the data of program explanation source 3 is stored in the program explanation file 3F, which will be described later. It is stored in auxiliary storage as . Conversely, the document 1 shown in FIG. 1 can be displayed on the screen and printed out from the program source text file and the program explanation file 3F. In addition, if a program source text file already exists and you are trying to create program explanation file 3F, display program source 2 on the left side of separator line 4 on the screen shown in Figure 1, and place it on the right side of separator line 4. It is also possible to use a method of sequentially writing the program explanation source 3. By the way, FIG. 2 shows an example of the structure of the program explanation file 3F stored in an auxiliary storage device (not shown) based on the data input of the program explanation source 3. In this example, this memory area is structured in units of 16 bits. , consists of a header section 11 at the beginning and a data section 12 following it. In the header section 11, each start address of the explanation data corresponding to each line from the first line to the last line (in this example, the Nth line) of the program source 2 is stored in the order of each line. Also, in the data section 12, in order of the rows of the program source 2 from the top, the table in FIG. 1 corresponding to the rows is shown. Explanatory data including graphs or characters is stored using graphic codes and character codes. An explanatory diagram corresponding to the lines of program source 2. If there is no table, graph, or document, the header section 11 corresponding to that row separated by 16 bits is set to NU L
Set to (0). FIG. 3 shows an example of the structure of the program explanation file 3F in such a case. For example, an explanatory diagram corresponding to the second line of the program source. If there is no table, graph, or document, the second part of the header section 11 divided into 16-bit units will be NUL. Furthermore, when the program source 2 is modified, the content corresponding to the modified section in the header section 11 of the program explanation file 3F is also automatically modified. The editor can display the document 1 as shown in FIG. 1 on the screen or print it out to a printer by referring to the text file of the program source 2 and the program explanation file 3F. At that time, the dividing line 4 etc. can also be output.

【Effect of the invention】

According to the present invention, it is an editor for creating and modifying a text file of the program source 2, and further has a function for creating and modifying a program explanation file 3F consisting of an explanation of the program source 2 and its corresponding information. Since we decided to use an editor with a function to create a program explanation file, we were able to associate the text file of the program source with the program explanation file, and create a collection of tables, graphs, and documents used to explain the program source. Became. By making the program explanation file separate from the program source text file,
This eliminates the need to recompile the program source text file even when modifying or modifying the Figure 1 table, graph, or document used to explain the program source.

[Brief explanation of the drawing]

FIG. 1 is a diagram showing a document as an embodiment of the present invention, and FIGS. 2 and 3 are diagrams each showing a different embodiment of the structure of a program explanation file of the present invention. 1: List (document), 2 Nibrogram source,
3 Nibragram explanation source, 4: Separator line, 3F Nibragram explanation file, 11: Header 3F Nibragram ^■Katsu file 15

Claims (1)

[Claims] 1) An editor for creating and modifying a program source text file, and further having a function for creating and modifying a program explanation file consisting of program source explanations and corresponding information. An editor with a function to create program explanation files.