We're on Facebook

Logicdoc Installation

This describes how to install and verify LogicDoc.

Background

LogicDoc is an extension of GroovyDoc that generates documentation for your Business Logic, organized into Use Cases with traceability into your logic. The LogicDoc classes are part of the product Download, contained in the project BusLogicDoc. This page explains how to install LogicDoc, and verify its operation by running it on the BusLogicIntro project.

Prerequisites

LogicDoc requires that you download Graphviz (TM) and configure its location:

Verification

The BusLogicIntro/build/LogicDoc.xml ant script is provided to run Logicdoc. After setup verification (described below), you can run it as follows (Eclipse instructions):

Double-click BusLogicIntro/build/LogicDoc.xml

In the Outline window, select Logicdoc [default] (the default target)

Right-click Run to Run As > Ant Build

Trouble Shooting: LogicDoc unable to find Javadoc

This may fail initially, depending on your Eclipse installation. A common failure is the inability to find Javadoc. As described here, you can repair this as follows:

Ensure that your JRE is pointing to a JDK, not simply a JRE (note: Java often installs in Program Files as a JRE; you need obtain a full JDK, which you can recognize by its name, and the existence of lib/tools.jar).