# US 2008/0189681 A1 · Private Source Code Commenting

> Agents: this data is available as JSON from the patentgrep API and MCP server — see https://patentgrep.com/llms.txt

- Number: US 2008/0189681 A1
- Document ID: US20080189681A1
- Status: Published application
- Kind: A1
- Application number: 12/098,995
- Filed: 2008-04-07
- Published: 2008-08-07
- Earliest claimed: 2003-07-03
- Assignees: International Business Machines Corporation
- Inventors: Kulvir S. Bhogal; Hung T. Dinh; Teng S. Hu; Nizam Ishmael
- Web page: https://patentgrep.com/patent/US20080189681A1

## CPC

- G06F 8/73: Program documentation
- G06F: ELECTRIC DIGITAL DATA PROCESSING (computer systems based on specific computational models G06N)

## 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

### Claim at position 1

1-29. (canceled)

### Claim 30

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.

### Claim 31 (depends on 30)

The computer program product of claim 30, 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.

### Claim 32 (depends on 30)

The computer program product of claim 30, 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.

### Claim 33 (depends on 32)

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

### Claim 34 (depends on 32)

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

### Claim 35 (depends on 30)

The computer program product of claim 30, 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.

### Claim 36 (depends on 30)

The computer program product of claim 30, 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.

### Claim 37 (depends on 30)

The computer program product of claim 30, 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.

### Claim 38 (depends on 30)

The computer program product of claim 30, 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.

### Claim 39 (depends on 30)

The computer program product of claim 30, 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.

### Claim 40 (depends on 30)

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

### Claim 41 (depends on 30)

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

### Claim 42

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.

### Claim 43 (depends on 28)

The data processing system of claim 28, 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.
