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.

From Code to Natural Language: Type-Aware Sketch-Based Seq2Seq Learning

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

Why My Code Summarization Model Does Not Work

Neural Comment Generation for Source Code with Auxiliary Code Classification Task

Retrieve and Refine: Exemplar-based Neural Comment Generation

Interpretation-based Code Summarization.

Automatic Generation of Pseudocode with Attention Seq2seq Model

Integrating Extractive and Abstractive Models for Code Comment Generation

Reinforcement-Learning-Guided Source Code Summarization Using Hierarchical Attention

code2seq: Generating Sequences from Structured Representations of Code

Deep Code Comment Generation with Hybrid Lexical and Syntactical Information

Learning to Generate Comments for API-Based Code Snippets

The Source Code Comment Generation Based on Deep Reinforcement Learning and Hierarchical Attention

Towards Usable Neural Comment Generation Via Code-Comment Linkage Interpretation: Method and Empirical Study

A Convolutional Neural Network for Language-Agnostic Source Code Summarization

Comments as Natural Logic Pivots: Improve Code Generation via Comment Perspective

A Simple Retrieval-based Method for Code Comment Generation

Coherent Comments Generation for Chinese Articles with a Graph-to-Sequence Model.

Context-aware Code Summary Generation

Seq2Seq or Seq2Tree: Generating Code Using Both Paradigms Via Mutual Learning.

Neural Models for Source Code Synthesis and Completion