search

jdee-emacs / jdee

The JDEE is an add-on software package that turns Emacs into a comprehensive system for creating, editing, debugging, and documenting Java applications.
GNU General Public License v2.0
424 stars 55 forks source link
emacs java jdee

readme

MELPA Build Status

JDEE

The JDEE is an add-on software package that turns Emacs into a comprehensive system for creating, editing, debugging, and documenting Java applications.

About the project

As of 2015-07-13, https://github.com/jdee-emacs/jdee/ is the primary source repository.

See CHANGES.md for migration instructions.

Additional information can be found at http://jdee.sourceforge.net/rootpage.html and at https://github.com/jdee-emacs/jdee/wiki

Requirements

Emacs 24.4 is the oldest version that JDEE can be expected to run in.

If you install JDEE through the Emacs package system, it will take care of installing the prerequisites for you:

JDEE also requires JDEE Server for some operations.

Installing with the Emacs package system

The project is available in MELPA. To install it do the following:

  1. Add MELPA to your .emacs or init.el if you don't have it:

    ;;; Add this at the top of the init.el file:
(require 'package)
(add-to-list 'package-archives
         '("melpa" . "https://melpa.org/packages/"))
(when (< emacs-major-version 24)
;; For important compatibility libraries like cl-lib
(add-to-list 'package-archives '("gnu" . "http://elpa.gnu.org/packages/")))
(package-initialize)

  2. Install JDEE from Emacs using its package manager:

    M-x list-packages

    There select JDEE and install: i x

  3. Install JDEE Server from github

Follow short readme at JDEE Server.

  1. Customize jdee-server-dir to make it point to directory with JDEE Server jars.

Warning! Don't install JDEE Server inside JDEE installed from MELPA (~/.emacs.d/elpa/jdee-xxx), because it will be deleted with next update of JDEE! Create a separate directory, for example: ~/.emacs.d/jdee-server.

Customized jdee-server-dir in your init file should look something like:

(custom-set-variables
 '(jdee-server-dir "/Users/you/.emacs.d/jdee-server"))

For additional information, see the old installation instructions.

Installing from source (for JDEE devs only)

  1. Clone the github repository.
  2. Open the cloned JDEE directory in dired.
  3. Being in dired, install using command: package-install-from-buffer

For development you will need to install Cask:

  1. Install Cask.

  2. Run cask install from the JDEE directory (make sure that the cask command is in your PATH).

  3. Run the tests: make test

To use this built distribution without installation, in your .emacs add:

  (add-to-list 'load-path "/path/to/jdee")
  (require 'jdee)

Building the documentation in other formats

JDEE ships with documentation in Info format, but if you want you can generate the docs in other formats too.

To generate Info, HTML and PDF documentation:

Features

Some of the features of JDEE include:

Known Issues

Troubleshooting

Authors