Cross source file links added to enable non-HTML output to have worki…

…ng links.
NormanDunbar · Jan 12, 2017 · 5a7fef0 · 5a7fef0
1 parent 1a16109
commit 5a7fef0
Show file tree

Hide file tree

Showing 50 changed files with 6,594 additions and 3,123 deletions.
diff --git a/sphinx/source/AllKeywords.txt b/sphinx/source/AllKeywords.txt
@@ -876,7 +876,6 @@ S_SAVE
 S_SHOW
 SAR
 SARO
-Sat  Saturday
 SAUTO
 SAVE
 SAVE_O

diff --git a/sphinx/source/AppendicesIntro.clean.rst b/sphinx/source/AppendicesIntro.clean.rst
@@ -5,7 +5,7 @@ This section provides a brief introduction to each Appendix, explaining
 the background. Each heading is preceded by the number of the Appendix
 in square brackets.
 
-**[1]** `Minerva <Appendix01.clean.html>`__
+**[1]** :ref:`a1-minerva`
 
 This is an introduction to the Minerva ROM replacement which not only
 corrects many bugs contained in the original Sinclair ROMs, but
@@ -16,7 +16,7 @@ It is worth noting that the QDOS operating system had relatively few
 bugs, whereas in the early QL days, hackers competed to find as many
 bugs in the SuperBASIC interpreter as possible.
 
-**[2]** `SMSQ/E <Appendix02.clean.html>`__
+**[2]** :ref:`a2-smsqe`
 
 This is an introduction to the SMSQ/E replacement operating system which
 is available for several different hardware platforms, from the standard
@@ -25,17 +25,17 @@ QL to QPC, a software emulator for PCs.
 This is a massive extension to the original QDOS operating system with
 several new keywords and fixes of existing bugs.
 
-**[3]** `Emulators <Appendix03.clean.html>`__
+**[3]** :ref:`a3-emulators`
 
 This gives general information about the range of emulators which are
 available to allow QL software to run on other computers.
 
-**[4]** `Thor Computers <Appendix04.clean.html>`__
+**[4]** :ref:`a4-thor--computers`
 
 This provides some information on using SuperBASIC on the THOR range of
 computers.
 
-**[5]** `Expansion Boards <Appendix05.clean.html>`__
+**[5]** :ref:`a5-expansion--boards`
 
 This section gives a general introduction to the main expansion boards
 currently available for the Sinclair QL. Various older add-on boards are
@@ -44,77 +44,80 @@ and possibly disk access to the QL. The boards listed here actually
 replace parts of the original QL, increasing speed and adding a host of
 other features.
 
-**[6]** `Compatibility <Appendix06.clean.html>`__
+**[6]** :ref:`a6-compatability`
 
 This section provides basic and some expert background information on
 software and hardware compatibility across the range of different QL
 machines available.
 
-**[7]** `Multiple Basics <Appendix07.clean.html>`__
+**[7]** :ref:`a7-multiple--basics`
 
 This section provides details of the various QL implementations which
 allow you to run several BASIC programs at the same time, as well as
 detailing how multiple BASICs should be used.
 
-**[8]** `Error Messages <Appendix08.clean.html>`__
+**[8]** :ref:`a8-error--messages`
 
-This appendix lists the QDOS error messages on the different ROMs, or at
+This section lists the QDOS error messages on the different ROMs, or at
 least those where we could get hold of the text. The main section will
 usually refer to the error code, so this appendix allows you to find out
 about how this is represented on your ROM as well as giving some general
 advice concerning what may have caused the problem.
 
-**[9]** `Character Set, Keyboard <Appendix09.clean.html>`__
+**[9]** :ref:`a9-character--sets`
 
 This lists the character set and informs you about the different keys
 needed to achieve the same character code on the different QDOS
 computers. Again, this may be incomplete, but it helps the programmer
 recognise foreign keyboard layouts.
 
-**[10]** `Designing New Character Sets (Fonts) <Appendix10.clean.html>`__
+**[10]** :ref:`a10-character--sets`
 
-This appendix explains how you can create and link new fonts into the
+This section explains how you can create and link new fonts into the
 QL.
 
-**[11]** `Mathematics <Appendix11.clean.html>`__
+**[11]** :ref:`a11-mathematics`
 
 This section gives some necessary background to the QL mathematics
 package to make certain keywords easier to use. Do not worry, it is
 understandable (we hope!).
 
-**[12]** `Device Drivers <Appendix12.clean.html>`__
+**[12]** :ref:`a12-device--drivers`
 
 This forms an introduction to device drivers in general and also
 provides numerous detail about the different drivers and hardware on
 different machines.
 
-**[13]** `Extended Pointer Environment <Appendix13.clean.html>`__
+**[13]** :ref:`a13-extended-pe`
 
 This section provides a short introduction to the Pointer Environment
 and explains what it has to offer.
 
-**[14]** `Coercion <Appendix14.clean.html>`__
+**[14]** :ref:`a14-coercion`
 
 This provides some brief details as to how the QL converts strings to
 numbers if necessary.
 
