docs: Preliminary version of SCUBA-2 Cookbook for Kapuahi.

We need a version of the SCUBA-2 Cookbook in Kapuahi to complement the
release of much-improved SCUBA-2 reduction software.  Now this
incarnation is incomplete, has yet to be proof-read and have its
spelling checked, still has commented text, and does not build.  It
will be refined in further versions.
(cherry picked from commit 634605d02194a282c2665658ca009ef77a408708)
docs: Update authors and \stardoc* definitions, and enable a revised abstract.
(cherry picked from commit e90bfb0141938fc095474048a3ae83f2fddee7c5)
docs: Add some definitions and remove unused commented definition in SC/21.
(cherry picked from commit a205e46e041bc54e6b455195d748498885f828d3)
docs: SC/21---remove unused and add used software definitions and sort them.
(cherry picked from commit 14331ea54f5884d261269edad89f8035209ac4e8)
docs: SC/21---Align table fields for easier debugging and maintenance.

It's easier to see where the extra ampersands are when a tabular is
neatly formatted.
(cherry picked from commit 77c6c9a6348ae5762e562fd4d219a11a36d1ec2f)
docs: SC/21---complete and update References.
(cherry picked from commit 9aaee1e022f40b0dc395eac538e1ea17f7e79426)
docs: SC/21---numerous fixes.  Now builds.

Since the text had to be wrapped to a length that was readable (SGP/28
"How to write good documents for Starlink"), before other fixes could
be made, there are many changes folded into this one big commit.
These include:

  - made it compile on its own (fixing extra braces and \\, undefined
    commands, missing brace...);
  - sorted the figure labels to remove "Figure ??";
  - corrected cross reference link (sec:state -> sec:scan);
  - use standard typography such as \texttt for file names;
  - added missing citations and document links;
  - added a cross reference (could do with many more);
  - fixed numerous typo's (but it's still yet to be proof-read);
  - correct English (such as "compare with" not "compare to"
    when contrasting, and add or remove hyphens as appropriate); and
  - strive towards a more-consistent style.
(cherry picked from commit 021060178b955350685f5e6174332d6ccfa279bd)
docs: SC/21---might as well reference latest KAPPA verison.
(cherry picked from commit 2f1991cbcbbefa9d7e7a31e29ce7c2d5b93cc86c)
docs: SC/21---remove trailing spaces.
(cherry picked from commit 38dd8b83d6aa12a5c5330c9546c1fec3e8ee3067)
docs: Provide and update the build files for SC/21.
(cherry picked from commit 73c61d3e9b065a39eb0e0bf63224da4822576a7e)
gsd: Fix compiler warning
(cherry picked from commit 4c1eb5bebb3bb8ac842315549ae4aec45dd16476)
gsd: Define size of name buffer in a consistent manner

This fixes the very long standing segv we were getting in the
perl GSD test suite with gsdGet1r. We used to get it on linux
and it would be fixed if we turned down optimisation levels. We
therefore put it down to a compiler bug. Today I started getting
it from clang on OSX and it was hitting a stack corruption error.
Looking at the only variable allocated on the stack in gsdGet1x
I had:

   char name[15];

and of course that is too small for a string of length 15 plus
a nul terminator. Changing that to 16 fixed everything but I
took the opportunity to use a constant for it throughout the
library.
(cherry picked from commit 04ac25e299557d6eb247bbd01b2686797d484513)
gsd: Should not rush commits at the end of the day
(cherry picked from commit 8c4b1128dee5394b291838334d7b078d17ea772e)
gsd: More debugging code that should not have been committed
(cherry picked from commit 96adb90cc494ab3bbe15da5b54fe6919d68b6741)
ndg: Correct provenance tester
(cherry picked from commit 4801fa8d49c637ddea65e1a1607c7a9f78ecde2c)
ndg: Test new binary storage form as well as old ascii form
(cherry picked from commit 60ac5467dc0a6435fc9717ef91d7f253199425d9)
docs: SC/21--Improvements to the content and ordering.
(cherry picked from commit 13d67c566d3153104cd32d3615e561c542f1c986)
docs: Correct the title and abstract to indicate that SC/19 applies to SRO data.
(cherry picked from commit 23086c81a176fece3506e7e7b3eca2222d283277)
docs: SC/21---Append bibliography citation numbers.
(cherry picked from commit e634bd6847a56a6b41fcbba41f975896a629b3cd)
docs: SC/21---Use co-add except in labels.

There was both "coadd" and "co-add" previously.  Holly had actually
changed them to coadd, which I believe is wrong.  A Google search found
"co-add" but not "coadd" in this context.  To me coadd rhymes with
toad.  So I took the liberty of correcting them.  Some were
incorporated into commit 9ad9383078faa7. ---MJC
(cherry picked from commit 57b9cc1f66a55fe0f51012fa4a577b04c402afba)