Transcript Thomas

GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
User Support
Thomas Lindner
SLAC
January 16th, 2001
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
User Support
– Over the past couple months we’ve been
improving user support. Couple specific points:
• Added to our online documentation on the
main Glast Software page.
http://www-glast.slac.stanford.edu/software/
• Simplified the process of checking out and
building the code by
1. increasing the use of checkout packages
2. collecting the external libraries in one place
• Worked on ways of implementing our use of
doxygen.
T. Lindner
2
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
Online Documentation
– We’ve been increasing and improving the online
software documentation.
– In particular we’ve added a How-To page
http://wwwglast.slac.stanford.edu/software/CodeHowTo/
– This page explains the important concepts and
commands in cvs and CMT.
– It also covers how these commands are used to
build, run and develop CMT packages.
T. Lindner
3
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
Checkout Packages
– One drawback to CMT is that it isn’t always clear
which versions of which packages are meant to be
used together.
– Our solution has been to define checkout
packages: these are simply packages in which the
versions of all dependent packages are defined.
– Added a page that lists all the checkout packages
http://www.slac.stanford.edu/exp/glast/ground/softw
are/LatestPackages/index.htm
– The page gets updated nightly by a perl script.
T. Lindner
4
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
External Libraries
– We have also been rationalizing how external
libraries are treated.
– First, this involved ensuring that all necessary
libraries, on all supported platforms, were
available from the SLAC ftp site.
– Second, we have implemented a more sensible
method for CMT to find all these external libraries.
This meant, principally, some reworking of the
CMT package EXTLIB.
– More info at
http://wwwglast.slac.stanford.edu/software/CodeHowTo/exter
nal_libraries.htm
T. Lindner
5
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
Documentation (Doxygen)
• We’ve been working on
implementing our use of
doxygen.
– Doxygen-style comments
have been included in the
new packages which use
Gaudi.
– VCMT will now create the
doxygen documentation
for a package.
T. Lindner
6
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
Doxygen (cont’d)
– We also have a script that produces doxygen
documentation for a complete checkout set.
– You can see examples of this documentation at
http://wwwglast.slac.stanford.edu/software/CodeHowTo/doxy
gen_documentation.htm
– A page (of the How-To page) describes the
suggested use of doxygen.
T. Lindner
7
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
User Support (add.)
• The following pages will be of use to people having
problems
– People to Call
http://www-glast.slac.stanford.edu/software/GlastBusters.htm
– Trouble Shooting
http://wwwglast.slac.stanford.edu/software/CodeHowTo/TroubleShooting.htm
– Gaudi FAQ
http://www-glast.slac.stanford.edu/software/Gaudi/doc/faq.htm
T. Lindner
8
GLAST LAT Offline Software
Workshop - SLAC, Jan. 16-19, 2001
Platform Support
• Platform Support
– Much of the core development continues to be on
Windows.
– But we still support both Solaris and Linux. This
should not prove too dificult as long as progress
does not continue on one system for too long
without testing the other systems.
– Official releases will naturally be tested first on all
three systems.
T. Lindner
9