@nataliapc/mcp-openmsx 1.1.14 → 1.2.2

package/resources/programming/basic_wiki/PRESET.md

@@ -0,0 +1,61 @@
+# PRESET
+
+## Effect
+
+Puts a point of specified color on a graphic screen (2 to 8, 10 to 12). If not specified the current background color is chosen.
+
+## Syntax
+
+`PRESET STEP(<X>,<Y>),<Color>,<Operator>`
+
+_Note: Do not put a comma if no parameters are behind._
+
+## Parameters
+
+`<X>` is coordinate X (0-255/511) of the point to put or remove on the screen.
+
+`<Y>` is coordinate Y (0-191/211) of the point to put or remove on the screen.
+
+Coordinates cannot be omitted.
+
+If `STEP` is used before these coordinates, they are interpreted relative to the current cursor position. In this case the values can also be negative.
+
+`<Color>` is the color to be used = 0 to 15 (screens 2 to 5, 7 and 10), 0 to 3 (screen 6), 0 to 255 (screens 8, 11, and 12). When this parameter is specified, `PRESET` works like PSET. If `<Color>` is not specified the current background color will be used instead the draw color for PSET, what implies that the point is not displayed or can even be removed.
+
+`<Operator>` is the logical operation to be performed between the color of the old pixel and the new color. This parameter can be used only on screens 5 to 8 and 10 to 12, it requires a MSX2 or higher computer.
+
+The available operators are `AND`, `OR`, `PRESET`, `PSET` (default), `TAND`, `TOR`, `TPRESET`, `TPSET`, `TXOR`, `XOR`. Specifying a logical operation preceded by "T" causes nothing to be done when specified color is transparent (color 0).
+
+The effect of the operators is done on each corresponding bit as shown in the following table.
+
+|Current bit|Copied color bit|AND|OR|PRESET|PSET|XOR|
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+|0|0|0|0|1|0|0|
+|0|1|0|1|0|1|1|
+|1|0|0|1|1|0|1|
+|1|1|1|1|0|1|0|
+
+## Example
+
+```basic
+10 COLOR 15,1,4: SCREEN 2
+20 LINE (40,40)-(215,151),7,B
+30 FOR I=0 TO 100
+40 A=INT(RND(1)*173)+41
+50 B=INT(RND(1)*109)+41
+60 PRESET(A,B)
+80 NEXT I
+90 GOTO 90
+```
+
+## Related to
+
+`CIRCLE`, `COLOR`, `DRAW`, `LINE`, `PAINT`, `POINT`, `PSET`, `SCREEN`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/PRESET"

package/resources/programming/basic_wiki/PRINT.md

