~crc_/retro-ilo

63a155ff4f13367bca29367c542b965bb3e39669 — crc 5 months ago c4b582a
work on removing Retro/ilo mentions in the manual

FossilOrigin-Name: b2fc89e76dd9ad89a958a4ab22d790b33338597fd1c313af82227df1cc99216b
M blocks/480 => blocks/480 +0 -0
M blocks/481 => blocks/481 +0 -0
M blocks/482 => blocks/482 +0 -0
M blocks/483 => blocks/483 +0 -0
M blocks/484 => blocks/484 +0 -0
M blocks/495 => blocks/495 +0 -0
M blocks/496 => blocks/496 +0 -0
M blocks/497 => blocks/497 +0 -0
M blocks/498 => blocks/498 +0 -0
M blocks/506 => blocks/506 +0 -0
M blocks/508 => blocks/508 +0 -0
M blocks/509 => blocks/509 +0 -0
M blocks/511 => blocks/511 +0 -0
M blocks/512 => blocks/512 +0 -0
M blocks/518 => blocks/518 +0 -0
M blocks/521 => blocks/521 +0 -0
M blocks/523 => blocks/523 +0 -0
M blocks/gemtext/480.gmi => blocks/gemtext/480.gmi +5 -5
@@ 1,18 1,18 @@
```
Konilo : User Guide                                             
                                                                
Welcome to Retro, a modern, pragmatic Forth.                    
Welcome to Konilo, a modern, pragmatic Forth.                   
                                                                
Retro is Forth. It is untyped, using a stack to pass data       
Konilo is a Forth. It is untyped, using a stack to pass data    
between functions called words, and a dictionary which          
tracks the word names and data structures.                      
                                                                
But it's not a traditional Forth. Retro draws influences        
But it's not a traditional Forth. Konilo draws influences       
from many sources and takes a unique approach to the language.  
                                                                
Retro has a large vocabulary of words. Keeping a copy of this   
Konilo has a rich vocabulary of words. Keeping a copy of this   
manual and the dictionary on hand is highly recommended as      
you learn to use Retro.                                         
you learn to use Konilo.                                        
                                                                
                                                                
```

M blocks/gemtext/481.gmi => blocks/gemtext/481.gmi +5 -5
@@ 1,13 1,13 @@
```
Welcome                                                         
                                                                
The system described here is RetroForth/ilo, running on the ilo 
virtual computer. There are related implementations available   
for the napia and nga systems as well. Those systems have       
The system described here is Konilo (pronounced koh-nee-lo),    
running on the ilo virtual computer. There are related          
implementations for napia and arks as well. Those systems have  
separate documentation.                                         
                                                                
This guide will refer to the system as Retro or RetroForth      
throughout the text.                                            
                                                                
                                                                
                                                                
                                                                
                                                                

M blocks/gemtext/482.gmi => blocks/gemtext/482.gmi +1 -1
@@ 1,7 1,7 @@
```
Overview of Konilo                                              
                                                                
A RetroForth system consists of three parts: a virtual machine  
The Konilo system consists of three parts: a virtual machine    
(named "ilo"), an image file (named "ilo.rom"), and a set of    
data blocks (named "ilo.blocks").                               
                                                                

M blocks/gemtext/483.gmi => blocks/gemtext/483.gmi +1 -1
@@ 3,7 3,7 @@ Obtaining Konilo
                                                                
Snapshots                                                       
                                                                
You can obtain the latest version of RetroForth from            
You can obtain the latest version of Konilo frem                
ilo.retroforth.org via the Gemini or HTTP(s) protocols.         
                                                                
* gemini://ilo.retroforth.org                                   

M blocks/gemtext/484.gmi => blocks/gemtext/484.gmi +7 -7
@@ 2,17 2,17 @@
Source Repositories                                             
                                                                
The snapshots do not include the full source tree. To obtain    
this you will need to use either the Fossil or Git version      
control systems.                                                
this you will need to use the Fossil version control system.    
                                                                
                                                                
Via Fossil:                                                     
                                                                
  fossil clone http://fossils.retroforth.org:8000/ilo \         
          retro-ilo.fossil                                      
  mkdir retro-ilo; cd retro-ilo                                 
  fossil open ../retro-ilo.fossil                               
         konilo.fossil                                          
  mkdir konilo; cd konilo                                       
  fossil open ../konilo.fossil                                  
                                                                
                                                                
                                                                
