IntelliJ IDEA 2020.1 EAP8: In-editor Javadocs Rendering and Split Terminal Sessions

Posted on by Artem Sarkisov

IntelliJ IDEA 2020.1 EAP has just been updated. The new build can render Javadocs right in the editor and enables you to create and split terminal sessions, vertically or horizontally, multiple times.

In-editor Javadocs rendering

Split terminal sessions vertically/horizontally

In-editor Javadocs rendering

Reading Javadocs in the editor might be annoying because of all the tags you have to cut through, especially when you need to interact with the reference links and images. This is why we’re adding a way to render Javadocs right in the editor. To enable this new experimental feature, go to Preferences / Settings | Editor | General | Appearance and select Render documentation comments in place:

Now you will notice a new icon in the gutter for any Javadoc. You can use it to toggle Javadocs rendering:

Voila! Now you can read Javadocs like a normal text without any distractions. You can also click the links to go to the referenced web pages, or view quick docs for the referenced topics:

You can also adjust the font size of the Javadoc from the context menu, for better visibility:

Note that the rendered docs use the same font size that is used for the Quick Documentation, so when you change the size either in the quick docs or Javadocs, the change will apply to both features.

Split terminal sessions vertically/horizontally

We’ve also added an ability to split terminal sessions vertically or horizontally so that you can run them side by side. You can invoke the context menu from the Terminal to create, navigate, and close a split terminal session:

That’s it for today!

Check out the release notes for the other closed tickets in this EAP build.

Happy Developing!

Comments below can no longer be edited.

