As well as examining all the source files from their natural home
in the main Starlink source tree (the SCB_SOURCES directory),
it is also possible to index source code from elsewhere,
by giving the pathname of the directory
or tarfile containing the source.
In this way a personalised index can be created:
suppose that scbindex has already been run
on all the source code in /star/sources,
writing index files in /star/etc/scb, as described in
the previous section,
and that you have a personal source copy (under development say) of
Figaro in ~/star/sources/figaro
.
To create your own index in ~/star/etc/scb
,
which will for the most part match the global index
but contain your version of Figaro,
you can do the following:
-- first a private copy is made of the global indexes using the supplied scbcp utility (see section 6.2), and then the Figaro parts are overwritten using scbindex. If the modified sources were in a compressed tar file in the current directory, rather than in% setenv SCB_INDEX ~/star/etc/scb % scbcp /star/etc/scb $SCB_INDEX % scbindex ~/star/sources/figaro
~/star/sources
,
then the last line above could be replaced by
It would be possible to make a personal index containing Figaro only, in which case the copying step could be avoided, but then hyperlinks to routines in other Starlink packages would not work.% scbindex ./figaro.tar.Z
To make use of the personalised index, rather than the one set as the default at install time, the following must be done:
and to use your personal index you should point it athttp://host.domain/cgi-bin/star/scb.pl
Note the index directory must be the path of the index as seen by the web server.http://host.domain/cgi-bin/star/scb.pl?indexdir=/home/user/star/etc/scb
SCB --- Source Code Browser