Via Git:                                                        
                                                                
  git clone https://git.sr.ht/~crc_/retro-ilo                   
```

M blocks/gemtext/495.gmi => blocks/gemtext/495.gmi +3 -3
@@ 1,12 1,12 @@
```
The Listener                                                    
                                                                
The listener is Retro's interaction loop. It reads and evaluates
your input in a continual loop.                                 
The listener is Konilo's interaction loop. It reads and         
evaluates your input in a continual loop.                       
                                                                
By itself, the listener is not feature rich. It does not provide
any history or editing (apart from backspace). If you are using 
a Unix host, I recommend running Retro under rlwrap. An example 
a Unix host, I recommend running Konilo under rlwrap. An example
(ri.sh) is in the source repository; this shows how to use the  
rlwrap tool to add line editing, history, and tab completion.   
                                                                

M blocks/gemtext/496.gmi => blocks/gemtext/496.gmi +2 -2
@@ 1,7 1,7 @@
```
Basic Interactions                                              
                                                                
At the listener you can enter code, and Retro will run what you 
At the listener you can enter code, and Konilo will run what you
type. The code consists of tokens, which are sequences of       
characters, seperated by whitespace.                            
                                                                


@@ 12,7 12,7 @@ using rlwrap, on a Unix host, you can run `stty cbreak` before
starting the ilo binary to disable the input buffering.         
                                                                
As an example interaction, enter the following and press        
ENTER (or SPACE if using character breaking) to exit Retro:     
ENTER (or SPACE if using character breaking) to exit Konilo:    
                                                                
  bye                                                           
```

M blocks/gemtext/497.gmi => blocks/gemtext/497.gmi +3 -3
@@ 1,14 1,14 @@
```
An Overview of Blocks & The Block Editor                        
                                                                
Retro uses blocks to store code and data. These are fixed size  
Konilo uses blocks to store code and data. These are fixed size 
buffers of 1,024 values. For the purposes of code and text, they
are displayed as 16 rows, with 64 columns per row.              
                                                                
A minimal block editor is included. (If you are reading this in 
Retro, then you are probably using the block editor to do so).  
Konilo, then you are probably using the block editor to do so). 
This is not a complex program, and learning to use it will help 
you make Retro into a productive system.                        
you make Konilo into a productive system.                       
                                                                
                                                                
                                                                

M blocks/gemtext/498.gmi => blocks/gemtext/498.gmi +1 -1
@@ 1,7 1,7 @@
```
What Are Blocks                                                 
                                                                
In RetroForth, blocks are 1,024 values (typically characters)   
In Konilo, blocks are  1,024 values (typically characters)      
that are used for long-term storage. The ilo computer provides  
a block storage device, and Retro has words to read blocks into 
memory and write them back to the storage device.               

M blocks/gemtext/506.gmi => blocks/gemtext/506.gmi +8 -8
@@ 1,16 1,16 @@
```
Finding Blocks                                                  
                                                                
Retro does not have many facilities for locating blocks. The    
block editor includes a single word, `titles`, for displaying a 
list of the blocks and their block numbers. You can run this    
and then read through the output to find the ones you need.     
                                                                
                                                                
                                                                
                                                                
Konilo provides a few tools to help you locate blocks.          
                                                                
`titles` will display a list of all blocks in the system. If you
are using the default system, this will be done in a keyboard   
driven interface. If using a minimal system, it will display the
titles and block numbers.                                       
                                                                
You can use `locate` followed by the first part of a block title
to see a list of all blocks that match. For instance, if you do 
`locate (std)`, all blocks starting with "(std)" will be shown. 
                                                                
                                                                
                                                                

M blocks/gemtext/508.gmi => blocks/gemtext/508.gmi +2 -2
@@ 2,10 2,10 @@
Sigils & The Interpreter                                        
                                                                
If you are familiar with traditional Forth, you likely notice   
that no number handling is done. In Retro, these are handled by 
that no number handling is done. In Konilo these are handled by 
a sigil.                                                        
                                                                
The sigil system is a central part of Retro's design. If you    
The sigil system is a central part of Konilo's design. If you   
are familiar with ColorForth, it might make sense to consider   
sigils to be colors, but done via characters instead of needing 
special editor support.                                         

M blocks/gemtext/509.gmi => blocks/gemtext/509.gmi +2 -2
@@ 1,7 1,7 @@
```
Sigils & The Interpreter (cont.)                                
                                                                
