Quick Documentation Lookup helps you get quick information for any symbol or just method signature information, provided that this symbol has been supplied with Documentation comments in the applicable format.
PyCharm recognizes inline documentation created in accordance with the docstring format.
Such documentation is rendered in the Documentation Tool Window according to the docstring format, selected in the Python Integrated Tools page.
For information on retrieving inline documentation in the JavaScript context, refer to section Viewing JSDoc Comments.
So doing, such documentation is properly rendered in the Documentation Tool Window, and in the gem manager. In case of multiple declarations, a list of possible inferred types is displayed.
Click thumbnail to view larger image.
The URLs and e-mail addresses specified in the documentation comments for methods are also properly rendered. Clicking a hyperlink opens the corresponding URL in an external browser; clicking e-mail address opens the default mail client.
Click thumbnail to view larger image.
In this section:
- Viewing quick documentation.
- Changing font size in the quick documentation window.
- Toolbar of the quick documentation window.
- Tips and Tricks
- On the main menu, choose .
- Press Ctrl+Q or Alt+Button2 Click.
- Provided that the check box Show quick doc on mouse move in the editor settings is selected, just move your mouse pointer over the desired symbol.
When you explicitly invoke code completion, then quick documentation for an entry selected in the suggestion list can be displayed automatically. The behavior of quick documentation lookup is configured in the Code Completion page of the Settings dialog.
- Click
in the upper-right corner of the quick documentation window, and move the slider.
- Rotate the mouse wheel while keeping the Ctrl key pressed.
Toolbar of the Quick Documentation Lookup
The Quick Documentation Lookup window helps navigate to the related symbols via hyperlinks, and provides a toolbar for moving back and forth through the already navigated pages, change font size, and viewing documentation in an external browser.
When pinned, the Quick Documentation Lookup turns into Documentation Tool Window, with the corresponding sidebar icon, and more controls.
Icon | Keyboard shortcut | Action |
---|---|---|
![]() ![]() | Shift+Alt+Left or Shift+Alt+Right | Navigate to the previous or next screen after using hyperlinks in the definition.
On a OS X computer, you can also use the three-finger right-to-left and left-to-right swipe gestures. |
![]() | Shift+F1 | View external documentation in the default browser. |
![]() | F4 | Click this icon to view and edit the documentation sources. |
![]() | Select this icon to update documentation from the sources automatically. | |
![]() | Ctrl+Q or Alt+Button2 Click | Click this icon to restore the documentation source pop-up window to the previous size. |
![]() | Click this icon to show font size slider. Move the slider to increase or decrease the font size in the quick documentation window as required. |
Tips and tricks
- Sequential pressing Ctrl+Q or Alt+Button2 Click toggles the focus of the Quick Documentation pop-up window and Documentation Tool Window.
See Also
Procedures:
- Creating JSDoc Comments
- Configuring JavaScript Libraries
- Viewing JavaScript Reference
- Viewing Inline Documentation
- Documenting Source Code in PyCharm
Reference:
External Links:
Web Resources: