RubyMine
 
2022.2
Shortcuts: Windows
Get RubyMine
You are viewing the documentation for an earlier version of RubyMine.
  1. Write code
  2. Code reference information

Code reference information

Last modified: 09 August 2022

Definitions

In RubyMine, you can see where and how symbols, such as tags, classes, fields, methods, or functions are defined in your project. For this purpose, the IDE features the Quick Definition popup.

You can open a definition in the Find tool window. To do so, click the Options icon in the top-right corner of the popup and click Open in Find tool window Open in Find Tool Window.

To open the source code of the definition for editing and close the popup, click the Options icon and then click Edit Edit Source (F4).

tip

For markup languages, RubyMine retrieves definitions of symbols from the specified DTD or schema. For details, see HTML and XML.

Type definitions

The Quick Type Definition feature allows you to view the type definition of variables, methods, or any other symbols in a popup without switching from the code you're editing.

RubyMine doesn't have a default keyboard shortcut for this action, but you can manually configure it in the settings. For more information on how to configure custom shortcuts, refer to Configure keyboard shortcuts.

Parameter info

The Parameter Info popup shows the names of parameters in method and function calls. RubyMine automatically shows a popup with all available method signatures within 1 second (1000 milliseconds) after you type an opening bracket in the editor, or select a method from the suggestions list.

You can explicitly invoke the popup if it has closed or if your IDE is configured not to show the popup automatically. To do so, press Ctrl+P (or click View | Parameter Info).

https://resources.jetbrains.com/help/img/idea/2022.2/rm_view_reference_parameter_info.png
Gif

Show full method or function signatures

By default, the parameter info popup shows simple signatures. You can configure the IDE to show full signatures that include method names and returned types.

  • In the Settings/Preferences dialog (Ctrl+Alt+S), go to Editor | General | Code Completion, and select the Show full method signatures checkbox.

    Full signatures enabled

Configure the parameter info popup

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), go to Editor | General | Code Completion.

  2. In the Show the parameter info popup in ... milliseconds field, specify the time in milliseconds after which the popup should appear.

If you don't want the popup to appear automatically, clear the Show the parameter info popup in ... milliseconds checkbox.

Inlay hints

Inlay hints are special markers that appear in the editor and provide you with additional information about your code, like the names of the parameters that a called method expects. There are different kinds of inlay hints for annotations, method parameters, usages, problems, and so on.

Parameter hints
Parameter hints shown

Configure inlay hints

  1. Go to Settings/Preferences | Editor | Inlay Hints. Alternatively, right-click a hint and select Hints Settings.

    Context menu opens on right-clicking an inlay hint

  2. Use the checkboxes to enable or disable particular inlay hints.

    Configure inlay hints

    If you don't want to see parameter hints for specific cases, you can configure the list of exceptions. By default, the exception list contains a number of pre-defined methods. You can remove a method from the list to see the hints for it, or add new methods to hide their hints in the editor.

    Configure the parameter hints exception list

Quick Documentation

You can get quick information for any symbol right from the editor by means of the Quick Documentation feature. It shows you code documentation in a popup as you hover the mouse over code elements. Note that the symbol must be supplied with documentation comments created in accordance with the YARD or RDoc markup or with the SDK documentation.

Quick Documentation in a popup

View Quick Documentation in a popup

  • Hover the mouse over the necessary symbol in the editor.

  • Place the caret at the symbol and press Ctrl+Q (View | Quick Documentation).

    Press Ctrl+Q again to open this documentation in the Documentation tool window.

    Quick Documentation popup

Click the Show Options Menu icon in the popup to change the font size, display the quick documentation toolbar, or go to the source code.

tip

To specify the delay after which the popup should appear, in the Settings/Preferences dialog (Ctrl+Alt+S), go to Editor | Code Editing | Editor Tooltips and enter the necessary value in the Tooltip delay field.

Disable Quick Documentation on hover

By default, the quick documentation popup appears as you hover the mouse over code elements. You can configure the IDE to display the popup only after you explicitly invoke the Quick Documentation feature.

  • Click the Show Options Menu icon in the popup and disable the Show on Mouse Move option.

  • In the Settings/Preferences dialog (Ctrl+Alt+S), go to Editor | Code Editing | Quick Documentation and clear the Show quick documentation on hover checkbox.

In this case, to view documentation for a symbol at caret, press Ctrl+Q or select View | Quick Documentation from the main menu. The documentation will be shown in a popup, but you can configure the IDE to display it in the tool window right away.

Quick Documentation in the tool window

View documentation in the tool window

With the default settings, pressing Ctrl+Q (View | Quick Documentation) opens quick documentation opens a popup. You can change the settings to view documentation in the tool window.

  • In the quick documentation popup, click the Show Options Menu icon and disable the Show Documentation Popup First option.

  • In the Documentation tool window, click the Show Options Menu icon on the tool window toolbar and disable the Show Documentation Popup First option.

Keep documentation in the tool window

You can open a piece of documentation for a specific code element in the tool window and keep viewing documentation for other elements in your current file.

  1. Place the caret at the required code element and press Ctrl+Q. If the popup appears, press Ctrl+Q again to switch to the tool window.

    The asterisk symbol (*) on the documentation tab means that the tab is not pinned, so its content will be replaced by documentation for another code element that you select in the editor.

  2. Right-click the tab with the documentation in the documentation tool window and enable the Keep This Documentation option.

    After that, the current documentation tab will be pinned. You can return to the editor and view documentation for other code elements that will open either in the popup or in a new tab in the tool window.

tip

Press Ctrl+F in the Documentation tool window to use the text search.

When you are viewing code documentation in the tool window, it is displayed on the unpinned tab (the tab marked with the asterisk symbol (*). There are several ways in which you can work with it:

You can view documentation by hovering the mouse over code elements.

Click the Show Options Menu icon on the tool window toolbar and enable the Show on Mouse Move and Auto-Update from Source options.

Type Info

In RubyMine, you can identify the type of an expression in the following way:

External documentation

External documentation opens the necessary information in a web browser, so that you can navigate to related symbols, and keep the information for further reference at the same time.

External documentation in browser

View external documentation

  • To view documentation for a symbol at the current caret position in a web browser, press Shift+F1 (or click View | External documentation).

Productivity tips

Copy tooltip text to the clipboard

To copy tooltip text to the clipboard, hold Alt (on Linux, hold Ctrl+Alt) and click the tooltip.

View context information

If the current method or class declaration is not visible, you can view it in the tooltip by pressing Alt+Q.

See also

Getting Started