View source for Undocumented 8.1 commands

At the time of this revision for Color 64 v8.1a, there are notably several ML related commands and variables that are not documented as well as some basic shortcuts and appear to have been introduced from the 8.1 upgrade that never received any manual documentation. I find that comparing 8.0 code with 8.1 helps you along in figuring out what these undocumented items perform. Below are some of my notes and observations of what the code was in 8.0 and the observed shortcuts implemented in 8.1 Please note it is a work-in-progress and I don’t have all the answers (yet), so some of this is just “observation” without any conclusion! 

{| class="wikitable
|-
! Topic 
! Found in 
|-
| <strong>Branch Shortcuts </strong>
| <strong>√bbs.init</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:branchshortcuts_ex1_80.png|center|300px]]
| [[File:branchshortcuts_ex2_81.png|center|300px]]
|-
| 2
| [[File:branchshortcuts_ex2_80.png|center|300px]]
| [[File:branchshortcuts_ex2_81.png|center|300px]]
|-
| 3
| [[File:branchshortcuts_ex3_80.png|center|300px]]
| [[File:branchshortcuts_ex3_81.png|center|300px]]
|-
| 4
| [[File:branchshortcuts_ex4_80.png|center|300px]]
| [[File:branchshortcuts_ex4_81.png|center|300px]]
|}

<u>Conclusion</u>: “[“ and “@” are used for loops with “[“ being the starting position and “@” being the condition that will cause the function to return to the starting point of the loop. Also note in line 8220 how the “RETURN” statement moved from line 8230 up into the 8220 loop in version 8.1 (example 2), indicating that it will execute the return if a$ <> “” and a$ <> home key. 
: <strong>[</strong> starts loop 
: <strong>@</strong> loop condition – goes back to bracket when used after “@”, consider an “ELSE” statement in this loop (example 2) 
: <strong>]</strong> breaks loop condition (Example 3) 
: A break “<strong>]</strong>” can occur as part of an IF statement to exit prior to “<strong>@</strong>” for loop (example 4) 
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>Use of "THEN" in IF </strong>
| <strong>all</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:ifthen_ex1_80.png|center|300px]]
| [[File:ifthen_ex1_81.png|center|300px]]
|}
<u>Conclusion</u>: “then” statements are not required for “if/then” – <strong>if <condition> <action></strong> is legal 
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>.36 </strong>
| <strong>√bbs.init</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:dot36_ex1_80.png|center|300px]]
| [[File:dot36_ex1_81.png|center|300px]]
|}
<u>Conclusion</u>: Undetermined, although notice line in 8.0 version that line 13645 has been dropped for the 8.1 variant. This command only occurs on this line in the overlays as part of the command prompt. When I dropped everything in line 13640 and just had “.36:return”, there was no box printed (of course), but the command entry functioned normally. This was also true if I just omitted everything except “return” – so I’m not sure what “.36” brings to the table.  
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>.31 and !55</strong>
| <strong>√bbs.msgs</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:31and55_ex1_80.png|center|300px]]
| [[File:31and55_ex1_81.png|center|300px]]
|}
<u>Conclusion</u>: Documentation originally stated “.31” was not used - but it clearly is - and may be a more-refined or customized version of inputting data from disk (.01). “!55” was undocumented and appears to be a variable replacement for “@0=<reverse n>”, where @0 is for disk-and-key input and stores a result. There are several cases where “.31” and “!55” are used in conjunction with each other.  
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>.38 / .39 / .40 / .41 and “;” variables</strong>
| <strong>√bbs.msgs</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| (current message vs high message): 
[[File:38_39_40_41_ex1_80.png|center|300px]]
| (current message vs high message):
[[File:38_39_40_41_ex1_81.png|center|300px]]
|-
| 2
| (reading message):
[[File:38_39_40_41_ex2_80.png|center|300px]]
| (reading message):
[[File:38_39_40_41_ex2_81.png|center|300px]]
|-
| 3
| (storing message):
[[File:38_39_40_41_ex3_80.png|center|300px]]
| (storing message):
[[File:38_39_40_41_ex3_81.png|center|300px]]
|}
<u>Observation (no conclusion)</u>: This is one of the more intriguing finds and it’s a hot mess – lines 3140, 3555 and 1525 are obviously the topics of interest. I can’t tell you what’s going on here, but here are some observations from my research: 
* Example 1 is very close to Example 2, so read on…. 
* Example 2 is reading a message after the user has selected a message number. 
:: From 8.0, <strong>m</strong>=last message read, <strong>mn(.)</strong> is our message numbers array, <strong>mr%(m)</strong> tracks messages that have been read, and mn (not arrayed) is undocumented, but suspect it is “current message number”. 
* Breaking down line 3140: 
:: You can see the loop function “<strong>[</strong>“, “<strong>@</strong>” and “<strong>]</strong>” replacing our for-next in line 3140, and in same line variable “<strong>m</strong>” is being decremented, replacing the “<strong>step -1</strong>”. “<strong>@m</strong>” appears to be our “<strong>next m</strong>” of the for next loop replacement. 
 
