Abstract:Code summarization (aka comment generation) provides a high-level natural language description of the function performed by code, which can benefit the software maintenance, code categorization and retrieval. To the best of our knowledge, the state-of-the-art approaches follow an encoder-decoder framework which encodes source code into a hidden space and later decodes it into a natural language space. Such approaches suffer from the following drawbacks: (a) they are mainly input by representing code as a sequence of tokens while ignoring code hierarchy; (b) most of the encoders only input simple features (e.g., tokens) while ignoring the features that can help capture the correlations between comments and code; (c) the decoders are typically trained to predict subsequent words by maximizing the likelihood of subsequent ground truth words, while in real world, they are excepted to generate the entire word sequence from scratch. As a result, such drawbacks lead to inferior and inconsistent comment generation accuracy. To address the above limitations, this paper presents a new code summarization approach using hierarchical attention network by incorporating multiple code features, including type-augmented abstract syntax trees and program control flows. Such features, along with plain code sequences, are injected into a deep reinforcement learning (DRL) framework (e.g., actor-critic network) for comment generation. Our approach assigns weights (pays "attention") to tokens and statements when constructing the code representation to reflect the hierarchical code structure under different contexts regarding code features (e.g., control flows and abstract syntax trees). Our reinforcement learning mechanism further strengthens the prediction results through the actor network and the critic network, where the actor network provides the confidence of predicting subsequent words based on the current state, and the-critic network computes the reward values of all the possible extensions of the current state to provide global guidance for explorations. Eventually, we employ an advantage reward to train both networks and conduct a set of experiments on a real-world dataset. The experimental results demonstrate that our approach outperforms the baselines by around 22 to 45 percent in BLEU-1 and outperforms the state-of-the-art approaches by around 5 to 60 percent in terms of S-BLEU and C-BLEU.

The Unexpected Blocking of Code Understanding in AI-Based Code Summarization: Observations and Concerns from a Study on Cross-Project Learning Performance

Why My Code Summarization Model Does Not Work

Why My Code Summarization Model Does Not Work: Code Comment Improvement with Category Prediction

Interpretation-based Code Summarization.

On the Evaluation of Neural Code Summarization

Demystifying Code Summarization Models.

Revisiting Information Retrieval and Deep Learning Approaches for Code Summarization.

Source Code Summarization in the Era of Large Language Models

Automatic Code Summarization via ChatGPT: How Far Are We?

Do Code Summarization Models Process Too Much Information? Function Signature May Be All What Is Needed

Contextual Information Enhanced Source Code Summarization

Reinforcement-Learning-Guided Source Code Summarization Using Hierarchical Attention

Low-Resources Project-Specific Code Summarization

Improved Code Summarization via a Graph Neural Network

Learning to Generate Structured Code Summaries From Hybrid Code Context

Leveraging In-and-Cross Project Pseudo-Summaries for Project-Specific Code Summarization

Understanding Code Semantics: An Evaluation of Transformer Models in Summarization

ESALE: Enhancing Code-Summary Alignment Learning for Source Code Summarization

Towards Retrieval-Based Neural Code Summarization: A Meta-Learning Approach

Bi-LSTM-Based Neural Source Code Summarization

Do Machines and Humans Focus on Similar Code? Exploring Explainability of Large Language Models in Code Summarization