 |
 |
Hi All, I took quick look at the starlink documents that aren't linked to a specific package (e.g. living in starlink/docs/ etc in the source code tree). I think quite a lot of them are now obsolete or of historical interest only, and I'd like to move them in to the starlink/docs/obsolete section so we don't have to bother building them anymore. I've gone through everything that is in the starlink/docs/ source code directory, and categorized them as KEEP or OBSOLETE below. Please let me know if you think any of these should really be kept (or any that should be obsoleted). It would be helpful if you'd volunteer to ensure the doc is up-to-date if you think it should be kept. SUNS TO KEEP: ---------------- sun1: (though rather out of date in places) sun101: Introduction to ADAM Programming sun202: Starlink Subroutine Libraries: A Guide for Program Development and Linking sun249: INT-WFC - Astrometric Calibration for the INT Wide Field Camera sun243: SPLAT documentation (should this be located with the SPLAT source? Also has not been built at JAC) sun248: Building Starlink Software (this doc doesn't build at the JAC). SUNS TO OBSOLETE: ------------------ 1) Out of date documentation for standard unix/linux software that was not created by starlink. Most of these are partly/mostly about the mechanics of running the software on the computing systems provided by the starlink project, or just notes to let the starlink community know that the software is now available to them. *********************** sun9: LaTeX --- A Document Preparation System sun34: GNU EMACS --- Display Editor sun63: SPAG is a program for unscrambling `spaghetti' Fortran code. sun73: FORCHECK A Fortran Verifier and Programming Aid< sun107: MAPLE: Mathematical Manipulation Language Maple V release 4 User's Guide sun145: UNIX An Introduction sun168: EDT mode for JED An advanced Unix text editor Version 2.0 (Malcolm says he uses this doc, but we don't actually appear to be shipping any of the associated software.) sun169: PINE -- Electronic mail interface sun170: Editors on UNIX sun172: FTNCHEK A Fortran77 Source-code Checker sun189: ISPELL - Spelling Checker sun192: nu/TPU -- A DEC TPU compatible editor for UNIX sun197: GHOSTSCRIPT - PostScript Interpreter/previewer sun201:LATEX2HTML LATEX to HTML converter (currently we are still building this software, although hopefully not for too long) Out of date astronomy guides that I think are probably of historical interest only (mostly to software we don't ship or have already moved to obsolete): ****************************** sun20: ULDA/USSP — Accessing the IUE Uniform Low-Dispersion Archive sun30: Using the Starlink Database MicroVAX computer. sun58: IUEDA --- Access to the IUE data archive sun82: IRAS — Data Products Primer sun91: IRAS — Calibrated Raw Detector Data Analysis User Guide sun119: CHI Catalogue Handling Interface sun127: The EXOSAT Database System sun161: IRAS90 Introductory/User Guide to Calibrated Reconstructed Detector Data Analysis (should this be in applications/obsolete/iras90 instead of moving to docs/obsolete ?) sun162: A Guide to Astronomical Catalogues, Databases and Archives available through Starlink sun163: IRAS90 -- IRAS Survey and PO Data Analysis Package (should this be in applications/obsolete/iras90 instead of moving to docs/obsolete ?) sun165: IRAS90 Programmer's Guide (should this be in applications/obsolete/iras90 instead of moving to docs/obsolete ?) sun174: An Astronomer's Guide to On-line Bibliographic Databases and Information Services sun205: FORUM -- Starlink Conferencing Software sun207: AIPS -- Astronomical Image Processing System sun247: XRT: ROSAT XRT Data Reduction SGs to KEEP --------------- sg4: ADAM The Starlink Software Environment sg6:ADAM Programmer's Facilities & Documentation Guide ?? sg9: Introduction to Echelle Spectroscopy ?? SGs to move to OBSOLETE ------------------------ sg8: An Introduction to Visualisation Software for Astronomy sg10: Preparing to Observe sg12: An Introduction to IRAF SGPs to KEEP --------------- sgp4: Starlink C Programming Standard sgp28: How to write good documents for Starlink (this is pretty out of date, but Malcolm wanted to keep it). sgp31: Starlink Standard Data Structures SGPs to move to OBSOLETE --------------------------- sgp1: Procedure for reporting bugs sgp2: Starlink Software Support Responsibilities sgp7: Unix and Starlink sgp12: AVS as a GUI for ADAM sgp16: Starlink Application Programming Standard (States that everything should be written in Fortran77...) sgp21: Starlink Software Distribution Policy sgp25: Starlink Site Manager's Guide sgp31: STARLINK sgp41: Local Management Arrangements sgp42: Starlink Software Strategy sgp44: Guidelines for Starlink Software Strategy Groups sgp45: ADAM Review Panel Report sgp47: Computer Algebra Software sgp49: Starlink's Support for PCs sgp50: Starlink Document Styles sgp51: Starlink Software Maintenance Procedures sgp52: Plan for Starlink Software Distribution SSNs to KEEP ------------ ssn3: The ECH Echelle Spectrograph Model Package (should possibly be moved into applications/echomop?) ssn8: Naming Conventions for Accessing Starlink Subroutine Libraries ssn22: Coordinate Systems for Pixel Arrays ssn64: ADAM -- Organization of Application Packages ssn75: Writing Catalogue and Image Servers for GAIA and CURSA (?) ssn78: The starlink build system (ssn78 doesn't build at the JAC) SSNs to OBSOLETE -------------------- ssn6: The Cipher M990 Tape drive ssn7: Administering Starlink Sun systems ssn18: Administering Solaris Sun systems ssn23:Starlink Benchmarking Utility ssn24: Notes for Site Managers about TEX and LATEX ssn26: Configuring, monitoring and tuning SPARC/Solaris systems ssn27: staradmin -- Starlink User Database Maintainer ssn30: SYSTUNE Tools for SPARC/Solaris Performance Monitoring and Tuning ssn31: A Starlink Guide to Cartridge Tape Subsystems ssn32: Custom Jumpstart Tutorial ssn33: Installing Starlink FORUM ssn36: XpressWare Installation User guide ssn37: Starlink Security ssn39: GKS -- Installation and Modification ssn67: Unix Security Cookbook SUG: ------ SUG1: The STARLINK USER'S GUIDE its a *little* out of date.