How to use ZealLookup plugin for Eclipse

Zeal is an offline documentation browser which can be used to lookup help for most popular libraries and APIs. The ZealLookup plugin (also called ZealEclipsePlugin) enables you to lookup help in Zeal right from inside Eclipse! 🙂

Install

  • Shutdown Eclipse.
  • Download the plugin .jar file from here and place it in the plugins directory of your Eclipse installation.
  • Start Eclipse.

Usage

  • You need to configure a keyboard shortcut for ZealLookup. Go to Window -> Preferences -> General -> Keys. Look for Lookup in Zeal command and set a keyboard shortcut for it.

  • I use Vrapper, so I set the keyboard shortcut as \z which is the same as what I use to call Zeal from within Vim.

  • To lookup a word in Zeal: highlight the word and press the keyboard shortcut you have set earlier. Zeal should open with the documentation for the word. I found that sometimes Zeal stays in the background, but it has looked up the word.

  • For use with Vrapper, I mark the current word using viw (visually mark inner word) and then press the ZealLookup keyboard shortcut.

Tried with: ZealLookup 1.0.0, Eclipse 4.4.2 and Ubuntu 14.04

Advertisements

How to get relative line numbers in Eclipse

Relative line numbers in Eclipse
Relative line numbers in Eclipse

Being able to view relative line numbers in Vim makes it very easy to move around and operate in the editor. This is because a lot of Vim commands involve line counts that are relative to the current line.

If you are using Vrapper in Eclipse, you might be missing having relative line numbers. It is possible to get them by installing the Relative Number Ruler plugin.

Install

  • To install, go to Help -> Install New Software -> Add and use the URL http://matf.github.io/relativenumberruler/updatesite/

  • If you do not see any plugins show up, uncheck the “Group items by category” option at the bottom of the dialog.

  • You should be able to choose the plugin and install it from there.

Usage

20150521_relative_number_1

  • Right-click on the line number ruler, this is the editor column where the line numbers are displayed. From here, you can enable or disable both line numbers and relative line numbers.

  • If you would like to have the hybrid mode, where the current line shows the absolute line number and the rest show relative line numbers, that is supported too. Go to Window -> Preferences -> Relative Number Ruler and enable this feature.

Tried with: Relative Number Ruler 1.1, Eclipse 4.4.2 and Ubuntu 14.04

How to toggle comments using Vrapper

Using plugins, a block of code can be commented or uncommented in Vim using the command gc. Similar capability to toggle comments is available in Vrapper, but only in the language specific addons.

For example, if you are working with Eclipse CDT (C/C++), then install the Vrapper – C/C++ Extensions plugin to get this capability.

Tried with: Vrapper 0.54.0, Eclipse CDT 4.4.2 and Ubuntu 14.04

How to piece together your own Eclipse

Compared to Eclipse CDT package, my Eclipse C++ IDE has very few features and plugins
Compared to Eclipse CDT package, my Eclipse C++ IDE has very few features and plugins

Eclipse is developed as a modularized system with a central core platform and additional features and plugins that provide functionality required for a certain language (like Java or C++). These packaged versions of Eclipse that are put together for different languages is what is provided on its download page.

You may feel that the Eclipse packages available for Java or C++ (CDT) are extremely bloated with hundreds of features and plugins that you may never use. For example, Eclipse CDT includes hundreds of MyLyn features and cross-compiler support, none of which I may require right now. The beauty of Eclipse is that everything is a plugin, so you can actually build yourself a lean Eclipse that only includes what you want. This way you can build a minimal Eclipse that has only the features you want.

Step 1: Get the platform runtime binary

  • The core of Eclipse is provided for download as Eclipse Platform Runtime Binary. To get it, go to this page and click on the build number you want. It opens a new page, where you scroll down to the section named Platform Runtime Binary and download the package matching your system.

  • Unzip the zip file you downloaded and run the eclipse binary file. The IDE opens and it works.

Step 2: Add the plugins

  • Now add the plugins you want from Help -> Install New Software. For plugins provided by Eclipse, choose Luna from the dropdown. For external plugins, add their URL.

  • For creating a Eclipse C++ IDE of my own, I installed these plugins:

  • For creating a Eclipse Python IDE of my own, I installed these plugins:

Tried with: Eclipse 4.4.2 and Ubuntu 14.04

Artifact file not found error with NVIDIA NSight

Problem

I tried to install the Vrapper plugin to NVIDIA NSight. Everything went fine until the last step, which gave this error:

An error occurred while installing the items
session context was:(profile=cider, phase=org.eclipse.equinox.internal.p2.engine.phases.Install, operand=null --> [R]org.eclipse.equinox.launcher.gtk.linux.x86_64 1.1.200.v20120913-144807, action=org.eclipse.equinox.internal.p2.touchpoint.eclipse.actions.InstallBundleAction).
The artifact file for osgi.bundle,org.eclipse.equinox.launcher.gtk.linux.x86_64,1.1.200.v20120913-144807 was not found.

Solution

Go to ~/.eclipse. One of the subdirectories here holds the configuration files for NSight. The other subdirectory might be for Eclipse, if you have installed it and are using it. Delete the NSight subdirectory. Open NSight again and try installing Vrapper. It worked this time for me.

Tried with: Vrapper 0.44, NVIDIA NSight 5.5 and Ubuntu 14.04

Vrapper plugin for Eclipse

Vrapper is a plugin that adds Vim-like editing features to Eclipse. It also works with IDEs that are built upon Eclipse, like Nsight Eclipse for example.

Install and use

  • To install Vrapper, go to Help -> Install new software -> Add and add the URL: http://vrapper.sourceforge.net/update-site/stable

  • Eclipse downloads and displays the plugins. Choose Vrapper. Note: Do not choose Vrapper – Split Editor Plugin if you are not on Eclipse 4.x. Do not choose Vrapper – Java Extensions or Vrapper – Python Extensions if you do not have those features in Eclipse. The rest of the install is straightforward.

  • If you feel the need to customize some Vim settings for Vrapper, do them in ~/.vrapperrc. Only the settings listed in the Vrapper configuration page are supported.

Vrapper features

Apart from the usual Vim features, here are some Vrapper-specific features I like to use:

  • Eclipse bookmarks can be set easily by using Vim mark feature with uppercase letter.

  • GVim can be opened on the current file and line by using the command :vim

Tried with: Vrapper 0.36.0, NSight 5.5 and Ubuntu 12.04 LTS