Retro maintains a table of sigil handlers. Any character can be 
Konilo maintains a table of sigil handlers. Any character can be
a sigil. If the interpreter matches the first character in a    
token to a sigil, the sigil is removed and the token is passed  
on the stack to the sigil handler for processing.               


@@ 11,7 11,7 @@ starts a new colon definition. A # sigil processes the token as
a number. An & sigil is used to get a pointer. The ( sigil      
begins a comment.                                               
                                                                
The next block has a table of the sigils provided by Retro.     
The next block has a table of the sigils provided by Konilo.    
                                                                
                                                                
                                                                

M blocks/gemtext/511.gmi => blocks/gemtext/511.gmi +2 -2
@@ 1,8 1,8 @@
```
Numbers                                                         
                                                                
In RetroForth, numbers are provided by prefixing a token with   
the # sigil.                                                    
In Konilo, numbers are provided by prefixing a token with the # 
sigil.                                                          
                                                                
For negative values, add a - after the # sigil.                 
                                                                

M blocks/gemtext/512.gmi => blocks/gemtext/512.gmi +1 -1
@@ 2,7 2,7 @@
Arrays : Overview                                               
                                                                
Arrays are sequences of values. They are one of the central data
types in RetroForth.                                            
types in Konilo.                                                
                                                                
In memory, an array consists of a count, followed by the values.
For instance, an array with 67, 102, and 33 can be constructed  

M blocks/gemtext/518.gmi => blocks/gemtext/518.gmi +1 -1
@@ 1,7 1,7 @@
```
Arrays : Subsets                                                
                                                                
You can extract subsets of an array. Retro provides `a:left`    
You can extract subsets of an array. Konilo provides `a:left`,  
for returning values from the beginning of the array, `a:right` 
to get values from the end of the array, and `a:middle` for     
values in the middle of the array.                              

M blocks/gemtext/521.gmi => blocks/gemtext/521.gmi +1 -1
@@ 1,7 1,7 @@
```
Variables: Additional Operations                                
                                                                
RetroForth also provides words for incrementing or decrementing 
Konilo also provides words for incrementing or decrementing     
a variable. These are `v:inc` and `v:dec`.                      
                                                                
Examples:                                                       

M blocks/gemtext/523.gmi => blocks/gemtext/523.gmi +2 -2
@@ 1,8 1,8 @@
```
Quotations                                                      
                                                                
A concept used heavily in RetroForth is quotations. These are   
anonymous blocks of code. In Retro, these are passed to words   
A concept used heavily in Konilo is quotations. These are       
anonymous blocks of code. In Konilo these are passed to words   
which handle various actions like conditional execution and     
loops.                                                          
                                                                

M blocks/text/480.txt => blocks/text/480.txt +5 -5
@@ 1,16 1,16 @@
Konilo : User Guide                                             
                                                                
Welcome to Retro, a modern, pragmatic Forth.                    
Welcome to Konilo, a modern, pragmatic Forth.                   
                                                                
Retro is Forth. It is untyped, using a stack to pass data       
Konilo is a Forth. It is untyped, using a stack to pass data    
between functions called words, and a dictionary which          
tracks the word names and data structures.                      
                                                                
But it's not a traditional Forth. Retro draws influences        
But it's not a traditional Forth. Konilo draws influences       
from many sources and takes a unique approach to the language.  
                                                                
Retro has a large vocabulary of words. Keeping a copy of this   
Konilo has a rich vocabulary of words. Keeping a copy of this   
manual and the dictionary on hand is highly recommended as      
you learn to use Retro.                                         
you learn to use Konilo.                                        
                                                                
                                                                
\ No newline at end of file

M blocks/text/481.txt => blocks/text/481.txt +5 -5
@@ 1,12 1,12 @@
Welcome                                                         
                                                                
The system described here is RetroForth/ilo, running on the ilo 
virtual computer. There are related implementations available   
for the napia and nga systems as well. Those systems have       
The system described here is Konilo (pronounced koh-nee-lo),    
running on the ilo virtual computer. There are related          
implementations for napia and arks as well. Those systems have  
separate documentation.                                         
                                                                
This guide will refer to the system as Retro or RetroForth      
throughout the text.                                            
                                                                
                                                                
                                                                
                                                                
                                                                

M blocks/text/482.txt => blocks/text/482.txt +1 -1
@@ 1,6 1,6 @@
Overview of Konilo                                              
                                                                
A RetroForth system consists of three parts: a virtual machine  
The Konilo system consists of three parts: a virtual machine    
(named "ilo"), an image file (named "ilo.rom"), and a set of    
data blocks (named "ilo.blocks").                               
                                                                

M blocks/text/483.txt => blocks/text/483.txt +1 -1
@@ 2,7 2,7 @@ Obtaining Konilo
                                                                
Snapshots                                                       
                                                                
You can obtain the latest version of RetroForth from            
You can obtain the latest version of Konilo frem                
ilo.retroforth.org via the Gemini or HTTP(s) protocols.         
                                                                
* gemini://ilo.retroforth.org                                   

M blocks/text/484.txt => blocks/text/484.txt +7 -7
@@ 1,16 1,16 @@
Source Repositories                                             
                                                                
The snapshots do not include the full source tree. To obtain    
this you will need to use either the Fossil or Git version      
control systems.                                                
this you will need to use the Fossil version control system.    
                                                                
                                                                
Via Fossil:                                                     
                                                                
  fossil clone http://fossils.retroforth.org:8000/ilo \         
          retro-ilo.fossil                                      
  mkdir retro-ilo; cd retro-ilo                                 
  fossil open ../retro-ilo.fossil                               
         konilo.fossil                                          
  mkdir konilo; cd konilo                                       
  fossil open ../konilo.fossil                                  
                                                                
                                                                
Via Git:                                                        
                                                                
  git clone https://git.sr.ht/~crc_/retro-ilo                   
\ No newline at end of file
                                                                
\ No newline at end of file

M blocks/text/495.txt => blocks/text/495.txt +3 -3
@@ 1,11 1,11 @@
The Listener                                                    
                                                                
The listener is Retro's interaction loop. It reads and evaluates
your input in a continual loop.                                 
The listener is Konilo's interaction loop. It reads and         
evaluates your input in a continual loop.                       
                                                                
By itself, the listener is not feature rich. It does not provide
any history or editing (apart from backspace). If you are using 
a Unix host, I recommend running Retro under rlwrap. An example 
a Unix host, I recommend running Konilo under rlwrap. An example
(ri.sh) is in the source repository; this shows how to use the  
rlwrap tool to add line editing, history, and tab completion.   
                                                                

M blocks/text/496.txt => blocks/text/496.txt +2 -2
@@ 1,6 1,6 @@
Basic Interactions                                              
                                                                
At the listener you can enter code, and Retro will run what you 
At the listener you can enter code, and Konilo will run what you
type. The code consists of tokens, which are sequences of       
characters, seperated by whitespace.                            
                                                                


@@ 11,6 11,6 @@ using rlwrap, on a Unix host, you can run `stty cbreak` before
starting the ilo binary to disable the input buffering.         
                                                                
As an example interaction, enter the following and press        
ENTER (or SPACE if using character breaking) to exit Retro:     
ENTER (or SPACE if using character breaking) to exit Konilo:    
                                                                
  bye                                                           
\ No newline at end of file

M blocks/text/497.txt => blocks/text/497.txt +3 -3
@@ 1,13 1,13 @@
An Overview of Blocks & The Block Editor                        
                                                                
Retro uses blocks to store code and data. These are fixed size  
Konilo uses blocks to store code and data. These are fixed size 
buffers of 1,024 values. For the purposes of code and text, they
are displayed as 16 rows, with 64 columns per row.              
                                                                
A minimal block editor is included. (If you are reading this in 
Retro, then you are probably using the block editor to do so).  
Konilo, then you are probably using the block editor to do so). 
This is not a complex program, and learning to use it will help 
you make Retro into a productive system.                        
you make Konilo into a productive system.                       
                                                                
                                                                
                                                                

