Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!newsfeed.internetmci.com!howland.reston.ans.net!surfnet.nl!swsbe6.switch.ch!swidir.switch.ch!epflnews!dinews.epfl.ch!Magnus.Kempe
From:
[email protected] (Magnus Kempe)
Newsgroups: comp.lang.ada,comp.answers,news.answers
Subject: Ada FAQ: Programming with Ada (part 4 of 4)
Followup-To: poster
Date: 30 May 1996 17:09:48 GMT
Organization: None
Lines: 871
Sender:
[email protected] (Magnus Kempe)
Approved:
[email protected]
Distribution: world
Message-ID: <
[email protected]>
Reply-To:
[email protected] (Magnus Kempe)
NNTP-Posting-Host: lglsun4.epfl.ch
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Summary: Ada Programmer's Frequently Asked Questions (and answers),
part 4 of 4.
Please read before posting.
Keywords: advanced language, artificial languages, computer software,
data processing, programming languages, Ada
Xref: senator-bedfellow.mit.edu comp.lang.ada:45676 comp.answers:18999 news.answers:73085
Archive-name: computer-lang/Ada/programming/part4
Comp-lang-ada-archive-name: programming/part4
Posting-Frequency: monthly
Last-modified: 22 May 1996
Last-posted: 23 April 1996
Ada Programmer's
Frequently Asked Questions (FAQ)
IMPORTANT NOTE: No FAQ can substitute for real teaching and
documentation. There is an annotated list of Ada books in the
companion comp.lang.ada FAQ.
Recent changes to this FAQ are listed in the first section after the table
of contents. This document is under explicit copyright.
This is part 4 of a 4-part posting; part 1 contains the table of contents.
Part 2 begins with question 5.
Part 3 begins with question 6.
Parts 1, 2, and 3 should be the previous postings in this thread.
9: Ada and Other Programming Languages
9.1: Where can I find programs that will translate from [some language] to
Ada?
It is generally advisable to simply interface from Ada to the
existing code segments that (should) already work. Note that Ada (95)
now has an annex devoted to specifying how to interface with code
written in other programming languages (C, Fotran, and Cobol), and
there are already interfaces to C++ too.
Another option is to redesign the code, taking of course advantage of
one's knowledge of the current system. For instance, Job�Honig
reported that he did this twice, once for Coco, a parser generator for
LALR left attributed grammars, and once for Flex, the well known
scanner generator. Both attempts revealed errors in the original
software; they were uncovered by designing the new system using the
higher abstraction level allowed by Ada...
So there is support for the requirements analysis (transition to Ada),
but it is not obvious that the proposed implementation (using a source
code translator) is a good solution.
Still, you may have compelling reasons to translate your existing
source to Ada. In that case, here is a list of available translators:
* Pascal to Ada:
R.R. Software's Pastran program (Pascal to Ada Translator).
To see the differences in programming style, see "Ada for
Experienced Programmers", by A. Nico Habermann and Dewayne E.
Perry (Addison-Wesley Pub. Co., Reading, Mass., 1983). Covers Ada
and Pascal.
* Fortran to Ada: ???
* COBOL to Ada: ???
* C++ to Ada: ???
* C to Ada: ???
* Modula-2 to Ada:
(from Wayne R. Lawton)
The Idaho National Engineering Laboratory (INEL), a Dept of Energy
Lab has a basic capability for Modula-2 to Ada-83. The tool is
"research grade" quality, but may provide a starting point for
what you need. This is the same group of people who brought you
AdaSAGE. Give them a ring at (208) 526-0656. This is an answer
desk hotline in the section that wrote the tool.
If you are looking for commercial quality, I wish you the best of
luck. If you just need something to perform 80% of the grunt code
translation, I think this might meet your needs. I know of two
systems comprising about 250,000 lines of code that were
originally developed in Modula-2 then translated and cleaned up in
Ada 83 after Alsys 1.0 for the PC came out back around 1987.
* Visual Basic to Ada: NOT! :-)
9.2: How can I convert Ada 83 sources to Ada 9X?
First you should read the following document, which will provide you
with much useful information: "Changes to Ada -- 1987 to 1995", file
ch83.{ps,doc}, in directory
ftp://sw-eng.falls-church.va.us/public/AdaIC/standards/95lrm_rat/v6.0
If you're using GNAT, the tool you are probably looking for is
"gnatchop". In csh you could use something like this to quickly
process existing files:
cd dest_dir # The destination directory
foreach f ( ../src_dir/*.a ) # ../src_dir is the source directory
gnatchop $f
end
gnatchop will show you what sources are causing problems.
9.3: I hear that Ada is slower than Fortran or C, is that true?
First, note that you are comparing compilers, not languages. There is
no such thing as "fast" Ada code any more than there is "fast" C++ or
Fortran code. Now, when comparing execution speeds on similar
platforms, you must keep in mind the optimization levels, OS tuning,
etc. while making the comparisons. The bottom line is that
benchmarking, especially between two different languages, requires
_very_ careful measurement. In general, such results should be viewed
with caution.
(A message from Bevin Brett of DEC)
I have been asked to comment on the relative performance of algorithms
coded in Ada and in Fortran.
This question has come up repeatedly over the years, and deserves a
complete answer, rather than a simplistic one.
There are many factors which influence the size and execution speed of
the running program, and they all play together to get a full answer.
I shall then discuss an exact Ada v. Fortran comparison that Digital
was involved in.
First, a position statement: The variation between Ada and Fortran is
less than the variation within the language caused by the exact
implementation details. A person versed in the Ada issues should do as
well in Ada as a person versed in the Fortran issues will do in
Fortran. The size and execution speed of the result should be within a
few percent of each other.
(a) Differences due to the compiler
In the case of the DEC Ada and Fortran compilers, the optimizer and
code generator are the same. Never-the-less, the exact inputs into
the optimizer and code generator may differ slightly when the same
algorithm is compiled by the Ada and Fortran compilers, and this
can result in major differences in the generated code. In these
cases the compiler front ends can usually be modified to correct
the slower one.
We have not observed any major differences in generated code
quality between the DEC Ada and DEC Fortran compilers caused by
such issues.
(b) Differences due to the language
It is very important that the same algorithm be written in the two
languages. The biggest differences we have observed are
1. Having the wrong dimension varying fastest, since it is
desireable to have the first dimension changing fastest in
Fortran, and the last dimension in Ada. Thus when an
algorithm is transliterated, the array indexes must be
reversed.
2. Using compile-time-known bounds for arrays in Fortran, and
using unconstrained arrays in the Ada code. Knowing the exact
values of the dimensions at compile-time results in much
better code.
3. Not suppressing all the runtime checks in Ada. The Fortran
compiler assumes all array bounds are in range, and all
arithmetic operations do not overflow. You must use a pragma
Suppress to tell this to the Ada compiler as well.
4. Don't use arrays of Ada Booleans to match arrays of Fortran
Integers, because accessing bytes on a RISC system might be
much worse than accessing fullwords.
(c) Differences due to the bindings
The biggest bindings differences are related to Fortran's built-in
support for complex types, and for various math routines such as
SQRT and SIN, compared with Ada code that often uses hand-coded or
ISO standardised versions of these functions with different
requirements than are imposed on the Fortran versions.
DEC Ada has built-in support for complex types, and also has
bindings directly to the same primitives that Fortran uses for its
math routines and so gets the same performance as Fortran does.
(d) Differences due to the author
The use of good Ada and Fortran style can also effect the generated
code. Provided the author writes in good Ada style, and follows
the above guidelines, the generated code should do as well as
Fortran.
The Ada Performance Benchmark
A DEC Ada customer had a Fortran benchmark that had been translated
into Ada without awareness of the above issues, and was running
substantially slower with DEC Ada than the original was with DEC
Fortran.
Bevin Brett, a DEC Ada team member, developed the above guidelines in
the process of retranslating the code into Ada.
Portions of this translation are shown here (a) as an illustration of
the application of the above rules, and (b) as an illustration of the
kind of operations that were present in the benchmark.
The whole benchmark has not been provided to avoid possible issues of
ownership.
The resulting Ada benchmark components each ran within a few percent
of their Fortran counterparts. The Ada code is available by FTP, in
file
ftp://lglftp.epfl.ch/pub/Ada/FAQ/ada-vs-fortran.ada
9.4: Isn't Ada less "elegant" than Eiffel?
While it is true that programming-language support for "assertions"
is an important contribution of Eiffel to software construction, this
is not an issue of "elegance", and there are many other important
factors to consider.
Note also that preconditions and postconditions can be fairly easily
and efficiently included in Ada code. Invariants seem difficult to
emulate directly in Ada. If you're really interested in the formal use
of assertions with Ada, maybe Anna is a solution for you.
(Tucker Taft comments)
I guess one thing that bothers me a little is that people are quick to
say that Eiffel is "elegant" without really looking at it. I fear that
such statements will become self-fulfilling prophecies, with those
programmers interested in elegance migrating over to Eiffel rather
than sticking with Ada.
In particular, although I like the assertion stuff in Eiffel, I think
the language has a number of "inelegant" aspects. For example:
1. exception handlers only at the top level of a routine, with the
only way to "handle" an exception being by retrying the whole
routine.
2. No way to return from a routine in the middle. This makes it a
pain in the neck to search through a list for something in a loop,
and then return immediately when you find what you want. (I have
never found the addition of extra boolean control variable a help
to the understanding of an algorithm.)
3. Namespace control handled by a separate sublanguage, and no real
higher level concept of "module" or "subsystem."
4. An obscure notation like "!!" being used for an important and
frequent operation (construction).
5. No way to conveniently "use" another abstraction without
inheriting from it.
6. No strong distinctions between integer types used for array
indexing.
7. Using the same operator ":=" for both (aliasing) pointer
assignment, and for value assignment, depending on whether the
type is "expanded." (Simula's solution was far preferable, IMHO).
And most critically:
8. No separate interface for an abstraction. You can view a interface
by running a tool, but this misses completely the importance of
having a physical module that represents the interface, and acts
as a contract between the specifier or user of an abstraction and
its implementor. In Eiffel, one might not even be truly aware when
one is changing the interface to an abstraction, because there is
no particular physical separation between interface and
implementation.
I consider many of the above problems quite serious, with some of them
being real throwbacks to the old style of programming languages where
there were no well defined interfaces or modules.
Hence, I cringe a bit when people say that Eiffel is the "most
elegant" OOP and that they would use it if only it were practical to
do so. In many ways, I think Ada is much better human-engineered than
Eiffel, with important things like range constraints built into the
language in a way that makes them convenient to use. Although general
assertions are nice, they don't give you the kind of line-by-line
consistency checks that Ada can give you.
To summarize --
Although Eiffel certainly has a number of nice features, I don't
consider it ready for prime time as far as building and maintaining
large systems with large numbers of programmers. And from a human
engineering point of view, I think Ada is significantly better.
9.5: Are there any papers detailing the differences between Ada and C++?
Below are two references. Bear in mind that it is difficult to make
such a comparison without exposing biases. However, the two papers
below are well worth reading.
"A Comparison of the OO features of Ada9x and C++" in Springer Lecture
Notes in CS: "Ada Europe 93" pp.125-141 (short paper, good reading,
enlightens idioms)
ftp ajpo.sei.cmu.edu in directory: /public/ada9x, document:
9x_cplus.hlp
9.6: I keep hearing that Ada is a "strongly typed language", but it seems
different from what's meant in C++. Are they different?
(Tucker Taft responds)
I certainly agree that ANSI C and C++ are statically typed languages,
but I would debate the "strength" of their typing.
Essentially any support for implicit conversion (implicit "casting,"
"promotion", "usual" arithmetic conversions, etc.) "weakens" a type
system (but also makes it "friendlier" in some ways).
C allows implicit conversion between all integer types and all
enumeration types. C++ at least cuts off implicit conversion to
enumeration types, but retains implicit conversion among all integer
(and floating-point) types. Also, in both C and C++, typedefs for
pointer/array types are essentially "macros"; all pointer types with
the same target type are implicitly interconvertible.
Finally C++ allows the user to define a number of their own implicit
conversion operators, which basically allows the user to "weaken" the
type system as they see fit.
Of course, all of this implicit conversion serves a purpose, but it
does tend to move C/C++ toward the "weaker" end of the weak vs. strong
typing spectrum.
Note that the "strong" distinctions between integer types helps
dramatically in catching (at compile-time) array indexing errors in
Ada programs, by making sure that if you have an array indexed by a
count of apples, you don't index into it with a count of oranges
(without an *explicit* conversion). The advantages of "strongly"
distinguishing enumeration types is even more obvious (and the
designers of C++ recognized this).
The strong distinctions between access types (pointer types) in Ada
also has advantages, allowing access types to be represented as
offsets within their storage pool rather than as addresses, and giving
more high-level control over storage management.
Strong typing can be carried too far, and some amount of implicit
conversion is essential to make OOP palatable. But note that in Ada
9X, even with OOP, we don't allow implicit conversions that truncate
the extension part of a record (this is a relatively common mistake in
C++ when passing parameters by value). Instead, in Ada 9X, the
language distinguishes between a specific type T and the class-wide
type T'Class, and allows implicit conversions to T'Class from T or any
of its derivatives, but not to the specific type T. Conversions to the
class-wide type never implicitly truncate the extension part.
Conversions to a specific type can truncate, and hence must be
explicit.
Note also that in Ada there are three distinct kinds of conversions,
implicit ones, explicit ones, and unchecked ones. Only the unchecked
ones are potentially unsafe. The explicit ones are safe, with either
compile-time or run-time checks to ensure that. In C there are only
implicit and explicit/unchecked conversions. C++ has recently added a
checked, explicit "dynamic" cast, but still it will be common to use
"normal" explicit casts for both checked and unchecked conversions,
thereby making it more difficult to identify places where the type
system might be compromised.
Hence, the bottom line is that the type checking is (objectively)
"stronger" in Ada than C/C++, though that doesn't necessarily mean
"better" -- whether one is "better" for a particular style of
programming than the other is a "religious" issue IMHO. I know my
religion currently favors the stronger checking of Ada in most cases
[except perhaps for multiply/divide, where I personally believe the
checking should either be weaker, or directly support the concept of
"units"/"dimensions"].
9.7: I'm told Ada does all sorts of static type checking, but can't you get
the same effect using a tool like "lint" with C?
No, here are a few reasons why (this list is by no means complete):
(Submitted by Norm Cohen)
* Running both Lint and a C compiler requires the program text to be
parsed and semantically analyzed twice. The results of an Ada
compiler's parse and semantic analysis are used directly in
performing consistency checks.
* The rules of Ada provide the opportunity for stronger consistency
checks than are possible with C. For example, an Ada programmer
can declare distinct integer types to represent distinct
abstractions. An Ada compiler will catch an inadvertent
intermixing of these two types, but there is no way a
corresponding distinction can be made in C, so there is no way for
Lint to perform a corresponding check. Similarly, in C, a pointer
to an object of type T is indistinguishable from an array of
objects of type T.
* The rules of the Ada language ensure that the program text
provides information allowing PRECISE consistency checks. For
example, the expression in an Ada case statement can be written to
have a static subtype, allowing the compiler to ascertain that all
possible values have been covered without resorting to a default
(when others) arm.
* With lack of precise information, Lint has no choice but to be
overly pessimistic or, with different settings for a complicated
set of options, overly optimistic. When it is overly pessimistic,
the user sees too many "false alarms" and may end up ignoring
valid warnings. When it is overly optimistic, Lint overlooks
certain errors.
* It is impossible to forget to run consistency checks when using an
Ada compiler. (Of course a C programming environment could be set
up so that the C compiler could only be invoked from a script that
also invokes Lint.)
* A compilation that fails Ada consistency checks is rejected. A
compilation that fails Lint consistency checks may still be
compiled, and its object file used (intentionally or accidently)
in building the system. (One cannot automate the rejection of
programs that fail Lint unless one is certain that there will
never be any false warnings.)
* Ada enforces consistency among separately compiled units.
Of course even stronger arguments can be made about Ada's RUN-TIME
checks (which can be used with little additional overhead because the
information contained in an Ada program and the knowledge that the
program has passed compile-time consistency checks make it possible to
optimize away the majority of the checks). These checks, which are
absent in C, tend to smoke out errors early by detecting internal
inconsistencies that might not otherwise be detected during testing.
This reduces the likelihood of fielding a system that appears to work
well during testing but fails in operational use.
9.8: Does Ada have something like the Standard Template Library (STL) in C++,
or components like you find in Smalltalk environments?
Yes, in various ways.
Few components are part of the ISO standard. Ada 95 has an expanded
set of predefined library units, covering e.g. strings of varying- or
dynamic-length, elementary numerical functions, random number
generators, complex numbers, and more; in addition, the Special Needs
Annexes standardize many advanced services which have commonly been
provided by separate components in the past.
A lot of free Ada software components are available from anonymous FTP
sites. There is also an upcoming release of the Booch Components for
Ada 95 under the GNU Library General Public License (LGPL); this will
give you the ability to freely include the library components in your
application without any cost or obligation. (Contact
[email protected]
for more details.)
What about STL and the Smalltalk library?
The C++ STL doesn't contain much. Really. Breaking its source code
down, it contains less than 3000 semicolons (~7000 total lines). The
entire library exists in C++ header files as inlineable code
(supposedly within a few percent of the efficiency of hand-optimized
code).
STL class hierarchy
bool, heap -- of course Ada does not need a bool class!
\ function, pair, stack
\ iterator, tempbuf, projection
\ algobase
\ algorithms, bitvector, deque, list, tree, vector
\ map, multimap, set, multiset
The main author of the library, Alexander Stepanov, created the Ada
Generic Library in the 1980's -- and later borrowed from this to
create STL. (There is an interview with Stepanov in the March 1995
issue of Dr. Dobb's Journal -- in the C Programming column beginning
on page 115. Stepanov explains that these components were first done
in Ada.)
The Smalltalk library is quite eclectic. It covers everything from
Boolean to bitmaps, dictionaries and other collections. Parts of it
have direct equivalents in Ada 95, parts are already available in
components from anonymous FTP sites and/or will be in the Booch Ada 95
components, and other parts are available from commercial Ada
component suppliers.
9.9: Where can I find the equivalent of "printf" in Ada?
While the standard package Text_IO provides many features, the
request for a printf-like function is not unusual.
(solution based on a suggestion by Tucker Taft)
It is possible to produce a printf-like capability by overloading the
"&" operator to take an object of type Format and an object of some
type and return the Format, properly advanced, after having performed
the appropriate output. The remaining format can be converted back to
a string--e.g. to examine what is left at the end of the format
string-- or simply printed to display whatever remains at the end. For
example:
with Text_IO;
package Formatted_Output is
type Format is
limited private;
function Fmt (Str : String)
return Format;
function "&" (Left : Format; Right : Integer)
return Format;
function "&" (Left : Format; Right : Float)
return Format;
function "&" (Left : Format; Right : String)
return Format;
... -- other overloadings of "&"
procedure Print (Fmt : Format);
function To_String (Fmt : Format)
return String;
private
...
end Formatted_Output;
with Formatted_Output; use Formatted_Output;
procedure Test is
X, Y : Float;
begin
Print (Fmt("%d * %d = %d\n") & X & Y & X*Y);
end Test;
The private part and body of Formatted_Output are left as an exercise
for the reader ;-).
A "File : File_Type" parameter could be added to an overloading of Fmt
if desired (to create something analogous to fprintf).
This capability is analogous to that provided by the "<<" stream
operator of C++.
_________________________________________________________________
10: Interfacing with Ada
10.1: I am writing software that used the Distributed Interactive Simulation
(DIS) interface, does an interface exist in Ada?
Yes. DIS is a standard for communications between simulators using an
Internet Protocol network (IP). DIS provides a unified virtual
environment for multiple simulator users on a network. It is used
mostly in the DoD simulations business, but it is applicable to ANY
simulation. It is an industry initiative involving military training
and procurement organisations, simulator vendors and universities
mostly in the US, but the technology is unclassified.
The US Army is funding quite a bit of DIS research and development.
The Institute of Simulation and Training, URL
http://www.tiig.ist.ucf.edu/ is a center at the University of Central
Florida (UCF) which serves as the support contractor for the UCF IST,
as are BBS's for the DIS working groups who are attempting to push
those standards forward. The BBS contains an Ada binding for DIS.
Note that the above provides a thin binding to C code. It may be
worthwhile to take the time to make high-level DIS bindings. Ted
Dennison,
[email protected] reports having done it (while
working for what is now Lockheed Martin Simulation Systems) in over 2
man-months using an experienced Ada engineer, and that it was well
worth it. Many bugs were found in the C DIS code of the machine they
were networked with. "A strongly-typed interface is the network
programmer's best friend."
At TRI-Ada'94 there was a demonstration by Coleman Research
Corporation (CRC); here's their short pitch: "CRC presents Ada
VR-Link, the first commercially available DIS NIV. It provides all of
the facilities necessary to jump start your DIS compliant simulation
development efforts. For more information call (205) 922-6000."
Also, the AJPO sponsored an Ada Technology Insertion Program (ATIP)
relating to this: FY93 ATIP project 17, titled "Ada Distributed
Interactive Simulation (ADIS)". Available from directory
ftp://sw-eng.falls-church.va.us/public/AdaIC/source-code/bindings
/ADIS-bindings
The Ada Distributed Interactive Simulation (ADIS) provides an Ada
interface to the IEEE 1278 Distributed Interactive Simulation (DIS)
protocols. The project was developed in Ada 83 (MIL-STD-1815), on
Silicon Graphics Indigo R4000 machines using Verdix Ada 6.2.1 under
the IRIX operating system, version 5.2. The Graphical User Interfaces
(GUIs) were developed for X Window version X11R5 using Motif 1.2.
There are several sources of information available on DIS itself. The
IEEE version of the DIS standard is available through (and only
through) the IEEE (std IEEE 1278). Draft versions of the standard are
available from the Institute for Simulation and Training at the
University of Central Florida. They take orders at (407) 855-0881, and
questions (about ordering) at (407) 658-5054.
10.2: Is there any support for Common Object Request Broker Architecture
(CORBA) for Ada 9X?
OC Systems sells a CORBA Ada product; it is "Standard equipment" with
their PowerAda compiler. Rational, and OIS are also planning on
selling CORBA products for Ada.
Objective Interface Systems, Inc. (OIS), MITRE, and DISA have been
working on a mapping from CORBA IDL to Ada 95 for about six months.
Bill Beckwith (
[email protected]) will send a recent copy of the
mapping document to any interested parties.
Note that CORBA IDL to Ada 95 mapping specifies a mapping, not a
binding. This will put Ada 95 on equal footing with the C++ and
Smalltalk products. (except that, of course, the Ada mapping is
cleaner ;-).
_________________________________________________________________
11: Finding Additional Information
11.1: Where can I find Ada books?
Look at the companion comp.lang.ada FAQ or the HBAP WWW Server, URL
http://lglwww.epfl.ch/Ada/
Michael Feldman maintains the "Annotated Sampling of Ada-Oriented
Textbooks"; if you don't have access to WWW, drop him a note at
[email protected]
11.2: Are there other Ada-related FAQs?
Yes. They all appear in comp.lang.ada at regular intervals:
comp.lang.ada FAQ, public Ada library FAQ, and Ada WWW server FAQ. All
these are permanently available in hypertext format from the HBAP WWW
Server (see below) and in ASCII format from
ftp://lglftp.epfl.ch/Ada/FAQ
11.3: What is the "HBAP WWW Server"?
The Home of the Brave Ada Programmers (HBAP) WWW Server is alive and
heavily used. It is a hypertext, multimedia information server for the
Ada programming language.
The URL of the HBAP WWW Server is
http://lglwww.epfl.ch/Ada/
[don't forget the trailing '/'.]
The HBAP WWW Server provides Ada-related information and hypertext
access in areas including:
* Historical notes on Ada
* References
* Ada FAQs
* State of Ada 9X revision process
* Standards
* Bindings
* Tools and Components
* Intellectual Ammunition
* Introductory Material
* Resources
* CS Technical Reports
* FTP and WWW Sites--including mirror sites
* Calendar of Ada-related events
* Ada Today
* Frequently Asked Questions--with Answers (from comp.lang.ada)
For instance, you will find a list of schools using Ada in CS1 or CS2,
an article on commercial success stories, information about software
components, as well as hypertext versions of the Ada reference manual
(both 83 and draft 9X).
The HBAP WWW Server keeps growing. All comments, ideas, and requests
for additions or corrections, are welcome (e-mail to
[email protected]).
_________________________________________________________________
12: Pretty-printing and Measuring Ada Source Code
12.1: Is there software that generates a pretty PostScript file from Ada
source code?
Pretty Ada code in PostScript means that e.g. reserved words are in
bold and comments are in italics. This is a separate issue from
re-formatting and automatic indenting.
If you use the new Ada Mode for GNU Emacs (available from
ftp://cs.nyu.edu/pub/gnat), go and get the package ps-print.el from
any emacs archive (e.g. in directory
ftp://archive.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive). With
this package you can print your code as you see it on the screen, say
with bold keywords and italic comments.
Another possibility is to feed the source to "vgrind" (see below),
then pipe the result through "pscat" (to get PostScript) or "lpr -t"
(to print), e.g.:
vgrind -d <vgrind_defs_file> -lada -o1- -t -w $* | lpr -t
12.2: I use vgrind to do "pretty printing" of my source. Is there a vgrind
definition for Ada?
# Ada!
ada|Ada:\
:pb=(^\d?(procedure|function|package|package body))\d\p:\
:bb=if|case|begin|loop:be=end:\
:cb=--:ce=$:\
:sb=":se=":\
:lb=':le=':\
:id=_.:\
:oc:\
:kw=abort abs abstract accept access aliased all and array at\
begin body case constant declare delay delta digits do else\
elsif end entry exception exit for function generic goto if in is\
limited loop mod new not null of or others out package pragma\
private procedure protected raise range record rem renames requeue\
return reverse select separate subtype tagged task terminate then\
type until use when while with xor:
Note that the above has a problem with attributes, because the "lb"
and "le" terms make two-attributes-20-lines-apart look like one
"string literal." Ada 95 keywords are recognized.
Here is another definition, which "fixes" this problem (not perfect,
but probably better). Only Ada 83 keywords are recognized.
# In order to get the ticks to work, we are assuming that there will be
# whitespace before a literal (like '"') and *not* when used for an
# attribute (like 'Length).
# For sb/se, we are ALSO assuming that literals have whitespace before/after.
Ada|ada:\
:pb=^\d?(procedure|function|package|package\dbody)\d\p:\
:bb=begin:be=end:\
:cb=--:ce=$:\
:sb=( |\t|\()":se="( |\t|;|,|\)):\
:lb=(>| |\t)':le='(\)| |\t|;):\
:tl:\
:oc:\
:kw=abort abs accept access all and array at begin body case constant\
declare delay delta digits do else elsif end entry exception exit for\
function generic goto if in is limited loop mod new not null of or\
others out package pragma private procedure raise range record rem\
renames return reverse select separate subtype task terminate then\
type use when while with xor:
12.3: How about a source code reformatter?
If you can run a Perl script (Perl is freely available for almost
every OS in the world), you can use the program aimap, written by Tom
Quiggle of SGI. aimap is not really a pretty printer, since it only
changes the case of identifiers and reserved words (according to the
options set). It can be found at
http://reality.sgi.com/employees/quiggle_engr/aimap
12.4: How can I count source lines of code (SLOC)?
Under Unix and many operating systems (apparently even MS-DOS), the
following works well:
wc -l file_name
If you only want to count "statement lines" (lines with semicolons),
use
sed 's/--.*$//' file_name | grep ';' | wc -l
Some versions of grep have a '-c' option to print a count of the
matching lines, but this may not be universal. You can fold the
grepping into the sed command but that's not as readable:
sed -n -e 's/--.*$//' -e '/;/p' file_name | wc -l
Please note that measuring SLOC should be used to indicate an
approximate relationship to the size of other projects, and as such,
provided that there is some uniformity in the form and number of
comments, it does not matter whether comments are counted or not. It
has often been observed that there is a very high correlation between
measurements of SLOC, semicolons, and Halstead bits (there is probably
also a high enough correlation with the number of characters).
With VMS, try the following, which will print out the number of lines
("records") and characters (use ";" instead of "~~~~~" to count lines
with semicolons; note that "records" will match even in comments):
$ search/stat file_name.ada "~~~~~"
12.5: Can I measure other things?
There is ASAP, the Ada Static Analyzer Program, written in Ada and
set up to compile under Dec Ada on a Vax running VMS. Gives SLOC,
McCabe's, and more. It is available via anonymous ftp in directory
ftp://ftp.sei.cmu.edu/pub/dd
_________________________________________________________________
13: Credits
The first draft was made by Dave Weller. The following persons have
contributed (directly or indirectly, intentionally or unintentionally,
through e.g. comp.lang.ada) to the information gathered in this FAQ:
Tucker�Taft, Dave�Weller, David�Arno, Christine�Ausnit, Bill�Beckwith,
Moti�Ben-Ari, Chip�Bennett, Bevin�Brett, David�Bulman,
G.�Vincent�Castellano, Norm�Cohen, Marin�David�Condic, John�Cosby,
Richard�Crutchfield, Theodore�E.�Dennison, Robert�Dewar, Bob�Duff,
Robert�Eachus, Rolf�Ebert, Dave�Emery, Mitch�Gart, Victor�Giddings,
Jeffrey�L.�Grover, Laurent�Guerby, Richard�G.�Hash, Matthew�Heaney,
Fergus�Henderson, Niklas�Holsti, Job�Honig, Jean�D.�Ichbiah,
Nasser�Kettani, Wayne�R.�Lawton, Robert�Martin, Robb�Nebbe,
Jonathan�Parker, Isaac�Pentinmaki, Bruce�Petrick, Paul�Pukite,
Richard�Riehle, Keith�Shillington, David�Shochat, Andr�Spiegel,
Keith�Thompson, Joyce�Tokar, Kevin�Weise, David�A.�Wheeler,
Fraser�Wilson, and the maintainer has simply :-) organized, polished,
or added some information for your satisfaction. The general HTML
structure of this FAQ was originally inspired by the (now differently
structured) WWW FAQ.
_________________________________________________________________
14: Copying this FAQ
This FAQ is Copyright � 1994-1996 by Magnus Kempe. It may be freely
redistributed --as posted by the copyright holder in comp.lang.ada--
in other forums than Usenet News as long as it is completely
unmodified and that no attempt is made to restrict any recipient from
redistributing it on the same terms. It may not be sold or
incorporated into commercial documents without the explicit written
permission of the copyright holder.
Permission is granted for this document to be made available under the
same conditions for file transfer from sites offering unrestricted
file transfer on the Internet and from Forums on e.g. Compuserve and
Bix.
This document is provided as is, without any warranty.
_________________________________________________________________
Magnus Kempe --
[email protected]
