next up previous 62
Next: type argument, and pattern matching
Up: Command line operation
Previous: name argument (basic use)


package argument

If the extractor can find a Fortran subroutine or function, or a C function or macro definition, with the name supplied on the command line, it will extract the relevant source file. However it is sometimes necessary to restrict the search further, since there may be more than one source file answering to that description. So it is also possible to specify the package in which you expect to find the file or routine. For instance, there is one file called `help.f' in package HLP and another in POLMAP. To ensure that you get the one in HLP, specify it on the command line using the `package=' argument:

% scb help.f package=hlp
Note that the package argument only serves as a hint to the extractor program: if the requested file/routine occurs in the specified package, then that one is retrieved. If it does not, but it does exist in another package, then that one is retrieved. Thus, given that there is no file help.f in CCDPACK,
% scb help.f package=ccdpack
and
% scb help.f
will give the same result, which is one or other of the help.f files from either POLMAP or HLP (picked more or less at random).

The `package=' part may be omitted, so that

scb help.f hlp
is equivalent to
scb help.f package=hlp



next up previous 62
Next: type argument, and pattern matching
Up: Command line operation
Previous: name argument (basic use)

SCB --- Source Code Browser
Starlink User Note 225
M. B. Taylor
10 December 1999
E-mail:ussc@star.rl.ac.uk