M blocks/text/498.txt => blocks/text/498.txt +1 -1
@@ 1,6 1,6 @@
What Are Blocks                                                 
                                                                
In RetroForth, blocks are 1,024 values (typically characters)   
In Konilo, blocks are  1,024 values (typically characters)      
that are used for long-term storage. The ilo computer provides  
a block storage device, and Retro has words to read blocks into 
memory and write them back to the storage device.               

M blocks/text/506.txt => blocks/text/506.txt +8 -8
@@ 1,15 1,15 @@
Finding Blocks                                                  
                                                                
Retro does not have many facilities for locating blocks. The    
block editor includes a single word, `titles`, for displaying a 
list of the blocks and their block numbers. You can run this    
and then read through the output to find the ones you need.     
                                                                
                                                                
                                                                
                                                                
Konilo provides a few tools to help you locate blocks.          
                                                                
`titles` will display a list of all blocks in the system. If you
are using the default system, this will be done in a keyboard   
driven interface. If using a minimal system, it will display the
titles and block numbers.                                       
                                                                
You can use `locate` followed by the first part of a block title
to see a list of all blocks that match. For instance, if you do 
`locate (std)`, all blocks starting with "(std)" will be shown. 
                                                                
                                                                
                                                                

M blocks/text/508.txt => blocks/text/508.txt +2 -2
@@ 1,10 1,10 @@
Sigils & The Interpreter                                        
                                                                
