Norman,
>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?
Yes, I have mentioned that before, what happened to all the docs? Over
to all you lot that made the decisions in CVS week I think.
>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.
It is in the top of the cvs repository, isn't it? There is a pointer to
the READMEs on the CVS page:
http://www.starlink.ac.uk/Download/getcvs.html.
>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?
Does it build now, should I switch it back on as part of the nightly
build? What happened to the makefile that generated all the PS and DVI
docs for the online documentation, it was part of the DOCS package. Did
someone make a note of any documentation that may have been moved to
obsolete, i.e. not distributed because it is out of date?
Can I still generate all the online documentation the way I used to be
able to, with a simple make command? I am not sure what happened to the
documentation systems, as I was not involved when all the stuff was put
in CVS.
Steve.
-----Original Message-----
From: Starlink development [mailto:[log in to unmask]] On Behalf Of
Norman Gray
Sent: 30 May 2005 18:28
To: [log in to unmask]
Subject: Docs and Bugzilla
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
|