:: Our preparation for the loop is present: 
::: 8.0 statement for <strong>m=mn(.)</strong> can be tied to 8.1 statement <strong>m=mn(.)</strong>. 
::: I suggest the following matches from line 3140 comparison: 
:::* 8.0 statement <strong>ifmn(m)>ithennext</strong> = 8.1 statements <strong>if;0f<=I]£ and @m</strong>
:::* 8.0 statement <strong>mr%(m)=.</strong> = 8.1 statement <strong>;1k=.</strong>
:::* both of these statements are occurring inside the loop; and that covers all of the original 8.0 line of 3140. 
:: So what are the 8.1 statements <strong>.38,0mn</strong>,<strong>1mr%</strong> and <strong>.39,fm,km</strong> doing before we enter the loop? There is no equivalent statement I can derive from 8.0. Printing the value of these parameters did not provide any insight either, although we know what <strong>mn</strong> and <strong>mr%</strong> are, and <strong>fm</strong> – if being used correctly – is word-wrap. Variable <strong>km</strong> is undefined and it is not set anywhere in the basic code of √bbs.msgs. 
* Example 3 is storing a new message and updating the message links 
:: It appears the 8.1 version of line 1525 uses “old to new” assignments to replace the incrementation we see in the 8.0 version. The 8.1 statement <strong>.40,fgkl</strong> is a mystery, but appears to be a new ML routine to use the new assignments of the variables <strong>f</strong>, <strong>g</strong>, <strong>k</strong>, and <strong>l</strong> that occurred on the same line. 
* Examples 1 & 2 appear to use different subject parameter for parameter #2 in the <strong>.38</strong> function. Example 1 shows <strong>.38</strong> receiving last message read as parameter 1 and category as parameter 2. Example 2 shows message number as parameter 1 and <strong>.38</strong> is taking two parameters: “<strong>0mr%</strong>” and “<strong>1ca%</strong>” separated by a comma 
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>£if </strong>
| <strong>√bbs.msgs</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:britishpoundif_ex1_80.png|center|300px]]
| [[File:britishpoundif_ex1_81.png|center|300px]]
|}
<u>Observation</u>: Observe the 8.1 authors reversed the checks in variable comparisons as the conditions, with end-result being the same. 

<u>Conclusion</u>: Serves as an “and not” function  

“(lv is not less than cm%(2,2) and lv not less than cm%(29,2) and fr does not equal 1, then print (P)rivate)” 
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>@ </strong>
| <strong>√bbs.msgs</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:at_ex1_80.png|center|300px]]
| [[File:at_ex1_81.png|center|300px]]
|}
<u>Conclusion</u>: Can serve as an “if” keyword 
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>[var$] </strong>
| <strong>√bbs.msgs</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:var_ex1_80.png|center|300px]]
| [[File:var_ex1_81.png|center|300px]]
|}
<u>Conclusion</u>: Can serve as an empty variable check (null)
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>] as goto </strong>
| <strong>√bbs.msgs</strong>
{| class="wikitable
|-
! Example
! 8.0
! 8.1
|-
| 1
| [[File:asgoto_ex1_80.png|center|300px]]
| [[File:asgoto_ex1_81.png|center|300px]]
|}
<u>Conclusion</u>: Can serve as a “goto” function
|}

{| class="wikitable
|-
! Topic
! Found in
|-
| <strong>.32</strong>
| <strong>√bbs.msgs</strong>

<u>Researching / Unknown</u>
|}