Keywords: IntelliJ IDEA | JavaDoc | Mouse Hover Tooltip | IDE Configuration | Version Evolution
Abstract: This paper provides a comprehensive analysis of the mouse hover JavaDoc documentation display feature in IntelliJ IDEA, tracing its configuration methods and evolutionary path across different versions. Based on high-scoring Stack Overflow answers, the article systematically documents the migration of this feature's settings from IntelliJ 13 through 2020.3, covering key configuration paths including Editor settings, General options, and Code Completion configurations. Through comparative analysis of version-specific implementation details, the paper not only offers practical configuration guidance but also delves into the technical semantics and application scenarios of related options, such as quick documentation display delay settings and automatic documentation popup during code completion. Adopting a rigorous academic structure, the article includes version evolution analysis, configuration path details, feature comparisons, and best practice recommendations, providing Java developers with comprehensive reference for maximizing IntelliJ IDEA's documentation support capabilities.
Feature Overview and Technical Background
In software development, immediate access to API documentation is crucial for improving coding efficiency and code quality. Eclipse IDE has long provided instant JavaDoc documentation viewing through mouse hover tooltips, a feature widely appreciated by Java developers. As another mainstream Java integrated development environment, IntelliJ IDEA offers similar functionality support, though its specific configuration methods and option locations have evolved significantly across version updates.
Version Evolution and Configuration Path Changes
The mouse hover JavaDoc display feature in IntelliJ IDEA has undergone multiple rounds of interface adjustments and functional optimizations. Based on high-quality answer records from the Stack Overflow community, we can clearly trace the configuration path changes of this feature:
In IntelliJ 13, this feature was configured in the Editor settings page, where users needed to check the corresponding checkbox to enable documentation tooltips on mouse hover. The configuration during this period was relatively straightforward, laying the foundation for subsequent feature refinements.
With the release of IntelliJ 14, the configuration option was moved to Editor > General page, becoming the last option in the "Other" group. For Mac users, this option was located under the "IntelliJ Idea" > "Preferences" menu path. This adjustment reflected JetBrains' systematic reorganization of the settings interface.
IntelliJ 16 maintained a similar configuration structure, with the option becoming the second-to-last item in Editor > General > Other. This minor adjustment demonstrated the continuous optimization of the IDE settings interface.
In IntelliJ Ultimate 2016.1, a more significant configuration location change occurred. The feature was moved to Editor > General > Code Completion section, associating documentation display more closely with code completion features and reflecting a logical reorganization of functionality.
Feature Refinement and Advanced Options
IntelliJ Ultimate 2017.2 introduced important improvements in feature refinement and option separation. The system now provided two independent but related configuration options:
The first option was located in Editor > General > Other section, specifically Show quick documentation on mouse move - delay 500 ms. When this checkbox is selected, the IDE displays a quick documentation popup window after the specified delay (default 500 milliseconds) when the mouse moves over a symbol. This functionality directly corresponds to the mouse hover documentation display requirement mentioned in user inquiries.
The second option was located in Editor > General > Code Completion section, specifically Autopopup documentation in 1000 ms, for explicitly invoked completion. This option controls automatic documentation popup behavior during code completion. When selected, IntelliJ IDEA automatically shows a popup window with documentation for the class, method, or field currently highlighted in the lookup list. It's important to note that this feature only works when code completion is explicitly invoked; for automatic code completion lists, users still need to manually trigger documentation display using the <kbd>Ctrl</kbd>+<kbd>Q</kbd> shortcut.
Latest Version Configuration and Best Practices
In IntelliJ Ultimate 2020.3 and subsequent versions, the mouse hover documentation display feature location has been further optimized. The first option is now located in Editor > Code Editing > Quick Documentation section, specifically Show quick documentation on mouse move. This adjustment groups documentation-related features into a more logically organized configuration area.
From a technical implementation perspective, IntelliJ IDEA's quick documentation system is based on real-time parsing of JavaDoc comments from project dependencies and source code. When mouse hover tooltips are enabled, the IDE monitors mouse movement events and triggers the documentation parsing and rendering process when detecting a hover state lasting beyond the configured delay threshold. The system prioritizes displaying documentation comments from local source code, and if unavailable, attempts to retrieve relevant information from downloaded library documentation or online resources.
For developers, configuring appropriate delay times is crucial. Shorter delays (such as 300-500 milliseconds) provide faster documentation access but may cause frequent documentation popups during normal coding, potentially disrupting workflow. Longer delays (such as 1000+ milliseconds) reduce accidental triggers but require conscious hovering and waiting. Personalized adjustment based on individual work habits and project complexity is recommended.
Technical Comparison and Usage Recommendations
Compared to similar functionality in Eclipse, IntelliJ IDEA's mouse hover documentation display offers richer configuration options and finer control capabilities. While Eclipse typically provides relatively fixed delay settings and display methods, IntelliJ IDEA allows users to adjust multiple parameters based on specific scenarios, including delay times, trigger conditions, and display content.
In practical development work, enabling both related options is recommended for optimal experience: configure appropriate mouse hover delays for quick access to frequently used API documentation, while enabling automatic documentation popup during code completion to assist with API selection decisions. For complex libraries or frameworks, combining with the <kbd>Ctrl</kbd>+<kbd>Q</kbd> shortcut for manual documentation viewing is advisable, particularly when in-depth study of specific API usage is required.
It's important to note that the availability and quality of documentation display features largely depend on project configuration and documentation sources. Ensure all dependency libraries are correctly configured in the project, and consider downloading library documentation locally to improve access speed and offline availability. For custom code, writing complete, standardized JavaDoc comments not only facilitates team collaboration but also maximizes the utility of documentation display features.
As IntelliJ IDEA continues to evolve, documentation display features may undergo further development. Developers should monitor relevant feature improvements in version release notes and adjust their configuration habits accordingly. Meanwhile, JetBrains official documentation and community forums remain valuable resources for obtaining the latest configuration information and best practices.