Calcite
Construction And Language Completion Integrated Throughout Eclipse
Overview Screenshots Downloads User's Guide Research People Funding  
 
User's Guide

 

Installation:

Windows

  1. Download and save the current version of Calcite here.
  2. Find your Eclipse root folder. This is usually C:\Program Files\Eclipse\ for Windows.
  3. Place the downloaded .jar file into \Eclipse\dropins\(/Eclipse/dropins/ for Unix-based systems).
  4. If Eclipse is already running, save your progress and restart Eclipse.

Unix

  1. Download and save the current version of Calcite here.
  2. Find your Eclipse root folder. This is usually /usr/lib/Eclipse for Unix-based systems..
  3. Place the downloaded .jar file into /.../Eclipse/dropins/ (if it doesn't already exist, create the folder).
  4. If Eclipse is already running, save your progress and restart Eclipse.

 

Use:

  • To get Calcite to help you construct a class, press Ctrl-Space immediately after an ‘=’, or immediately after a “return” statement, as in the pictures below:

·        

 

To view all of the methods and placeholder methods a class contains, just press ‘.’ or Ctrl-Space after the object to bring the completion menu up, as below:

 

 

  • When the list of completions appears, the Calcite completions will have the  icon preceding their text.
    • The construction completions usually appear on the top of the list.
    • The placeholder completions usually appear on the bottom of the list.
    • The "Do You Wish Another Method Were Here" completions always appear on the bottom of the list.
  • If you click a Calcite completion in the list, it will show additional info in the yellow box that pops up, like in this picture.
  • The arguments in the construction examples are typed, so that you know which type to instantiate and use. The type name in the yellow box is linked to a Javadoc page for your convenience.
  • If you double click on the completion, it will be inserted into your code, just like any other completion in the list.
  • About the "Do You Wish Another Method Were Here?" completions: these completions don't insert anything into your code when activated, but if you click the "email the Calcite Team!" link, your default mail client (Outlook, Thunderbird, Gmail...) will be presented, and you can simply fill in the blanks for the email--the body is already fleshed out for you. These can be used in all of the same spots as construction and placeholder completions combined.

 

Cautions:

  • NOTICE: The current version of Calcite keeps a log of it's usage in the local file directory. It does not get transmitted over the internet in any way. The log keeps track of such things as the user's machine information, the Eclipse and Calcite version, and which classes are activated. In rare instances, it may copy a small line or block of code from the program into the log. Because of this, the current version isn't recommended for a corporate-censored environment. If you would like a log-free version, email the Calcite Team.
  • NOTICE: When you click on the "email the Calcite Team" link within the "Do You Wish Another Method Were Here?" listing, it will open a mailto link, which automatically opens your default mail client. It doesn't send anything to the internet unless you click the "send" button.

F.A.Q.

What versions of Eclipse does Calcite work for?

Calcite works best in Eclipse 3.4.0 and newer. See the Downloads Page for details.

Why aren't the construction examples showing up?

Make sure you have the right context (refer to the Usage Guide above) and that the class you're constructing has been imported. Also, Calcite works only for the standard Java API as available at the Sun Website.

Why aren't the placeholder methods showing up?

Make sure that you have the right context (refer to the Usage Guide above) and that the class you're invoking has been imported.

 

 

If you have any questions, concerns, or suggestions please email bam@cs.cmu.edu.