@@ -0,0 +1,179 @@
+# PRINT
+
+## Effect
+
+Displays and formats text and numbers on the screen or sends formatted data to different devices through file handling.
+
+_Note: `PRINT` can be replaced by the `?` character. This will be expanded to `PRINT` when listing a MSX-BASIC program._
+
+## Syntax
+
+`PRINT #<FileNumber>, USING <ItemFormat>; <Item>;<Item>...`
+
+## Parameters
+
+`<Item>` can be a character string, an expression, a variable or a value to display or send. All four items types can be mixed freely.
+
+Items must be separated by `;`. If the last item does not end to `;` then `CR`+`LF` combination is displayed or sent.
+
+A comma can replace a `;` to separate the items. In case of `,` they are separated by tabulator instead of a space.
+
+`<Item>` can be omitted to display or send an empty line.
+
+`#<FileNumber>`, is optional. `<FileNumber>` is a number between 0 and 15 that points to opened file name. Please see `OPEN` instruction.
+
+`USING <ItemFormat>;` is optional. `<ItemFormat>` is a string that defines how the next items to be displayed or sent must be formatted. When `USING` is used the type of following usable items depends on the specified format.
+
+The format string can contain following definitions:
+
+_**Editor's note: Following table and comments are inaccurate and need revisiting.**_
+
+<table>
+<tr><th>Format definition</th><th>Data type</th><th>Description</th></tr>
+<tr><td>!</td><td>String</td><td>Prints only first character of current item. Example:
+
+```basic
+PRINT USING "!";"United","Nations"
+UN
+```
+</td></tr>
+<tr><td>\[n spaces]\</td><td>String</td><td>Prints n+2 characters. When the length of the data is less than n+2 characters, the rest is padded with spaces. Example:
+
+```basic
+PRINT USING "\  \";"ABCDEF","GHI","JKLMN"
+ABCDGHI JKLM
+```
+</td></tr>
+<tr><td>&</td><td>String</td><td>Displays the whole string. Example:
+
+```basic
+A$="North";B$="South":PRINT USING "& Pole ";A$,B$
+North Pole South Pole
+```
+</td></tr>
+<tr><td>#</td><td>Number</td><td><li>Reserves a space (up to 24) for number. Decimal point can be specified with the full stop ".". Example:
+
+```basic
+PRINT USING "POINT:###.#";123.4
+POINT:123.4
+```
+<li>When the amount of digits is smaller than the amount of specified `#`, the number is displayed with equal amounts of margins at both sides and when the number of digits is larger, a `%` is output. Example:
+
+```basic
+10 PRINT USING "####";12
+20 PRINT USING "####";12345
+RUN
+  12
+%12345
+```
+<li>When the number of digits behind the decimal separator is smaller than the amount of the input, it is padded with a "0" and when it is larger, it is rounded to the nearest integer number. Example:
+
+```basic
+10 PRINT USING "##.##";25.3
+20 PRINT USING "##.##";25.345
+RUN
+25.30
+25.35
+```
+<li>When displaying numeric data, the "+" sign is ignored and the character is counted as a number. Example:
+
+```basic
+10 PRINT USING "###";+123
+20 PRINT USING "###";-123
+RUN
+123
+%-123
+```
+</td></tr>
+<tr><td>+</td><td>Number</td><td>Positive numbers will be output with "+"-sign and negative numbers with a "-"-sign. Either in front or behind the number. Example:
+
+```basic
+10 PRINT USING "+####";123,-123
+20 PRINT USING "####+";123,-123
+RUN
+ +123 -123
+ 123+ 123-
+```
+</td></tr>
+<tr><td>-</td><td>Number</td><td>Can be used to mark "-" to end of number when the number is negative. Example:
+
+```basic
+PRINT USING "###-";123,-123
+RUN
+123 123-
+```
+</td></tr>
+<tr><td>**</td><td>Number</td><td>The space for numerical data will be filled with "*" characters. A single "*" represents a single digit. Example:
+
+```basic
+10 PRINT USING "**######";123
+20 PRINT USING "**######";-234
+RUN
+*****123
+****-234
+```
+</td></tr>
+<tr><td>££</td><td>Number</td><td>Displays "£" in front of number. One "£" layout symbol counts as digit. Example:
+
+```basic
+10 PRINT USING "££###";1234
+20 PRINT USING "+££###";-1234
+RUN
+£1234
+-£1234
+```
+</td></tr>
+<tr><td>**£</td><td>Number</td><td>Displays "£" in front of number and fills up heading spaces with "*". Example:
+
+```basic
+PRINT USING "**£###.##";12.34
+***£12.34
+```
+</td></tr>
+<tr><td>,</td><td>Number</td><td>Numbers will be printed in groups of 3 separated by "," if a comma is used somewhere before the decimal point. Example:
+
+```basic
+PRINT USING "#,######.##";12345.67
+  12,345.67
+```
+</td></tr>
+<tr><td>^^^^</td><td>Number</td><td>Displays the number in scientific format. The ^^^^ part represents the numbers of the exponent part. Example:
+
+```basic
+PRINT USING "##.##^^^^";234.56
+  2.35E+02
+```
+</td></tr>
+</table>
+
+_Please note: Format string should be used with caution. Pound signs should be avoided since this causes compatibility problems. On some machines this is "$" depending on local currency. "&" has been replaced with "\" on european and Brazilian machines causing easily _"Type missmatch"_ error in localized machines. In Japanese machines "\" is printed as "¥"._
+
+## Examples
+
+```basic
+10 FM$="The print documentation on & & has ##.#% relative accuracy"
+20 PRINT USING FM$;"MRC",5
+ 
+RUN
+The print documentation on MRC has  5.0% relative accuracy
+Ok
+```
+
+```basic
+PRINT USING "!!!";"Alpha";"Beta";"Charlie"
+ABC
+Ok
+```
+
+## Related to
+
+`CSRLIN`, `LOCATE`, `LPRINT`, `MAXFILES`, `OPEN`, `POS()`, `SCREEN`, `SPC()`, `TAB()`
+, `WIDTH`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/PRINT"

