Update/Improve the TR-DOS instructions about using the library.

FossilOrigin-Name: 6fb12ca1f7cd30f971d22109c806a31cb1ba20e20b1a72a0ac82f5b98332196d

Author: programandala-net

README.adoc

@@ -1,13 +1,13 @@
 = Solo Forth
 :author: Marcos Cruz (programandala.net)
-:revdate: 2021-01-04
+:revdate: 2021-01-16
 :toc:
 :linkattrs:
 
 // This file is part of Solo Forth
 // http://programandala.net/en.program.solo_forth.html
 
-// Last modified: 202101151948.
+// Last modified: 202101162124.
 
 // Description {{{1
 == Description
@@ -547,10 +547,10 @@ letters used by the TR-DOS BASIC interface:
 
 1. <<_run_trdos,Run Solo Forth>>.
 
-2. “Insert” the file <disks/trdos/disk_1a_library.trd> into the second
-   disk drive (called B in TR-DOS and 1 in Solo Forth), and the file
-   <disks/trdos/disk_1b_library.trd> into the third disk drive (called
-   C in TR-DOS and 2 in Solo Forth).
+2. “Insert” the file <disks/trdos/disk_1a_library.trd> into the first
+   disk drive (called A in TR-DOS and 0 in Solo Forth), and the file
+   <disks/trdos/disk_1b_library.trd> into the second disk drive (called
+   B in TR-DOS and 1 in Solo Forth).
 +
 --
 Notice that the library is split into two disks because the maximun
@@ -560,17 +560,14 @@ Also remember in Solo Forth the <<trdosdiskdrives,TR-DOS disk drive
 identifiers>> are numbers 0..3 instead of letters A..D.
 --
 
-3. Type `1 set-drive throw` to make drive 1 (i.e. the second one,
-   called B by TR-DOS) the current one.
+3. Type `1 load` to load block 1 from the first library disk. By
+   convention, block 0 cannot be loaded (it is used for comments), and
+   block 1 is used as a loader.  In Solo Forth, block 1 contains `2
+   load`, in order to load the `need` tool from block 2.
 
-4. Type `1 load` to load block 1 from the library disk. By convention,
-   block 0 cannot be loaded (it is used for comments), and block 1 is
-   used as a loader.  In Solo Forth, block 1 contains `2 load`, in
-   order to load the `need` tool from block 2.  Type `need
-   set-block-drives` to load the word `set-block-drives` from the
-   library. Then type `2 1 2 set-block-drives` to configure the second
-   and the third drives (i.e. drives 1 and 2 in Solo Forth, called B
-   and C in the TR-DOS BASIC interface) as block drives.
+4. Type `need 2-block-drives` to load and execute the word
+   `2-block-drives` from the library, setting the first two drives as
+   block drives in their normal order.
 
 5. Type `need name`, were “name” is the name of the word or tool you
    want to load from the library.

TO-DO.adoc

@@ -1,6 +1,6 @@
 = Solo Forth TO-DO
 :author: Marcos Cruz (programandala.net)
-:revdate: 2020-10-08
+:revdate: 2020-10-16
 
 // This file is part of Solo Forth
 // http://programandala.net/en.program.solo_forth.html
@@ -1419,6 +1419,26 @@ Study what the unused RAM of the Plus D can be useful for.
 // TR-DOS {{{2
 === TR-DOS ===
 
+==== 2021-01-16
+
+There seems to be a problem when the library disks are inserted into
+drives 2nd and 3rd, and `1 set-drive throw  1 load  need
+set-block-drives` is used:
+
+....
+1 set-drive throw ok
+1 load ok
+need set-block-drives
+?????????????????????????????????????????
+?????????????????????????????????????????
+?????????????????????????????????????????
+?????????????????????????????????????????
+??????????????????? ?
+#-256
+....
+
+Then `get-block-drive throw .` displays 0 instead of 1.
+
 ==== 2018-04-09
 
 Fix/rewrite `read-system-track`: When there's no disk in the drive, it

src/doc/manual_skeleton.adoc

@@ -27,7 +27,7 @@ endif::[]
 // This file is part of Solo Forth
 // http://programandala.net/en.program.solo_forth.html
 
-// Last modified: 202101160119.
+// Last modified: 202101161928.
 
 include::doc.README.linked.adoc[tags=attributes]
 
@@ -806,17 +806,20 @@ Let's see an example, how to load the game called Tetris for
 Terminals, which is in disk 2.
 
 . <<_run,Run Solo Forth>>.
-. Insert the first library disk image (disk 1a) into the first drive.
-. Insert the second library disk image (disk 1b) into the second drive.
-. Insert the programs disk image (disk 2) into the third drive.
-. Execute command ``1 load`` in order to `load` the `need` utility from
-  the first library disk.
+. Insert the first library disk image (disk 1a) into the first drive
+  (called 'A' in TR-DOS, 0 in Solo Forth).
+. Insert the second library disk image (disk 1b) into the second drive
+  (called 'B' in TR-DOS, 1 in Solo Forth).
+. Insert the programs disk image (disk 2) into the third drive (called
+  'C' in TR-DOS, 2 in Solo Forth).
+. Execute command ``1 load`` in order to `load` the `need` utility
+  from the first library disk.
 . Execute the command `need 3-block-drives`, which loads
-  `3-block-drives` from the library disk and then executes it, setting the
-  first three drives as block drives in their normal order.
+  `3-block-drives` from the library disk and then executes it, setting
+  the first three drives as block drives in their normal order.
 . Execute the command ``need tt``, which locates the first block of
-  the game (in disk 2) and loads it, loading its requirements from the
-  library as needed.
+  the game (in the third drive) and loads it, loading its requirements
+  from the library as needed.
 . Follow the instructions.
 
 When `3-block-drives` is executed, the blocks of the first three disk