Early Access Program

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

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. Avatar

    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

    • Avatar

      Stephen Friedrich says:

      March 12, 2020

      … being distracting

      (sorry, previous comment accidentally submitted too early)

      • Avatar

        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.

        • Avatar

          ss005 says:

          March 12, 2020

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

          • Avatar

            HappyUser says:

            March 13, 2020

            Yes, that would be very nice indeed!

        • Avatar

          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?

    • Avatar

      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. Avatar

    ADEV says:

    March 12, 2020

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

  3. Avatar

    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?

    • Avatar

      Brandon says:

      March 13, 2020

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

    • Avatar

      HappyUser says:

      March 13, 2020

      Yep, Kotlin support would be great!

    • Avatar

      Alexey Belkov says:

      March 19, 2020

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

  4. Avatar

    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. Avatar

    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. Avatar

    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

      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. Avatar

    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?

    • Avatar

      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. Avatar

    HappyUser says:

    March 13, 2020

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

  9. Avatar

    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)

    • Avatar

      HappyUser says:

      March 16, 2020

      +1

  10. Avatar

    Jelle says:

    March 18, 2020

    Will the docs feature also be implemented for JS?

    • Avatar

      Artem Sarkisov says:

      April 14, 2020

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

  11. Avatar

    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?

    • Avatar

      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. Avatar

    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.

    • Avatar

      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. Avatar

    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. Avatar

    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. Avatar

    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.

    • Avatar

      Dhawal says:

      April 24, 2020

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

  16. Avatar

    Ishan says:

    May 5, 2020

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

Discover more