package/resources/programming/basic_wiki/PSET.md

@@ -0,0 +1,82 @@
+# PSET
+
+## Effect
+
+Puts a point of specified color on a graphic screen (2 to 8, 10 to 12). If not specified the current plot color is chosen.
+
+## Syntax
+
+`PSET STEP(<X>,<Y>),<Color>,<Operator>`
+
+_Note: Parameters can not end with a comma alone._
+
+## Parameters
+
+`<Y>` is coordinate X (0-255/511) of the point to put on the screen.
+
+`<Y>` is coordinate Y (0-191/211) of the point to put on the screen.
+
+Coordinates cannot be omitted.
+
+If `STEP` is used before these coordinates, they are interpreted relative to the current cursor position. In this case the values can also be negative.
+
+`<Color>` is the color to be used = 0 to 15 (screens 2 to 5, 7 and 10), 0 to 3 (screen 6), 0 to 255 (screens 8, 11, and 12). If `<Color>` is not specified the current foreground color is used.
+
+`<Operator>` is the logical operation to be performed between the color of the old pixel and the new color. This parameter can be used only on screens 5 to 8 and 10 to 12, it requires a MSX2 or higher computer.
+
+The available operators are `AND`, `OR`, `PRESET`, `PSET` (default), `TAND`, `TOR`, `TPRESET`, `TPSET`, `TXOR`, `XOR`. Specifying a logical operation preceded by "T" causes nothing to be done when specified color is transparent (color 0).
+
+The effect of the operators is done on each corresponding bit as shown in the following table.
+
+|Current bit|Copied color bit|AND|OR|PRESET|PSET|XOR|
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+|0|0|0|0|1|0|0|
+|0|1|0|1|0|1|1|
+|1|0|0|1|1|0|1|
+|1|1|1|1|0|1|0|
+
+## Examples
+
+```basic
+10 COLOR 15,1,4: SCREEN 2
+20 LINE (40,40)-(215,151),7,B
+30 FOR I=0 TO 100
+40 A=INT(RND(1)*173)+41
+50 B=INT(RND(1)*109)+41
+60 C=INT(RND(1)*14)+1
+70 PSET(A,B), C
+80 NEXT I
+90 GOTO 90
+```
+
+```basic
+10 SCREEN5: BC=12: C=0: OC=2: DIM C(10)
+20 COLOR OC,BC,6:CLS
+30 PSET(110,96),C,AND: PSET(114,96),C,TAND
+40 PSET(118,96),C,OR: PSET(122,96),C,TOR
+50 PSET(126,96),C,PRESET: PSET(130,96),C,TPRESET
+60 PSET(134,96),C,PSET: PSET(138,96),C,TPSET
+70 PSET(142,96),C,XOR: PSET(146,96),C,TXOR
+80 IF NOT STRIG(0) GOTO 80
+90 FOR I=1 TO 10: C(I)=POINT(106+(I*4),96): NEXT
+100 COLOR 15,4,7: SCREEN0
+110 PRINT RIGHT$("000"+BIN$(BC),4);" Old color =";BC
+120 PRINT RIGHT$("000"+BIN$(C),4);" Specified color =";C
+130 PRINT "===="
+140 FOR I=1 TO 10: READ A$
+150 PRINT RIGHT$("000"+BIN$(C(I)),4);" Plotted color is ";C(I);"with ";A$
+160 NEXT: END
+170 DATA "AND","TAND","OR","TOR","PRESET","TPRESET","PSET","TPSET","XOR","TXOR"
+```
+
+## Related to
+
+`CIRCLE`, `COLOR`, `DRAW`, `LINE`, `PAINT`, `POINT`, `PRESET`, `SCREEN`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/PSET"

