- ... documentation1.1
- For historical reasons these
are all referred to as code, although source would be a
more accurate name
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ... core6.1
- aips, dish, synthesis
and vlbi packages
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ... complete6.2
- Tools like ``Purify'' and ``TestCenter''
should be used if they are available.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ...trial.6.3
- (your-workspace)/code/trial - at the same logical level as
aips, dish, vlbi, synthesis and all of the site-specific packages
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ...tNewClass.cc6.4
- If there is more than one
test, exec, output or demo program, name subsequent files,
for example tNewClass1.cc, tNewClass2.cc -
the first program is implicitly number zero.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ...aips2-cop@nrao.edu6.5
- If the class source code
amounts to many thousands of lines of text, explain this to the cop -
it may be possible for the reviewer to examine the code ``in place'',
on your machine, or checked in to the trial directory.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ... code.6.6
- A handy
way to construct a test program for a new class is to copy the class
header file into a new file - which will become the test program -
and edit the member function declarations into member function calls.
This simple approach guarantees that all of the member functions are
called. The next step would be to intentionally call all of the
member functions in such a way that all the exceptions are thrown:
if you trigger and catch all of the exceptions, then you have gone
a long way towards exercising all of the code. ``Domain'' coverage should
be attempted too: exercise the member functions by calling them with a
range of inputs, paying particular attention to the boundaries of the domain.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ...
differences6.7
- We hope that, in time, the AIPS++ project will
find or develop a ``diff'' tool that is smart enough to compare
numbers, and distinguish between allowable differences (due to
word-length round-off) and unacceptable numerical error.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ... classes7.1
- you need to look at the .h
files to see the definition as they do not show up in the .html files
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ... mode7.2
- There is an old mode enabled using the
-z option which adds identification numbers starting at
1000 for each .cc file and increments by 10 to allow sufficient
space for inserting new entries. You should rebuild your object
library from scratch after running reident using this mode
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
- ... program.7.3
- If you are
modifying an existing class and you find you need to add additional
templates to the test program it is likely that these same templates will
be used by other programs using this class. So you will need to go and
find them and if they are applications then just put the templates in the
system (_Reposfiller) templates file, otherwise you will need to modify
the templates file of other test programs that use the modified class
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.