If you are familiar with traditional Forth, you likely notice   
that no number handling is done. In Retro, these are handled by 
that no number handling is done. In Konilo these are handled by 
a sigil.                                                        
                                                                
The sigil system is a central part of Retro's design. If you    
The sigil system is a central part of Konilo's design. If you   
are familiar with ColorForth, it might make sense to consider   
sigils to be colors, but done via characters instead of needing 
special editor support.                                         

M blocks/text/509.txt => blocks/text/509.txt +2 -2
@@ 1,6 1,6 @@
Sigils & The Interpreter (cont.)                                
                                                                
Retro maintains a table of sigil handlers. Any character can be 
Konilo maintains a table of sigil handlers. Any character can be
a sigil. If the interpreter matches the first character in a    
token to a sigil, the sigil is removed and the token is passed  
on the stack to the sigil handler for processing.               


@@ 10,7 10,7 @@ starts a new colon definition. A # sigil processes the token as
a number. An & sigil is used to get a pointer. The ( sigil      
begins a comment.                                               
                                                                
The next block has a table of the sigils provided by Retro.     
The next block has a table of the sigils provided by Konilo.    
                                                                
                                                                
                                                                
\ No newline at end of file

M blocks/text/511.txt => blocks/text/511.txt +2 -2
@@ 1,7 1,7 @@
Numbers                                                         
                                                                
In RetroForth, numbers are provided by prefixing a token with   
the # sigil.                                                    
In Konilo, numbers are provided by prefixing a token with the # 
sigil.                                                          
                                                                
For negative values, add a - after the # sigil.                 
                                                                

M blocks/text/512.txt => blocks/text/512.txt +1 -1
@@ 1,7 1,7 @@
Arrays : Overview                                               
                                                                
Arrays are sequences of values. They are one of the central data
types in RetroForth.                                            
types in Konilo.                                                
                                                                
In memory, an array consists of a count, followed by the values.
For instance, an array with 67, 102, and 33 can be constructed  

M blocks/text/518.txt => blocks/text/518.txt +1 -1
@@ 1,6 1,6 @@
Arrays : Subsets                                                
                                                                
You can extract subsets of an array. Retro provides `a:left`    
You can extract subsets of an array. Konilo provides `a:left`,  
for returning values from the beginning of the array, `a:right` 
to get values from the end of the array, and `a:middle` for     
values in the middle of the array.                              

M blocks/text/521.txt => blocks/text/521.txt +1 -1
@@ 1,6 1,6 @@
Variables: Additional Operations                                
                                                                
RetroForth also provides words for incrementing or decrementing 
Konilo also provides words for incrementing or decrementing     
a variable. These are `v:inc` and `v:dec`.                      
                                                                
Examples:                                                       

M blocks/text/523.txt => blocks/text/523.txt +2 -2
@@ 1,7 1,7 @@
Quotations                                                      
                                                                
A concept used heavily in RetroForth is quotations. These are   
anonymous blocks of code. In Retro, these are passed to words   
A concept used heavily in Konilo is quotations. These are       
anonymous blocks of code. In Konilo these are passed to words   
which handle various actions like conditional execution and     
loops.                                                          
                                                                

M ilo.blocks => ilo.blocks +0 -0