We Must Have Missed This Comment: Detecting and Repairing Stale Function References in Linux Kernel Comments

2026-08-04

AI Summary

This work addresses the problem of outdated references in Linux kernel comments caused by function refactoring or deletion, which mislead developers and impede code comprehension. The authors propose ReCite, the first approach specifically targeting such externally induced comment obsolescence, integrating static symbol resolution, Git evolution history tracing, and large language models (LLMs) within a three-stage pipeline to accurately detect stale references and generate repair suggestions. Evaluated on Linux kernel v6.18-rc1, ReCite identified 869 outdated references; manual assessment of 200 repair suggestions showed that 89.0% provided actionable guidance and 42.5% were directly applicable. Of the 75 patches submitted to the community, 50 have already been accepted, demonstrating substantial improvement over traditional methods relying solely on semantic alignment.

Abstract

As the Linux kernel evolves, code comments may become outdated, as the functions they reference can be refactored or removed independently without corresponding updates to the comments. Such stale function references can mislead maintainers and thus hinder code comprehension. Prior work on detecting code-comment inconsistency mainly focused on addressing semantic misalignment between Javadoc comments and their directly annotated functions, making them inapplicable to this type of externally induced staleness in the Linux kernel. Therefore, we propose ReCite, a three-stage approach to identify and repair such stale references: (1) detecting unresolved function-form symbols -- symbols in comments that appear to reference functions but for which no matching function can be found in the current codebase, (2) tracing the evolution history of each unresolved symbol through the Git history, and (3) generating LLM-based repair suggestions grounded in the evolution history and current code context. On Linux kernel v6.18-rc1, ReCite detects 869 stale references with generated repair suggestions. A manual evaluation on 200 sampled repairs shows that 178 (89.0%) provide useful repair guidance, with 85 (42.5%) directly applicable. Of our 75 submitted patches, 50 have been accepted. We also empirically study all unresolved function-form symbols.

Problem

• stale function references
• code-comment inconsistency
• Linux kernel
• outdated comments
• function reference staleness

Innovation

• stale function references
• code-comment inconsistency
• Git history tracing
• LLM-based repair
• Linux kernel maintenance