Private source code commenting

• US 8,046,741 B2
• Filed: 04/07/2008
• Issued: 10/25/2011
• Est. Priority Date: 07/03/2003
• Status: Expired due to Fees

• Current Assignee: International Business Machines Corporation
• Original Assignee: International Business Machines Corporation
• Inventors: Ishmael, Nizam Jr., Dinh, Hung T., Hu, Teng S., Bhogal, Kulvir S.
• Primary Examiner(s): KENDALL, CHUCK O
• Application Number:
  US12/098,995
• Publication Number:
  US 20080189681A1
• Time in Patent Office: 1,296 Days
• Field of Search: None
• US Class Current: 717/122
• CPC Class Codes: G06F 8/73 Program documentation

Abstract

A method, computer program product, and data processing system for exchanging information regarding software source code among a team of developers is disclosed. In a preferred embodiment of the present invention, a developer associates commentary with a particular code feature, such as a function or object class. A list of intended recipients or readers of the commentary is obtained from the developer. Additional settings regarding such things as an expiration date for the commentary are also obtained from the developer. The source code with associated commentary is then made available to the intended readers. If desired, the source code with associated commentary may be transmitted the intended recipients via e-mail or an “instant message” or other form of notification can be transmitted to the intended recipients to notify them of the commentary to be read.

Claims

1. A computer program product in a recordable-type medium comprising functional descriptive material that, when executed by a computer, enables the computer to perform particular acts, the computer program product including:

first functional descriptive material for receiving a first designation of a particular portion of a body of source code;

second functional descriptive material for receiving a second designation of an association of the particular portion of the body of source code with commentary related to the particular portion of the body of source code;

third functional descriptive material for receiving a third designation of a set of intended readers of the commentary; and

fourth functional descriptive material for making the commentary and the particular portion of the body of source code accessible to only the set of intended readers, wherein the set of intended readers is designated by a user'"'"'s selecting the set of intended readers from a set of potential intended readers, and wherein the set of potential intended readers is acquired by accessing a directory service.

2. The computer program product of claim 1, comprising additional functional descriptive material that, when executed by the computer, enables the computer to perform additional acts including:

receiving a fourth designation of a particular time period during which the commentary will be available, wherein the commentary and the particular portion of the body of source code are accessible to the set of intended readers during the particular time period.

3. The computer program product of claim 1, comprising additional functional descriptive material that, when executed by the computer, enables the computer to perform additional acts including:

sending a notification to at least one subset of the set of intended readers to notify the at least one subset of the set of intended readers that the commentary is available.

4. The computer program product of claim 3, wherein the notification includes copies of the commentary and the particular portion of the body of source code.

5. The computer program product of claim 3, wherein the notification is sent to the at least one subset of the set of intended readers via electronic mail.

6. The computer program product of claim 1, wherein the second designation is represented in the form of at least one tag in a markup language,

wherein the at least one tag is embedded within the body of source code.

7. The computer program product of claim 1, comprising additional functional descriptive material that, when executed by the computer, enables the computer to perform additional acts including:

generating, from the body of source code, a second body of source code that is capable of being compiled by a compiler.

8. The computer program product of claim 1, comprising additional functional descriptive material that, when executed by the computer, enables the computer to perform additional acts including:

formatting the commentary and the particular portion of the body of source code for display to a user.

9. The computer program product of claim 1, wherein the particular portion of the body of source code is one of a subroutine, a line of code, a variable, an identifier, and a source code comment.

10. The computer program product of claim 1, wherein the commentary and the body of source code are recorded within a configuration management system, and

wherein the commentary is made available to the set of intended readers by presenting the commentary along with the body of source code in response to a checking-out of the body of source code by one of the set of intended readers.

11. The computer program product of claim 1, wherein the computer program product forms an integrated development environment.

12. The computer program product of claim 1, wherein the computer program product is executed from a program having a command-line interface.

13. A data processing system comprising:

first receiving means for receiving a first designation of a particular portion of a body of source code;

second receiving means for receiving a second designation of an association of the particular portion of the body of source code with commentary related to the particular portion of the body of source code;

third receiving means for receiving a third designation of a set of intended readers of the commentary; and

making means for making the commentary and the particular portion of the body of source code accessible to only the set of intended readers, wherein the set of intended readers is designated by a user'"'"'s selecting the set of intended readers from a set of potential intended readers, and wherein the set of potential intended readers is acquired by accessing a directory service.

14. The data processing system of claim 13, wherein the commentary and the body of source code are recorded within a configuration management system, and

wherein the commentary is made available to the set of intended readers by presenting the commentary along with the body of source code in response to a checking-out of the body of source code by one of the set of intended readers.