Browse Source

README: Axes.

Herbert Vojčík 6 years ago
parent
commit
6ac9e12684
1 changed files with 14 additions and 14 deletions
  1. 14 14
      README.md

+ 14 - 14
README.md

@@ -3,18 +3,19 @@ Axxord
 
 Small blackboard system for Amber Smalltalk.
 
-Legacy Lyst README follows:
+Axes
+----
 
-Get / set hierarchical data using array-like indexes.
+Axes is hierarchical index used to access blackboard data.
 
-The Lyst index (aka yndex) an array of elements: either strings, numbers
+Axes is an array of elements: either strings, numbers
 or a sub-arrays. These are used to denote the (relative) location
 of a piece of data in a hierarchical object, and is used to read or write
 from / to this position.
 
 Elements of a path are equivalent to elements of paths in classic file systems:
 each elements is one step deeper in a tree hierarchy. Thus, to read a data denoted
-by a path, Lyst starts from actual position, reads the contents denoted by first element,
+by a path, Axes starts from actual position, reads the contents denoted by first element,
 use the result to read the contents denoted by second elements etc. until the end.
 To write the data, the algorithm is similar to reading one, byt the last element is used
 to write the data instead.
@@ -26,16 +27,15 @@ to write the data instead.
  - if _subarray_ path element `#(bar)` is read from _foo_, `foo bar` is performed;
  - if _subarray_ path element `#(bar)` is written to _foo_, `foo bar: value` is performed.
 
-API
-----
+###API
 
 ----
 
 ```st
-Object >> atLyst: aCollection ifAbsent: aBlock
+Object >> atAxes: aCollection ifAbsent: aBlock
 ```
 
-For example `container atLyst: #((todos) 1 done) ifAbsent: [...]'` essentially does
+For example `container atAxes: #((todos) 1 done) ifAbsent: [...]'` essentially does
 
 	| x |
 	x := container todos at: 1.
@@ -54,10 +54,10 @@ the `ifAbsent` block value is returned.
 ----
 
 ```st
-Object >> atLyst: aCollection ifAbsent: aBlock put: anObject
+Object >> atAxes: aCollection ifAbsent: aBlock put: anObject
 ```
 
-For example `container atLyst: #((todos) 1 done) ifAbsent: [...] put: 'foo'` essentially does
+For example `container atAxes: #((todos) 1 done) ifAbsent: [...] put: 'foo'` essentially does
 
 	| x |
 	x := container todos at: 1.
@@ -75,16 +75,16 @@ the `ifAbsent` block value is returned.
 ----
 
 ```st
-Lyst class >> parse: aString
+Axes class >> parse: aString
 ```
 
-Parses a string to get a proper array index to use with `atLyst:` API.
+Parses a string to get a proper array index to use with `atAxes:` API.
 
 The syntax is resembling Smalltalk literal array syntax very closely.
-For example `Lyst parse: '(value)'` and `Lyst parse: '(todos) 1 done'`
+For example `Axes parse: '(value)'` and `Axes parse: '(todos) 1 done'`
 produce `#((value))` and `#((todos) 1 done)` as results.
 
 Syntactic sugar: as `(foo)` happens often, to denote unary selector,
 it can be written equivalently as `~foo`, to improve readability.
-So above Lyst indexes' parseable string representation
+So above Axes' parseable string representation
 would likely be written `'~value'` and `'~todos 1 done'` instead.