The RainCode Roadmap for Ada is a RainCode product, which produces documentation out of possibly large amounts of Ada source code automatically, in order to ease maintenance, and, more generally, deliver usable knowledge about existing systems.

Modules

Each source code module is rendered in HTML form, lines are numbered, colour codes are used to emphasize various parts (code, comments, etc.) and hypertext tags are used to navigate comfortably in the source file, going from a variable use to the matching definition, etc.

Groups

The user can also define groups, and indicate which of the modules belong to each group. A module can belong to more than a single group, it is not an exclusive classification.

Typically, groups are defined by a technical criterion (batch, interactive, etc.) or by an application-level criterion (communication, scheduling, etc.)

The documentation generated by the RainCode Roadmap can be viewed by group: the user can explicitly ask to view the information of one group only, ignoring the modules of other groups. This filter-like facility comes handy when dealing with metrics applied to excessively large portfolios: for instance, if one deals with 2000 batch modules and 100 interactive modules, the ability to define ad-hoc groups allows to view metrics (including statistical distribution) measured for the 100 interactive modules, without the clobbering of the 2000 batch modules.

Cross-references

Global resources are listed together with the places where they are used, across the entire portfolio. Such global resources include:

• Packages,
• Routines.

Metrics

The Ada Roadmap provides a set of predefined metrics. Besides these metrics, additional user-defined ones may easily be added to the RainCode Roadmap.

Metrics about the code complexity:

• Cyclomatic Complexity
• Maximum nesting level
• Number of statements

Metrics about packages:

• Number of types
• Number of routines
• Number of specification lines
• Number of body lines

Metrics about lines:

• Number of lines
• Number of blank lines
• Number of code lines
• Number of comment lines
• Number of mixed code and comment lines

Example

Please register here and log in. On the download page, you will have access to an Ada Roadmap example based on the GNAT sources. This example shows most of the Ada Roadmap standard features.

Ada Europe 2004

RainCode supports and was be exhibitor at Ada Europe 2004, the 9th International Conference on Reliable Software Technologies, which took place in Palma de Mallorca, June 14 to 18.

On this occasion, we presented the latest developments to the RainCode Checker for Ada, a quality control tool, which performs an automatic check for compliance to a set of coding guidelines, and generates a detailed report of the offences to those rules.

Downloadable Evaluation/Demo Version

Do you want to see RainCode at work ? It is simple and easy: just register here and log in. On the download page, you will have access to the demonstration / evaluation version of the RainCode Engine for Ada. It is not a mere slide show presenting the product, this demo is an actual running version of RainCode, together with a few typical scripts. The demonstration part shows you some of the essential functions of the tool applied to some real Ada sources taken from GNAT. Running the demo, you will get, for each step, a complete explanation of the task RainCode is about to perform. You will see the scripts which make the tool work, and the source on which it is applied. Of course, you also get to see the result of the application. In less than 5 minutes, you'll see for yourself what RainCode can do for you. If you want to investigate further what can be done with the RainCode Engine, the evaluation part will allow you to write all the scripts you want and apply them on a set of given sources.

Note: under Windows 2000, you need to have the Administrator rights in order to install this demo/evaluation version.

The demonstration/evaluation version is currently only available under Windows. However, the actual RainCode Engine is multi-platform: Unix, Linux, Solaris, HP Unix, NT, OS/2, MVS, etc.