easycoder 241227.1__tar.gz → 250102.1__tar.gz

easycoder-250102.1/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.3
+Name: easycoder
+Version: 250102.1
+Summary: Rapid scripting in English
+Keywords: compiler,scripting,prototyping,programming,coding,python,low code,hypertalk,computer language,learn to code
+Author-email: Graham Trott <gtanyware@gmail.com>
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Requires-Dist: pytz
+Project-URL: Home, https://github.com/easycoder/easycoder-py
+
+# Introduction
+**_EasyCoder_** is a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line and a graphics module is under construction. This version of the language is written in Python and its runtime acts as a fairly thin wrapper around Python functions, giving good performance for general applications.
+
+The JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, is at
+
+Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)  
+Website: [https://easycoder.github.io](https://easycoder.github.io)
+
+## Quick Start
+Install **_EasyCoder_** in your Python environment:
+```
+pip install easycoder
+```
+Write a test script, 'hello.ecs', containing the following:
+```
+print `Hello, world!`
+```
+This is traditionally the first program to be written in virtually any language. To run it, use `easycoder hello.ecs`.
+
+The output will look like this:
+
+```
+EasyCoder version 250101.1
+Compiled <anon>: 1 lines (2 tokens) in 0 ms
+Run <anon>
+1-> Hello, world!
+```
+It's conventional to add a program title to a script:
+
+```
+!   Test script
+    script Test
+    print `Hello, world!`
+```
+The first line here is just a comment and has no effect on the running of the script.   The second line gives the script a name, which is useful in debugging as it says which script was running. When run, the output is now
+
+```
+EasyCoder version 250101.1
+Compiled Test: 3 lines (4 tokens) in 0 ms
+Run Test
+3-> Hello, world!
+```
+As you might guess from the above, the print command shows the line in the script it was called from. This is very useful in tracking down debugging print commands in large scripts.
+
+Here in the repository is a folder called `scripts` containing some sample scripts:
+
+`fizzbuzz.ecs` is a simple programming challenge often given at job interviews  
+`tests.ecs` is a test program containing many of the **_EasyCoder_** features  
+`benchmark.ecs` allows the performance of **_EasyCoder_** to be compared to other languages if a similar script is written for each one.
+
+## Graphical programmming
+**_EasyCoder_** includes a graphical programming environment that is in the early stages of development. A couple of demo scripts are included in the `scripts` directory. To run them, first install the Python `kivy` graphics library if it's not already present on your system. This is done with `pip install kivy`. Then run your **_EasyCoder_** script using `easycoder {scriptname}.ecg`.
+
+Graphical scripts look much like any other script but their file names must use the extension `.ecg` to signal to **_EasyCoder_** that it needs to load the graphics module. Non-graphical applications can use any extension but `.ecs` is recommended. This allows the **_EasyCoder_** application to be used wherever Python is installed, in either a command-line or a graphical environment, but graphics will of course not be available in the former.
+
+A couple of demo graphical scripts are included in the `scripts` directory:
+
+`graphics-demo.ecg` shows some of the elements that can be created, and demonstrates a variety of the graphical features of the language such as detecting when elements are clicked.
+
+`wave.ecg` is a "Mexican Wave" simulation.
+
+**_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs.
+
+## Programming reference
+
+**_EasyCoder_** comprises a set of modules to handle tokenisation, compilation and runtime control. Syntax and grammar are defined by [packages](doc/README.md), of which there are currently two; the [core](doc/core/README.md) package, which implements a comprehensive set of command-line programming features, and and the [graphics](doc/graphics/README.md) package, which adds graphical features in a windowing environment.
+
+## Extending the language
+
+**_EasyCoder_** can be extended to add new functionality with the use of 'plugins'. These contain compiler and runtime modules for the added language features. **_EasyCoder_** can use the added keywords, values and conditions freely; the effect is completely seamless. There is an outline example in the `plugins` directory called `example.py`, which comprises a module called `Points` with new language syntax to deal with two-valued items such as coordinates. In the `scripts` directory there is `points.ecs`, which exercises the new functionality.
+
+A plugin can act as a wrapper around any Python functionality that has a sensible API, thereby hiding its complexity. The only challenge is to devise an unambiguous syntax that doesn't clash with anything already existing in **_EasyCoder_**.
+

easycoder-250102.1/README.md

@@ -0,0 +1,72 @@
+# Introduction
+**_EasyCoder_** is a high-level English-like scripting language suited for prototyping and rapid testing of ideas. It operates on the command line and a graphics module is under construction. This version of the language is written in Python and its runtime acts as a fairly thin wrapper around Python functions, giving good performance for general applications.
+
+The JavaScript version of **_EasyCoder_**, which provides a full set of graphical features to run in a browser, is at
+
+Repository: [https://github.com/easycoder/easycoder.github.io](https://github.com/easycoder/easycoder.github.io)  
+Website: [https://easycoder.github.io](https://easycoder.github.io)
+
+## Quick Start
+Install **_EasyCoder_** in your Python environment:
+```
+pip install easycoder
+```
+Write a test script, 'hello.ecs', containing the following:
+```
+print `Hello, world!`
+```
+This is traditionally the first program to be written in virtually any language. To run it, use `easycoder hello.ecs`.
+
+The output will look like this:
+
+```
+EasyCoder version 250101.1
+Compiled <anon>: 1 lines (2 tokens) in 0 ms
+Run <anon>
+1-> Hello, world!
+```
+It's conventional to add a program title to a script:
+
+```
+!   Test script
+    script Test
+    print `Hello, world!`
+```
+The first line here is just a comment and has no effect on the running of the script.   The second line gives the script a name, which is useful in debugging as it says which script was running. When run, the output is now
+
+```
+EasyCoder version 250101.1
+Compiled Test: 3 lines (4 tokens) in 0 ms
+Run Test
+3-> Hello, world!
+```
+As you might guess from the above, the print command shows the line in the script it was called from. This is very useful in tracking down debugging print commands in large scripts.
+
+Here in the repository is a folder called `scripts` containing some sample scripts:
+
+`fizzbuzz.ecs` is a simple programming challenge often given at job interviews  
+`tests.ecs` is a test program containing many of the **_EasyCoder_** features  
+`benchmark.ecs` allows the performance of **_EasyCoder_** to be compared to other languages if a similar script is written for each one.
+
+## Graphical programmming
+**_EasyCoder_** includes a graphical programming environment that is in the early stages of development. A couple of demo scripts are included in the `scripts` directory. To run them, first install the Python `kivy` graphics library if it's not already present on your system. This is done with `pip install kivy`. Then run your **_EasyCoder_** script using `easycoder {scriptname}.ecg`.
+
+Graphical scripts look much like any other script but their file names must use the extension `.ecg` to signal to **_EasyCoder_** that it needs to load the graphics module. Non-graphical applications can use any extension but `.ecs` is recommended. This allows the **_EasyCoder_** application to be used wherever Python is installed, in either a command-line or a graphical environment, but graphics will of course not be available in the former.
+
+A couple of demo graphical scripts are included in the `scripts` directory:
+
+`graphics-demo.ecg` shows some of the elements that can be created, and demonstrates a variety of the graphical features of the language such as detecting when elements are clicked.
+
+`wave.ecg` is a "Mexican Wave" simulation.
+
+**_EasyCoder_** graphics are handled by a library module, `ec_renderer` that can be used outside of the **_EasyCoder_** environment, in other Python programs.
+
+## Programming reference
+
+**_EasyCoder_** comprises a set of modules to handle tokenisation, compilation and runtime control. Syntax and grammar are defined by [packages](doc/README.md), of which there are currently two; the [core](doc/core/README.md) package, which implements a comprehensive set of command-line programming features, and and the [graphics](doc/graphics/README.md) package, which adds graphical features in a windowing environment.
+
+## Extending the language
+
+**_EasyCoder_** can be extended to add new functionality with the use of 'plugins'. These contain compiler and runtime modules for the added language features. **_EasyCoder_** can use the added keywords, values and conditions freely; the effect is completely seamless. There is an outline example in the `plugins` directory called `example.py`, which comprises a module called `Points` with new language syntax to deal with two-valued items such as coordinates. In the `scripts` directory there is `points.ecs`, which exercises the new functionality.
+
+A plugin can act as a wrapper around any Python functionality that has a sensible API, thereby hiding its complexity. The only challenge is to devise an unambiguous syntax that doesn't clash with anything already existing in **_EasyCoder_**.

easycoder-250102.1/doc/README.md

@@ -0,0 +1,7 @@
+# _EasyCoder_ packages
+
+'Packages' are components of the **_EasyCoder_** system that deal with specific groups of language features. Those included or available from the repository are
+
+[core](core/README.md) contains all the language features needed to construct command-line applications to run on any computer equipped with Python.
+
+[graphics](graphics/README.md) contains a growing selection of graphical language features, to construct applications that will run on a computer with a graphical user interface; Windows, Mac or Linux.

easycoder-250102.1/doc/core/README.md

@@ -0,0 +1,21 @@
+# The 'core' package
+
+The core package contains all the keywords values and conditionals needed for general programming, and to build most command-line tools these are all that will be needed.
+
+There are three primary components to the language:
+
+ - Keywords
+ - Values
+ - Conditions
+
+The core keywords are:
+
+[add](keywords/add.md) [append](keywords/append.md) [assert](keywords/assert.md) [begin](keywords/begin.md) [clear](keywords/clear.md) [close](keywords/close.md) [create](keywords/create.md) [debug](keywords/debug.md) [decrement](keywords/decrement.md) [delete](keywords/delete.md) [divide](keywords/divide.md) [exit](keywords/exit.md) [file](keywords/file.md) [fork](keywords/fork.md) [get](keywords/get.md) [go](keywords/go.md) [gosub](keywords/gosub.md) [if](keywords/if.md) [import](keywords/import.md) [increment](keywords/increment.md) [index](keywords/index.md) [init](keywords/init.md) [input](keywords/input.md) [multiply](keywords/multiply.md) [negate](keywords/negate.md) [open](keywords/open.md) [pop](keywords/pop.md) [post](keywords/post.md) [print](keywords/print.md) [push](keywords/push.md) [put](keywords/put.md) [read](keywords/read.md) [replace](keywords/replace.md) [return](keywords/return.md) [script](keywords/script.md) [set](keywords/set.md) [split](keywords/split.md) [stack](keywords/stack.md) [stop](keywords/stop.md) [system](keywords/system.md) [take](keywords/take.md) [toggle](keywords/toggle.md) [truncate](keywords/truncate.md) [variable](keywords/variable.md) [wait](keywords/wait.md) [while](keywords/while.md) [write](keywords/write.md)
+
+The core values are:
+
+[arg](values/arg.md) [args](values/args.md) [cos](values/cos.md) [count](values/count.md) [datime/datetime](values/datime.md) [decode](values/decode.md) [element](values/element.md) [elements](values/elements.md) [empty](values/empty.md) [encode](values/encode.md) [error](values/error.md) [files](values/files.md) [float](values/float.md) [from](values/from.md) [hash](values/hash.md) [index](values/index.md) [integer](values/integer.md) [json](values/json.md) [keys](values/keys.md) [left](values/left.md) [length](values/length.md) [lowercase](values/lowercase.md) [mem/memory](values/mem.md) [modification](values/modification.md) [message](values/message.md) [newline](values/newline.md) [now](values/now.md) [position](values/position.md) [property](values/property.md) [random](values/random.md) [right](values/right.md) [sin](values/sin.md) [stringify](values/stringify.md) [tab](values/tab.md) [tan](values/tan.md) [timestamp](values/timestamp.md) [today](values/today.md) [trim](values/trim.md) [type](values/type.md) [uppercase](values/uppercase.md) [value](values/value.md) [weekday](values/weekday.md)
+
+The core conditions are:
+
+[Back](../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/add.md

@@ -1,3 +1,5 @@
+## add
+
 ## Syntax:
 `add {value} to {variable}`  
 `add {value} to {value} giving {variable}`
@@ -10,4 +12,4 @@ Adds a numeric value to a numeric variable or adds two values and puts the resul
 Next: [append](append.md)  
 Prev: [write](write.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/append.md

@@ -1,3 +1,5 @@
+# append
+
 ## Syntax:
 `append {value} to {array}`
 ## Examples:
@@ -10,4 +12,4 @@ Appends an item to a JSON array, which is is a string value held in a single var
 Next: [assert](assert.md)  
 Prev: [add](add.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/assert.md

@@ -1,3 +1,5 @@
+# assert
+
 ## Syntax:
 `assert {condition}`
 ## Examples:
@@ -8,4 +10,4 @@ Tests the condition and throws an exception if it is not true.
 Next: [begin](begin.md)  
 Prev: [append](append.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/begin.md

@@ -1,3 +1,5 @@
+# begin
+
 ## Syntax:
 `begin ... end`
 ## Examples:
@@ -12,4 +14,4 @@
 Next: [clear](clear.md)  
 Prev: [assert](assert.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/clear.md

@@ -1,3 +1,5 @@
+# clear
+
 ## Syntax:
 `clear {variable}`
 
@@ -10,4 +12,4 @@
 Next: [close](close.md)  
 Prev: [begin](begin.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/close.md

@@ -1,3 +1,5 @@
+# close
+
 ## Syntax:
 `close {file}`
 ## Examples:
@@ -8,4 +10,4 @@ Close the file identified by the `{file}` variable. See `file`, `open`, `read` a
 Next: [create](create.md)  
 Prev: [clear](clear.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/create.md

@@ -1,3 +1,5 @@
+# create
+
 ## Syntax:
 `create directory {name}`
 ## Examples:
@@ -8,4 +10,4 @@ Create a directory, giving the full path in `{name}`.
 Next: [debug](debug.md)  
 Prev: [close](close.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/debug.md

@@ -1,3 +1,5 @@
+# debug
+
 ## Syntax:
 `debug step/stop/program`
 ## Examples:
@@ -13,4 +15,4 @@ Set up a debug option.
 Next: [decrement](decrement.md)  
 Prev: [create](create.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/decrement.md

@@ -1,3 +1,5 @@
+# decrement
+
 ## Syntax:
 `decrement {variable}`
 ## Examples:
@@ -8,4 +10,4 @@ Decrements the value of the variable by 1. See also [increment](increment.md)
 Next: [delete](delete.md)  
 Prev: [debug](debug.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/delete.md

@@ -1,3 +1,5 @@
+# delete
+
 ## Syntax:
 `delete {filename}`  
 `delete property {value} of {variable}`
@@ -13,4 +15,4 @@ The second form deletes a named property of an object. See also [set property](s
 Next: [divide](divide.md)  
 Prev: [decrement](decrement.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/divide.md

@@ -1,3 +1,5 @@
+# divide
+
 ## Syntax:
 `divide {value} by {variable}`  
 `divide {value} by {value} giving {variable}`
@@ -11,4 +13,4 @@ Divides a numeric variable by a numeric value or divides one value by another an
 Next: [exit](exit.md)  
 Prev: [delete](delete.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/exit.md

@@ -1,3 +1,5 @@
+# exit
+
 ## Syntax:
 `exit`
 ## Examples:
@@ -8,4 +10,4 @@ Terminate the program.
 Next: [file](file.md)  
 Prev: [divide](divide.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/file.md

@@ -1,3 +1,5 @@
+# file
+
 ## Syntax:
 `file {name}`
 ## Example:
@@ -11,4 +13,4 @@ Declare a file variable. See [open](open.md), [read](read.md), [write](write.md)
 Next: [fork](fork.md)  
 Prev: [exit](exit.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/fork.md

@@ -1,3 +1,5 @@
+# fork
+
 ## Syntax:
 `fork to {label}`
 ## Examples:
@@ -10,4 +12,4 @@ When `fork` is used, the forked commands run until they reach a [stop](stop.md)
 Next: [get](get.md)  
 Prev: [exit](exit.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/get.md

@@ -1,3 +1,5 @@
+# get
+
 ## Syntax:
 `get {variable from {url} [or {command}]}`
 
@@ -9,7 +11,7 @@
 ## Description:
 Perform an HTTP GET to request data. In the second example, if the request fails some appropriate action can be taken.
 
-Next: [gosub](gosub.md)  
+Next: [go](go.md)  
 Prev: [fork](fork.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/go.md

@@ -1,3 +1,5 @@
+# go
+
 ## Syntax:
 `go [to] {label}`  
 `goto {label}`
@@ -10,4 +12,4 @@
 Next: [gosub](gosub.md)  
 Prev: [get](get.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/gosub.md

@@ -1,3 +1,5 @@
+# gosub
+
 ## Syntax:
 `gosub [to] {label}`
 ## Examples:
@@ -9,4 +11,4 @@
 Next: [if](if.md)  
 Prev: [go](go.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/if.md

@@ -1,3 +1,5 @@
+# if
+
 ## Syntax:
 `if {condition} {true-outcome} [else {false-outcome}]`
 
@@ -11,4 +13,4 @@
 Next: [import](import.md)  
 Prev: [gosub](gosub.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/import.md

@@ -1,3 +1,5 @@
+# import
+
 ## Syntax:
 `import {classname} from {path}`
 
@@ -10,4 +12,4 @@ As with [script](script.md), `import` is a compiler directive that should be pla
 Next: [increment](increment.md)  
 Prev: [if](if.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/increment.md

@@ -1,3 +1,5 @@
+# increment
+
 ## Syntax:
 `increment {variable}`
 
@@ -10,4 +12,4 @@ Add 1 to the value of the variable. See also [decrement](decrement.md).
 Next: [index](index.md)  
 Prev: [import](import.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/index.md

@@ -1,3 +1,5 @@
+# index
+
 ## Syntax:
 `index {variable} to {value}`
 
@@ -12,4 +14,4 @@
 Next: [init](init.md)  
 Prev: [increment](increment.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/init.md

@@ -1,3 +1,5 @@
+# init
+
 ## Syntax:
 `init {stack}`
 
@@ -11,4 +13,4 @@
 Next: [input](input.md)  
 Prev: [index](index.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/input.md

@@ -1,3 +1,5 @@
+# input
+
 ## Syntax:
 `input {variable} [with {prompt}]`
 ## Examples:
@@ -10,4 +12,4 @@
 Next: [multiply](multiply.md)  
 Prev: [init](init.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/multiply.md

@@ -1,3 +1,5 @@
+# multiply
+
 ## Syntax:
 `multiply {value} by {variable}`  
 `multiply {value} by {value} giving {variable}`
@@ -8,7 +10,7 @@
 ## Description:
 Multiplies a numeric variable by a numeric value or multiplies one value by another and puts the result into a variable. See elsewhere in this documentation for an explanation of what is meant by a value. If you multiply a variable it must already hold a numeric value, and if you assign a variable to hold the result of a multiplication it will lose whatever value it previously held. 
 
-Next: [open](open.md)  
+Next: [negate](negate.md)  
 Prev: [input](input.md)
 
-[Back](../README.md)
+[Back](../../README.md)

easycoder-250102.1/doc/core/keywords/negate.md

@@ -0,0 +1,13 @@
+# negate
+
+## Syntax:
+`negate {variable}`
+## Examples:
+`negate N`
+## Description:
+Negates a numeric variable (multiplies its value by -1).
+
+Next: [open](open.md)  
+Prev: [multiply](multiply.md)
+
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/open.md

@@ -1,3 +1,5 @@
+# open
+
 ## Syntax:
 `open {file} {path} for reading/writing/appending`
 ## Example:
@@ -20,6 +22,6 @@
 Opens a disk file for reading, writing or appending. Each of the [file](file.md) variables must be declared as such as in the example.
 
 Next: [pop](pop.md)  
-Prev: [multiply](multiply.md)
+Prev: [negate](negate.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/pop.md

@@ -1,3 +1,5 @@
+# pop
+
 ## Syntax:
 `pop {variable} from {stack}`
 ## Examples:
@@ -9,4 +11,4 @@ Pops the top value from the specified [stack](stack.md).
 Next: [post](post.md)  
 Prev: [open](open.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/post.md

@@ -1,3 +1,5 @@
+# post
+
 ## Syntax:
 `post {value} to {url} [giving {variable}] [or {command}]`
 
@@ -14,4 +16,4 @@ Perform an HTTP PUT request with the specified data and endpoint, optionally sav
 Next: [print](print.md)  
 Prev: [pop](pop.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/print.md

@@ -1,3 +1,5 @@
+# print
+
 ## Syntax:
 `print {value}`
 ## Examples:
@@ -11,4 +13,4 @@ The output is prefixed by the script line number of the print command. This is v
 Next: [push](push.md)  
 Prev: [post](post.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/push.md

@@ -1,3 +1,5 @@
+# push
+
 ## Syntax:
 `push {variable} to/onto {stack}`
 ## Examples:
@@ -10,4 +12,4 @@ Push something onto the specified [stack](stack.md).
 Next: [put](put.md)  
 Prev: [print](print.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/put.md

@@ -1,3 +1,5 @@
+# put
+
 ## Syntax:
 `put {value} into {variable}`
 ## Examples:
@@ -10,4 +12,4 @@ Put a value into a [variable](variable.md). The second example illustrates how t
 Next: [read](read.md)  
 Prev: [push](push.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/read.md

@@ -1,3 +1,5 @@
+# read
+
 ## Syntax:
 `read {value} from {file}`
 ## Examples:
@@ -9,4 +11,4 @@ Read a value from a [file](file.md). See [open](open.md), [write](write.md) and
 Next: [replace](replace.md)  
 Prev: [put](put.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/replace.md

@@ -1,3 +1,5 @@
+# replace
+
 ## Syntax:
 `replace {value} with {value} in {variable}`
 ## Examples:
@@ -10,4 +12,4 @@ Replaces all occurrences of one string with another in a string [variable](varia
 Next: [return](return.md)  
 Prev: [read](read.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/return.md

@@ -1,3 +1,5 @@
+# return
+
 ## Syntax:
 `return`
 ## Examples:
@@ -9,4 +11,4 @@ Return from a subroutine. See [gosub](gosub.md).
 Next: [script](script.md)  
 Prev: [replace](replace.md)
 
-[Back](../README.md)
+[Back](../../README.md)

{easycoder-241227.1/doc/core → easycoder-250102.1/doc/core/keywords}/script.md

@@ -1,3 +1,5 @@
+# script
+
 ## Syntax:
 `script {name}`
 ## Examples:
@@ -9,4 +11,4 @@ Provides a name for the script. Note that `name` is literal text, not a script v
 Next: [set](set.md)  
 Prev: [return](return.md)
 
-[Back](../README.md)
+[Back](../../README.md)