Installation:
Windows
- Download
and save the current version of Calcite
here.
- Find your
Eclipse root folder. This is usually
C:\Program
Files\Eclipse\ for Windows.
- Place the
downloaded .jar file into
\Eclipse\dropins\ (/Eclipse/dropins/
for Unix-based systems).
- If Eclipse
is already running, save your progress and restart Eclipse.
Unix
- Download
and save the current version of Calcite
here.
- Find your
Eclipse root folder. This is usually
/usr/lib/Eclipse
for Unix-based systems..
- Place the
downloaded .jar file into
/.../Eclipse/dropins/
(if it
doesn't already exist, create the folder) .
- 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. |