Steve (and others, a bit),
I've been in touch with Tim Lister about the bug he reported, which was
essentially that there was no obvious documentation on how to rebuild a
CVS checkout after an update. I think this points to a couple of
problems with the process, which might become more important now we're
probably moving towards a more open-sourcy way of looking after the
software.
(1) Tim said:
> Also nothing seems to get installed into /star64/docs/ssn78 by 'make
> world' but this may be deliberate.
This is certainly the case, in the sense that nothing in the docs/ tree
is built or installed, only docs which are managed within other parts
of the tree. Also, there's no SSN/78 at
<http://www.starlink.ac.uk/static_www/docs_d_SSN.html> -- ought there
to be, do you think?
The README in docs/ says
``They are (currently) distributed on Starlink systems in the
"docs" package and installed into $STARLINK/docs along with other
latex/html Starlink documentation.''
I think this may be out-of-date information, as there doesn't appear to
be a `docs' component, and currently no provision for installing all
these non-application-specific docs. Any feelings, anyone, on what we
should do here?
(2) As Tim mentioned, he reported this as a bug against the `tcsh'
component, because there didn't seem to be anything better. We
probably do need a category for buildsystem issues.
Could the product+component categories be refactored a bit? Currently,
there's a whole list of `products' like `a2ps', `adam', `agi', ...,
each of which has one `component' with the identical name. This seems
at least a bit wierd. How about `products' called `apps+libs',
`buildsystem', `thirdparty', `docs' and `misc'?
(3) I think I've resolved Tim's report, by making adjustments to the
top-level README, pointing more usefully at SSN/78. However, looking
at <http://dev.starlink.ac.uk/bugzilla/show_bug.cgi?id=37>, I've no
idea what to do next: I'd like to change the status to `resolved' (I
suppose -- is that what I ought to want?), but it's not obvious how I
do this.
Any ideas?
All the best,
Norman
--
----------------------------------------------------------------------
Norman Gray : Physics & Astronomy, Glasgow University, UK
http://www.astro.gla.ac.uk/users/norman/ : www.starlink.ac.uk
|