36 Responses to IntelliJ IDEA 2020.1 EAP8: In-editor Javadocs Rendering and Split Terminal Sessions

  1. Stephen Friedrich says:

    March 12, 2020

    The inline rendering of javadoc is very nice.

    The only thing that bothers me a bit is the many, many icons in the left gutter to toggle between the views.

    It’s good for affordance for sure, but very bad for

    • Stephen Friedrich says:

      March 12, 2020

      … being distracting

      (sorry, previous comment accidentally submitted too early)

      • Artem Sarkisov says:

        March 12, 2020

        Hi there,

        Thanks for the feedback! We’ll add an ability to turn those icons off in the next EAP.

        • ss005 says:

          March 12, 2020

          Ability to select & copy rendered javadoc would also be nice.

          • HappyUser says:

            March 13, 2020

            Yes, that would be very nice indeed!

        • Tamas Herman says:

          March 13, 2020

          Or instead of adding even more toggles to the IDE, just make them appear on hover over the gutter?

    • Martin Neal says:

      March 12, 2020

      Sweet! This seems to pave the way for an often wished for feature of mine to be able to use different fonts and font sizes for plain ol’ comments. SourceInsight has this feature as seen here: https://www.sourceinsight.com/doc/v4/userguide/Manual/Command_Reference/Syntax_Formatting.htm#IX_Comment_Headings_1

  2. ADEV says:

    March 12, 2020

    WOW i love the new way to render docs!!
    please implement it in other IDEs <3

  3. B. K. Oxley (binkley) says:

    March 12, 2020

    Agreed, Javadoc inplace rendering is nice. I’m not seeing this for Kdoc. Is that an upcoming feature?

    • Brandon says:

      March 13, 2020

      Very cool feature indeed. Please bring this to Kotlin and Groovy.

    • HappyUser says:

      March 13, 2020

      Yep, Kotlin support would be great!

    • Alexey Belkov says:

      March 19, 2020

      Please follow https://youtrack.jetbrains.com/issue/KT-37361 for updates.

  4. Ernst says:

    March 12, 2020

    split terminal window in place works but there is no such useful function like “split and move ” in editor.

    in other hand , there is an option for the terminal “move to editor” where it can be splitted with a moving . however there is a bug for a long time:
    if I have a ssh terminal in editor area, but when I do “split and move to ” I suppose that ssh terminal should be just moved on right panel. however the session is reset during the moving – and I get new !local! terminal then

  5. calvinit says:

    March 13, 2020

    In fact, I also hope the IntelliJ IDEA will have more and better support for markdown’s programming syntax tips and real-time preview in the near future.

  6. Tamas Herman says:

    March 13, 2020

    On macOS, it might be reasonable to assign Cmd-D and Cmd-Shift-D by default to the vertical & horizontal terminal splitting actions, since those are the defaults for iTerm2, which I have the feeling is what most devs use on macOS.

    That raises the question though, that what should be the keyboard shortcut for moving between the spits? iTerm2 uses Cmd-Opt-. At first glance that seems not to conflict with anything else, but not sure about how troublesome is it if those combinations are not passed thru to the terminal apps.

    • Ekaterina Prigara says:

      March 13, 2020

      Hi Tamas,
      We are reusing the Split Vertically and Horizontally editor actions in the terminal and we can’t use Cmd-D because it’s already assigned to a very commonly used Duplicate line action. However, you are welcome to customize your keymap in Preferences | Keymap.
      Same for the moving between split sessions – in the next EAP build, we’ll reuse the Go to next/previous splitter editor action which is already assigned to Alt-Tab/Alt-Shift-Tab.

  7. Xinky says:

    March 13, 2020

    it’s EAP8 today, but when will the Code Vision and Localization or other things in 2020 road map come out?

    • Artem Sarkisov says:

      March 13, 2020

      These are likely to be added in next major releases, it’s still work in progress for now.

  8. HappyUser says:

    March 13, 2020

    Nice! Will in-editor documentation rendering come to scaladoc as well?

  9. Mark Vedder says:

    March 15, 2020

    Loving the new Javadocs Rendering. A nice enhancement for it would be to allow for the rendered Javadocs to be folded (https://youtrack.jetbrains.com/issue/IDEA-235271)

    • HappyUser says:

      March 16, 2020

      +1

  10. Jelle says:

    March 18, 2020

    Will the docs feature also be implemented for JS?

    • Artem Sarkisov says:

      April 14, 2020

      There are plans to support this for JS lib code in v2020.2

  11. Elior Boukhobza says:

    March 24, 2020

    Now that we can split terminal, how hard would it be to implement a feature like tmux to send the same command to all windows?

    • Sergey Simonchik says:

      April 14, 2020

      Sorry for the delay. Sending the same command to all split terminals is not hard, it’s more UX/UI question, how to configure such a mode in UI. Another aspect to consider is the demand for this feature, currently it’s unclear to me. Please file a feature request in the issue tracker if you think it can be useful. Meanwhile, you can just use tmux in IntelliJ terminal for that.

  12. D瓜哥 says:

    April 14, 2020

    How to set the line length of rendered view? Some docs of Java source are a little long and could not show at a line. So the last words are hidden.

    • Artem Sarkisov says:

      April 14, 2020

      Hi there! This one is a known issue. Should be fixed in v2020.1.1. You can follow https://youtrack.jetbrains.com/issue/IDEA-235182 – it won’t provide a way to set the line length, but the issue with the words cutting will be fixed.

  13. Pavel Rappo says:

    April 16, 2020

    “In-editor JavaDoc Rendering” might be even better than “Quick Documentation” for some use cases. That said, it seems like this functionality is not available in package-info.java and module-info.java files.

  14. David Royo says:

    April 21, 2020

    Hi!

    Just curious, why does this work with Java but not in e.g. Scala?

    I have a project with Java & Scala code and the functionality shows up only in Java files.

  15. Dhawal says:

    April 24, 2020

    Can I toggle the rendered view to be the default for all my javadocs? And only click the gutter icon if I want to edit a particular javadoc? That would be really nice.

    • Dhawal says:

      April 24, 2020

      never mind. It seems to be set that way by default. This feature is fantastic!

  16. Ishan says:

    May 5, 2020

    Will it support Scala too? The current latest stable version does not.

Subscribe

Subscribe for updates