package/resources/programming/basic_wiki/PUT_KANJI.md

@@ -0,0 +1,93 @@
+# PUT KANJI
+
+## Effect
+
+Displays kanji on graphic screen (only screen modes 5 to 8 and 10 to 12).
+
+## Syntax
+
+`PUT KANJI STEP(<X>,<Y>),<JIScode>,<Color>,<Operator>,<Mode>`
+
+## Parameters
+
+`<X>` is coordinate X of destination. (0-255/511).
+
+`<Y>` is coordinate Y of destination. (0-211).
+
+The coordinates (with the parentheses) can be omitted only if there are parameters behind.
+
+If `STEP` is used before these coordinates, they are interpreted relative to the current cursor position. In this case the values can also be negative.
+
+`<JIScode>` is the JIS code corresponding to a character from the Kanji-ROM. (&H2120～&H4F53 for Level 1, and &H5020～&H7424 for Level 2).
+
+`<Color>` is the color code = 0 to 15 (screens 5, 7 and 10), 0 to 3 (screen 6), 0 to 255 (screens 8, 11 and 12).
+
+`<Operator>` is the logical operation to be performed between the color of the old pixel and the new color.
+
+The available operators are `AND`, `OR`, `PRESET`, `PSET` (default), `TAND`, `TOR`, `TPRESET`, `TPSET`, `TXOR`, `XOR`. Specifying a logical operation preceded by "T" causes nothing to be done when specified color is transparent (color 0). 
+
+The effect of the operators is done on each corresponding bit as shown in the following table.
+
+|Current bit|Copied color bit|AND|OR|PRESET|PSET|XOR|
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+|0|0|0|0|1|0|0|
+|0|1|0|1|0|1|1|
+|1|0|0|1|1|0|1|
+|1|1|1|1|0|1|0|
+
+`<Mode>` is the character size. (0-2, 0 by default):
+- 0 is 16x16 dot
+- 1 is 16x8 dot (only odd lines are displayed)
+- 2 is 16x8 dot (only even lines are displayed)
+
+## Examples
+
+```basic
+10 SCREEN5
+20 PUT KANJI (99,99),&H4267
+30 GOTO 30
+```
+Result: Shows the JIS1 Kanji `大` at coordinate X=99, Y=99
+
+---
+```basic
+10 SCREEN5
+20 PUT KANJI (99,99),&H737E
+30 GOTO 30
+```
+Result: Shows the JIS2 Kanji `龠` on those systems with JIS2 character sets, or nothing on those without.
+
+---
+```basic
+5 ' ### JIS Code Table by KdL (2017.08.18)
+10 COLOR 15,4,4: SCREEN 5: DEFINT A-Z
+15 JIS=&H2120: OPEN "GRP:" FOR OUTPUT AS #1
+20 W=16: N=N+1: PRESET(4,W+172)
+25 PRINT#1,"[ BASE ADR ";HEX$(JIS);"H ]  [ PAGE ";
+30 PRINT#1,RIGHT$(CHR$(N\10+48)+CHR$(NMOD10+48),2);" ]"
+35 FOR Y=0 TO 5: FOR X=0 TO 15
+40 PUT KANJI(X*16,W+Y*16),JIS,15
+45 JIS=JIS+1: NEXT X: W=W+8: NEXT Y
+50 IF JIS=&H7480 THEN CLOSE #1: K$=INPUT$(1): END
+55 IF JIS=&H2780 THEN JIS=&H2F80: N=N+8
+60 JIS=JIS+&HA0: K$=INPUT$(1): CLS: GOTO 20
+```
+Result: Shows the full JIS Code Table.
+
+This [conversion table](http://www.asahi-net.or.jp/~ax2s-kmtn/ref/jisx0208.html) may help you to get the JIS code.
+
+## Links
+
+[MSX-Kanji revealed](http://www.msxcomputermagazine.nl/mccw/91/KANJI-stuff/en.html) for an in-depth article on this topic.
+
+## Related to
+
+`AND`, `CALL JIS`, `CALL SJIS`, `OR`, `XOR`
+
+## Compatibility
+
+MSX-BASIC 2.0 or higher - Requires a computer with Kanji-ROM
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/PUT_KANJI"

package/resources/programming/basic_wiki/PUT_SPRITE.md

@@ -0,0 +1,143 @@
+# PUT SPRITE
+
+## Effect
+
+Displays a sprite.
+
+Known bugs:
+- The coordinate Y is shifted +1 relative to other graphical instructions.
+- Using the `OR operator` no longer works correctly on sprites above 26.
+
+## Syntax
+
+`PUT SPRITE <SpriteNumber>,STEP(<X>,<Y>),<Color>,<PatternNumber>`
+
+_Note: Do not put a comma if no parameters are behind._
+
+## Parameters
+
+`<SpriteNumber>` is a number between 0 and 31 that specifies the display priority number of sprite. When the number is bigger, the sprite is displayed under the others. 0 is the highest priority, 31 the lowest priority.
+
+`<X>` is abscissa coordinate. The value is between -32 and 255. In screens 6 and 7 the sprites are displayed like if the resolution was 256x212.
+
+`<Y>` is ordinate coordinate. The value is between -32 and 191 in screens 1 to 3, between -32 and 211 in screens 4 to 8 and 10 to 12.
+
+The special coordinates 208 and 216 on respectively mode 1 (screens 1 to 3) and mode 2 (screens 4 to 8 and 10 to 12) disable all subsequent sprites on the SAT (Sprite Attribute Table). MSX-BASIC also has the special coordinates 209 and 217, meant to take a single sprite off the screen.
+
+If `STEP` is specified before these coordinates, they are interpreted relative to the current cursor position. In this case the values can also be negative.
+
+If `<X>` and `<Y>` are not specified the current coordinates remain unchanged. Note that the maximum of sprites on the same horizontal line is limited to 4 on screens 1 to 3, to 8 on screens 4 to 8 and 10 to 12.
+
+`<Color>` is a number:
+- between 0 and 15 in screen 1 to 3 (sprites type 1).
+- between 0 and 127 in screens 4 to 8 and 10 to 12 (sprites type 2). It is the result of values 0 or 1 in the 8-bit VDP Sprite Color Register, used only for this type of sprites. As bit 4 is unused, some values between 16 and 127 are useless.
+
+_Note: In screen 8, the colors for the sprites are different from the colors of other screen modes._
+
+Table below is the detail for the color value format of sprites type 2:
+
+|Bits|Effect|
+|:-:|---|
+|7|Remember to set this bit to 0 otherwise an error "Illegal function call" occurs.|
+|6|1 to enable OR operation with bits pattern of linked sprites. The linked sprites are sprites displayed below with the bit 6 at 0. Four sprites can be linked.<br>Each bit at 1 in sprite patterns corresponds to the specified color of sprite. The `OR operation` is performed with the sprite colors on each bit superposed when displayed. The colors are taken into account for operation only when the bit is at 1. Thus the color of each pixel of the sprite at the top (with bit 6 to 1) will take the color resulting from each operation. (See `OR operation` for more info).|
+|5|1 to ignore the sprite collision with another sprite. (`ON SPRITE GOSUB` will have no effect)|
+|4|Unused.|
+|3-0|Color is used for the sprite (0~15 in decimal). The used colors are different in screen 8.|
+
+To get the decimal value, you can input one of the following instructions:
+
+|Bit|Instruction|
+|:-:|---|
+|5 set|`PRINT C+&B0100000`|
+|6 set|`PRINT C+&B1000000`|
+|5 and 6 set|`PRINT C+&B1100000`|
+
+`C` is the color number (0~15) that you want to use.
+
+Here is the detail with the decimal values and the different effects:
+
+|Color|Effects|
+|:-:|---|
+|0-15|The corresponding color is used for the sprite.|
+|32-47|<li>The color corresponding to (number - 32) is used for the sprite.<br><li>Collision with another sprite is ignored (`ON SPRITE GOSUB` will have no effect).|
+|64-79|<li>The color corresponding to (number - 64) is used for the sprite.<br><li>The logical `operator OR` is applied between colors of previous sprite pattern and new sprite pattern.|
+|96-111|<li>The color corresponding to (number - 96) is used for the sprite.<br><li> Collision with another sprite is ignored (`ON SPRITE GOSUB` will have no effect).<br><li>The logical `operator OR` is applied between colors of previous sprite pattern and new sprite pattern.|
+
+If `<Color>` is not set the last foreground color will be used. The default value is 15. However, in screens 4 to 8 and 10 to 12, the color(s) previously specified with `COLOR SPRITE()` or `COLOR SPRITE$()` will be used.
+
+`<PatternNumber>` is the pattern number in the sprites table. This number is between 0 and 255 for a 8x8 sprite, between 0 and 63 for a 16x16 sprite.
+
+If `<PatternNumber>` is not specified it is equal to `<SpriteNumber>`.
+
+## Examples
+
+```basic
+10 SCREEN5
+15 ON SPRITE GOSUB 80: SPRITE ON 'Enable colision for all sprites
+20 SPRITE$(0)=STRING$(8,255)
+30 PUTSPRITE 0,(50,50),10,0
+40 PUTSPRITE 1,(54,54),38,0 ' 38 is color 6 + &B0100000 to disable collision for sprite 1
+50 IF NOT STRIG(0) GOTO 50 'Press Space to enable OR operator
+60 COLOR SPRITE(1)=79 ' 79 is color 15 + &B1000000 to enable OR operation
+70 GOTO 70
+80 SCREEN 0: PRINT"Sprite collision OK": BEEP: END
+```
+
+```basic
+5 ' Program to show all colors in screen 8
+10 SCREEN 8,0:COLOR 255,0: CLS
+20 SPRITE$(0)=STRING$(8,CHR$(255)) ' Defines pattern
+30 FOR C=0 TO 15
+40 PUTSPRITE C,(16,C*8),C,0 ' The sprites at left
+50 NEXT:C=0
+60 FOR X=32 TO 152 STEP 8
+70 FOR Y=1 TO 128 STEP 8
+80 LINE(X,Y)-STEP(7,7),C,BF: C=C+1 ' The squares at right
+90 NEXT: NEXT
+100 IF NOT STRIG(0) GOTO100
+```
+
+```basic
+10 ' Program like the drawing toy Etch A Sketch
+20 COLOR 11,11,6: SCREEN 5,1
+30 FOR I=1 TO 8
+40 READ L: A$=A$+CHR$(L): READ L: B$=B$+CHR$(L)
+50 NEXT
+60 SPRITE$(0)=A$: SPRITE$(1)=B$
+70 COLOR SPRITE(0)=1 ' Black
+80 COLOR SPRITE(1)=78 ' 14 (Gray)+&B100000 for set bit 6
+90 PUTSPRITE 0,(X,Y): PUTSPRITE 1,STEP(0,0): PSET STEP(0,1)
+100 IF STRIG(0) THEN COLOR 1: VDP(1)=VDP(1) AND 254 ' Sprite size normal
+110 IF NOT PEEK(&HFBED) AND 32 THEN Y=Y+(Y>-1)
+120 IF NOT PEEK(&HFBED) AND 128 THEN X=X-(X<255)
+130 IF NOT PEEK(&HFBED) AND 64 THEN Y=Y-(Y<210)
+140 IF NOT PEEK(&HFBED) AND 16 THEN X=X+(X>0)
+150 IF NOT PEEK(&HFBED) AND 2 THEN CLS: COLOR 11: VDP(1)=VDP(1)OR 1 ' Sprite size doubled
+160 GOTO 90
+170 ' Sprite patterns
+180 DATA &B01111100,&B00000000 ' in decimal: 124,0
+190 DATA &B11111100,&B01111000 ' in decimal: 252,120
+200 DATA &B10111000,&B01110000 ' in decimal: 184,112
+210 DATA &B10011100,&B01111000 ' in decimal: 156,120
+220 DATA &B10101110,&B01011100 ' in decimal: 174,92
+230 DATA &B11010111,&B00001110 ' in decimal: 215,14
+240 DATA &B00001010,&B00000100 ' in decimal: 10,4
+250 DATA &B00000100,&B00000000 ' in decimal: 4,0
+260 ' Notes:
+270 ' Only two sprites are used to make three colors! (1 or 14 = 15)
+280 ' PEEK(&HFBED) is to read the keyboard matrix (See system variables)
+290 ' Press Space key to switch to tracing mode, and CLS key to erase the screen
+300 ' The sprites are badly displayed on some emulators
+```
+
+## Related to
+
+`COLOR SPRITE()`, `COLOR SPRITE$()`, `ON SPRITE GOSUB`, `SPRITE`, `SPRITE$()`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/PUT_SPRITE"

package/resources/programming/basic_wiki/READ.md

@@ -0,0 +1,45 @@
+# READ
+
+## Effect
+
+Returns next value(s) that has been stored in the program source by using `DATA` instructions.
+
+## Syntax
+
+`READ <Variable>,<Variable>...`
+
+_Note: Parameters can not end with a comma alone._
+
+## Parameter
+
+`<Variable>` is a variable that matches with the datatype stored in `DATA` instruction.
+
+After `READ` instruction is executed the data pointer will automatically move to next item. Data pointer can be moved manually by using `RESTORE` instruction.
+
+## Example
+
+```basic
+10 READ A$
+20 PRINT A$
+30 READ A,B
+40 PRINT A
+50 PRINT B
+60 DATA "TEST",10,20
+ 
+RUN
+TEST
+ 10
+ 20
+```
+
+## Related to
+
+`DATA`, `DIM`, `RESTORE`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/READ"

package/resources/programming/basic_wiki/REM.md

@@ -0,0 +1,42 @@
+# REM
+
+## Effect
+
+Adds remarks to the source code. Everything after `REM` until end of line will be stored as text and will not affect the program execution.
+
+_Notes:_
+- There is also 1-letter short version of this instruction: `'`, but it takes more space in RAM (3 bytes) instead of `REM` (only one byte).
+- `REM` can also be replaced by `ELSE` (in this case, the compressed BASIC instructions after `ELSE` will take less place in RAM than with `REM`).
+
+## Syntaxes
+
+`REM <TextString>`
+
+`' <TextString>`
+
+## Parameter
+
+`<TextString>` can be any text. It is optional, so you can have lines with only `REM` or `'`, just to give more clarity to your program.
+
+If short version is used ":" is generally not mandatory when used in same line with other instructions. However, you need to use it if you get an error message when executing your program (it can happen when your remark follows a `CALL` instruction).
+
+Unlike with `?` and `PRINT` the short version is not expanded to long version when listing the MSX-BASIC program.
+
+## Example
+
+```basic
+10 CLS:REM I will store this program with NAME "EXAMPLE.BAS"
+20 PRINT "HELLO WORLD!" ' End of program.
+```
+
+## Related to
+
+`ELSE`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/REM"