Peter W. Draper wrote:
> On Thu, 22 Mar 2007, Mark Taylor wrote:
>
>> On Thu, 22 Mar 2007, David Berry wrote:
>>
>>> On 22/03/07, Malcolm J. Currie <[log in to unmask]> wrote:
>>> > > Last I looked the document server was embarrassingly out of
>>> date. Any
>>> > > chance that for now, we can upgrade /star/docs on the machine
>>> that > > serves
>>> > > documents?
>>> > > Yes I wanted to do this for a couple of releases ago. Well
>>> since I've
>>> > not had the intellectual transfer of how the web stuff is
>>> arranged, I've
>>> > naively replaced the /docs in the webmaster's directories with the
>>> > hokulei
>>> > release (retaining the old stuff. I've not tackled the obsolete
>>> > manuals.
>>>
>>> That looks to have worked. But the page
>>>
>>> http://www.starlink.ac.uk/static_www/docs_d_SUN.html
>>>
>>> needs updating since it does not include recently added SUNs (CUPID in
>>> particularly - SUN255).
>>
>> also the links to listed starjava-related SUNs (SPLAT 243, TOPCAT 253,
>> FROG 254) are broken. Others (STIL 252, STILTS 256) are missing. This
>> isn't very surprising, since they're built/installed outside of
>> /star/docs and aren't all in HTX format. The location of some of
>> these is as follows:
>>
>> /star/starjava/docs/sun243.htx/sun243.html (SPLAT)
>> /star/starjava/docs/topcat/sun253/index.html (TOPCAT)
>> /star/starjava/docs/ttools/sun256/index.html (STILTS)
>>
>> I don't think the others are built within the starjava system, though
>> the most recent release version of SUN/252 can be found at
>>
>> http://www.starlink.ac.uk/stil/sun252/index.html (STIL)
>>
>> It may or may not be worth whoever's while is looking at this
>> to add/fix these references.
>
> There are also many cookbooks missing, in fact nothing from "docs" has
> been installed (because they are not built as part of "make world"). Not
> sure why this isn't done.
>
>
> Mark,
>
> you might have noticed the odd position of SUN/243 in the starjava tree,
> that's so that "findme" and "showme" will locate it (/star/starjava/docs
> is in the default HTX_PATH), if we could position SUN/253 in a similar
> fashion it should also be picked up by these commands.
>
> Peter.
There use to be a makefile for building the docs, i.e. the dvi and ps
files. Not sure what happened to it during the move to CVS. It was
something run at release time when I updated the website. Just replacing
/star/docs will leave you with loads of dead links if you haven't
already noticed.
Steve.
|