Make the description of the TR-DOS disk drives identifiers clearer.

FossilOrigin-Name: 4cda2cc1d8501b54e6b20eceaca0daf5c1b3ac5ecf15c93e3ffe8756136c4675

Author: programandala-net

README.adoc

@@ -7,7 +7,7 @@
 // This file is part of Solo Forth
 // http://programandala.net/en.program.solo_forth.html
 
-// Last modified: 202101042314.
+// Last modified: 202101061748.
 
 // Description {{{1
 == Description
@@ -387,6 +387,28 @@ configured as double-sided and 80-track in the emulator.
 [#_run_trdos]
 === In TR-DOS
 
+// tag::trdos_disk_drives[]
+
+[IMPORTANT]
+--
+[#trdosdiskdrives]
+The TR-DOS version of Solo Forth uses numbers as disk drive
+identifiers (the same numbers TR-DOS uses internally) instead of the
+letters used by the TR-DOS BASIC interface:
+
+.TR-DOS disk drive identifiers
+|===
+| Drive | In TR-DOS | In Solo Forth
+
+| 1st   | A         | 0
+| 2nd   | B         | 1
+| 3rd   | C         | 2
+| 4th   | D         | 3
+|===
+--
+
+// end::trdos_disk_drives[]
+
 // tag::run_pentagon[]
 
 // On Pentagon 128 {{{3
@@ -530,19 +552,8 @@ configured as double-sided and 80-track in the emulator.
 Notice that the library is split into two disks because the maximun
 capacity of a TR-DOS disk is only 640 KiB.
 
-Also notice that the TR-DOS version of Solo Forth uses numbers as disk
-drive identifiers (the same numbers TR-DOS uses internally) instead of
-the letters used by the TR-DOS BASIC interface:
-
-.TR-DOS disk drive identifiers
-|===
-| Drive | In TR-DOS | In Solo Forth
-
-| 1st   | A         | 0
-| 2nd   | B         | 1
-| 3rd   | C         | 2
-| 4th   | D         | 3
-|===
+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,

src/doc/manual_skeleton.adoc

@@ -1,7 +1,7 @@
 = Solo Forth: Version {version} for {dosname}
 :author: Marcos Cruz
 :producer: Marcos Cruz
-:revdate: 2021-01-05
+:revdate: 2021-01-06
 :doctype: book
 :lang: en
 ifdef::backend-html5[]
@@ -27,7 +27,7 @@ endif::[]
 // This file is part of Solo Forth
 // http://programandala.net/en.program.solo_forth.html
 
-// Last modified: 202101042044. 
+// Last modified: 202101061749.
 
 ifdef::backend-html5[]
 toc::[]
@@ -691,6 +691,8 @@ ifdef::trdos[]
 // prevents Asciidoctor PDF from issue warnings about the expected
 // list item indexes.
 
+include::doc.README.linked.adoc[tags=trdos_disk_drives]
+
 include::doc.README.linked.adoc[tags=run_pentagon]
 
 include::doc.README.linked.adoc[tags=run_scorpion]