-**[15]** `Mouse Drivers <Appendix15.clean.html>`__
+**[15]** :ref:`a15-mouse--drivers`
 
 This section provides details of the various ways of linking a Mouse to
 the various QL implementations.
 
-**[16]** `The QL Display <Appendix16.clean.html>`__
+**[16]** :ref:`a16-ql--display`
 
 This section provides various details concerning how the QL's display is
 arranged in memory and how to ensure that programs are able to work on
 all the various display resolutions available to the QL.
 
-**[17]** `Networks <Appendix17.clean.html>`__
+**[17]** :ref:`a17-networks`
 
-This Appendix details the various options which are available to allow
+This section details the various options which are available to allow
 the QL to connect to other computers over Networks as well as setting
 out various details about how networks work and how to ensure greater
 reliability over data sent.
 
+**[18]** :ref:`a18-configuring--programs`
 
+This section covers the use of the CONFIG utility to configure a 
+program with suitable default settings.
 
diff --git a/sphinx/source/Appendix01.clean.rst b/sphinx/source/Appendix01.clean.rst
@@ -1,3 +1,5 @@
+..  _a1-minerva:
+
 A1. Minerva
 ===========
 

diff --git a/sphinx/source/Appendix02.clean.rst b/sphinx/source/Appendix02.clean.rst
@@ -1,3 +1,5 @@
+..  _a2-smsqe:
+
 A2 SMSQ/E
 =========
 

diff --git a/sphinx/source/Appendix03.clean.rst b/sphinx/source/Appendix03.clean.rst
@@ -1,3 +1,5 @@
+..  _a3-emulators:
+
 A3 Emulators
 ============
 

diff --git a/sphinx/source/Appendix04.clean.rst b/sphinx/source/Appendix04.clean.rst
@@ -1,3 +1,5 @@
+..  _a4-thor--computers:
+
 A4 Thor Computers
 =================
 

diff --git a/sphinx/source/Appendix05.clean.rst b/sphinx/source/Appendix05.clean.rst
@@ -1,3 +1,5 @@
+..  _a5-expansion--boards:
+
 A5 Expansion Boards
 ===================
 

diff --git a/sphinx/source/Appendix06.clean.rst b/sphinx/source/Appendix06.clean.rst
@@ -1,3 +1,5 @@
+..  _a6-compatability:
+
 A6 Compatibility
 ================
 

diff --git a/sphinx/source/Appendix07.clean.rst b/sphinx/source/Appendix07.clean.rst
@@ -1,3 +1,5 @@
+..  _a7-multiple--basics:
+
 A7 Multiple Basics
 ==================
 

diff --git a/sphinx/source/Appendix08.clean.rst b/sphinx/source/Appendix08.clean.rst
@@ -1,3 +1,5 @@
+..  _a8-error--messages:
+
 A8 Error Messages
 =================
 

diff --git a/sphinx/source/Appendix09.clean.rst b/sphinx/source/Appendix09.clean.rst
@@ -1,3 +1,5 @@
+..  _a9-character--sets:
+
 A9 Character Set, Keyboard
 ==========================
 

diff --git a/sphinx/source/Appendix10.clean.rst b/sphinx/source/Appendix10.clean.rst
@@ -1,3 +1,5 @@
+..  _a10-character--sets:
+
 A10 Designing New Character Sets (Fonts)
 ========================================
 

diff --git a/sphinx/source/Appendix11.clean.rst b/sphinx/source/Appendix11.clean.rst
@@ -1,3 +1,5 @@
+..  _a11-mathematics:
+
 A11 Mathematics
 ===============
 

diff --git a/sphinx/source/Appendix12.clean.rst b/sphinx/source/Appendix12.clean.rst
@@ -1,3 +1,5 @@
+..  _a12-device--drivers:
+
 A12 Device Drivers
 ==================
 

diff --git a/sphinx/source/Appendix13.clean.rst b/sphinx/source/Appendix13.clean.rst
@@ -1,3 +1,5 @@
+..  _a13-extended-pe:
+
 A13 Extended Pointer Environment
 ================================
 

diff --git a/sphinx/source/Appendix14.clean.rst b/sphinx/source/Appendix14.clean.rst
@@ -1,3 +1,5 @@
+..  _a14-coercion:
+
 A14 Coercion
 ============
 

diff --git a/sphinx/source/Appendix15.clean.rst b/sphinx/source/Appendix15.clean.rst
@@ -1,3 +1,5 @@
+..  _a15-mouse--drivers:
+
 A15 Mouse Drivers
 =================
 

diff --git a/sphinx/source/Appendix16.clean.rst b/sphinx/source/Appendix16.clean.rst
@@ -1,3 +1,5 @@
+..  _a16-ql--display:
+
 A16 The QL Display
 ==================
 

diff --git a/sphinx/source/Appendix17.clean.rst b/sphinx/source/Appendix17.clean.rst
@@ -1,3 +1,5 @@
+..  _a17-networks:
+
 A17 Networks
 ============
 

diff --git a/sphinx/source/Appendix18.clean.rst b/sphinx/source/Appendix18.clean.rst
@@ -1,3 +1,5 @@
+..  _a18-configuring--programs:
+
 18 Configuring Programs
 =======================