Hi Steve,
> Page 3 (NEW) Release Notes. Needs Windows stuff.
needs a bit of a tidy up yet.
- NDF's should be NDFs.
- Saying "or Java crashes due to signals (usually SIGSEGV)" is a little
odd, signals are not the cause of the crash, just how UNIX says
there's something up please handle this condition (often the only
response is for the application to exit).
Probably just saying "or Java crashes (SIGSEGV)" is enough.
(This applies to SUN/251 as well).
- There's a lot of inconsistent use of typographical styles. For
instance /star is in a fixed font sometimes and at others not.
Generally we use a fixed font (/verb or /texttt) for things that are
typed, commands (quick_install), filenames (/star), environment
variables etc. See the rest of the document for a guide on all of
this.
- Don't put a dollar sign in front of environment variables, unless
you mean their values.
- In the 7th paragraph you say:
The /star soft link to you
which should be
The /star soft link to your
(soft link should probably be soft-link, but that's a question of
choice).5D
- In the 10th paragraph you say:
the prompts given my the script
which should be
the prompts given by the script
> Page 5 Conditions of use.
Loath to say anything, but, are we really applying the GPL to everything,
I thought the status of some items was to be decided, and some (libraries)
were covered by the LGPL. Perhaps some attempt to define its
applicability is needed?
> Pages 11-16, Software Changes.
- 4.1
JCMTDR: The first sentence of the JCMTDR item is mangled (no period,
is the word "data" needed).
STARJAVA: put the filenames in a fixed font.
FROG: "Display and analysis of"
SPLAT: "Spectral Analysis Tool"
FITS: Is that Starjava or STARJAVA?
TAMFITS: Basic FITS data access (not acccess)
More filenames needing attention...
- 4.2
ATOOLS, commands not in fixed font.
GAIA: command-line options need to be in a fixed font.
"A new" should be just "New".
Just say "can be configured using the new startup options window."
and so on.
> Page 37 Section 9.2.1, quick_install.
>
> Just run you eyes over and let me know.
OK did that!
Cheers,
Peter.
|