Standard library documentation

src/13-core-functions.md

@@ -122,6 +122,6 @@ io.println(hello[5]);
 
 Output:
 ```
-h
+!
 (nil)
 ```

src/std/1-std-io.md

@@ -47,7 +47,7 @@ My name is John. I am 21.
 ```
 println(args...) -> nil
 ```
-Prints all given `args` to the standard output and add a new line after the last one
+Prints all given `args` to the standard output and adds a new line after the last one
 
 Example:
 ```
@@ -87,7 +87,7 @@ My name is John. I am 21.
 ```
 fprintln(file: file, args...) -> nil
 ```
-Writes all given `args` to `file` and add a new line after the last one
+Writes all given `args` to `file` and adds a new line after the last one
 
 Example:
 ```
@@ -139,7 +139,7 @@ The possible color codes are the following:
 ```
 cprintln(args...) -> nil
 ```
-Prints all given `args` to the standard output and add a new line after the last one and interpret color codes to change the text color. A color change is not bound to a single `cprintln` call and will remain active until another one comes in.
+Prints all given `args` to the standard output and adds a new line after the last one and interpret color codes to change the text color. A color change is not bound to a single `cprintln` call and will remain active until another one comes in.
 
 Example:
 ```
@@ -171,7 +171,7 @@ For the list of available color codes, please refer to [cprint](#cprint)
 ```
 cdprintln(args...) -> nil
 ```
-Prints all given `args` to the standard output and add a new line after the last one and interpret color codes to change the text color. A color change is not bound to a single `cprintln` call and will remain active until another one comes in.
+Prints all given `args` to the standard output and adds a new line after the last one and interpret color codes to change the text color. A color change is not bound to a single `cprintln` call and will remain active until another one comes in.
 
 Example:
 ```
@@ -207,7 +207,7 @@ You are 21 years old
 ```
 scaneof(prompt: string = '') -> string
 ```
-Reads text from the standard input until *EOF* is found. Even id *EOF* can be emitted by a user (usually *CTRL-D* on UNIX), `scaneof` is more likely to be useful when a **Feral** script takes as an input the output of another program.
+Reads text from the standard input until *EOF* is found. Even if *EOF* can be emitted by a user (usually *CTRL-D* on UNIX), `scaneof` is more likely to be useful when a **Feral** script takes as an input the output of another program.
 
 An optional `prompt` parameter can be passed to write the given string before reading the standard input.
 

src/std/2-std-lang.md

@@ -2,7 +2,7 @@
 
 The **lang** module offers a way to create user-defined structures and enumerations.
 
-A structure can pack together variables and functions, which allow object-oriented programming.
+A structure can pack together variables and functions, which allows object-oriented programming.
 
 An enumeration is a set of names bounds to constant numerical values.
 
@@ -20,9 +20,9 @@ let io = import('std/io');
 ```
 lang.struct(field = value, ...) -> type
 ```
-Creates a new structure type type holding a set of `field`s. The given `value`s are used to infer the type of each field and as default values during construction. The return type can be used to instantiate objects of this type.
+Creates a new structure type type holding a set of `field`s. The given `value`s are used to infer the type of each field and as default values during construction. The returned type can be used to instantiate objects of this type.
 
-Adding member functions to a type is done with the `let func in type = fn(args) {}` construct, with `func` being the function's name. Inside the function, variables and functions belonging to the type can be accessed using the `self` keyword.
+Adding member functions to a type is done with the `let func in type = fn(args) {};` construct, with `func` being the function's name. Inside the function, variables and functions belonging to the type can be accessed using the `self` keyword.
 
 Example:
 ```

src/std/3-std-strings.md

@@ -3,7 +3,7 @@
 The **str** module defines member functions for the native `string` type and other string manipulation related functions.
 The functions available natively in the language can be consulted [here](/13-core-functions.html#string).
 
-A `string` is a sequence of characters. There is no character type in **Feral** and so are represented are one character strings.
+A `string` is a sequence of characters. There is no character type in **Feral** and so are represented as one character strings.
 
 All the given examples assume the following imports:
 ```

src/std/4-std-vectors.md

@@ -268,7 +268,7 @@ Gives the output:
 ```
 vector.slice(start: int, end: int = -1) -> vector
 ```
-Extracts the elements from `start` to `end - 1` and returns them in a new vector. If `end == -1` then the slice ends at the end of the vector
+Extracts the elements from `start` to `end - 1` and returns them in a new vector. If `end == -1` then the slice ends at the end of the vector. Any modification in the elements of a slice will affect its original vector as well
 
 Example:
 ```

src/std/5-std-maps.md

@@ -1,6 +1,6 @@
 # Maps
 
-The **map** module defines the `map` type and all the vector manipulation related functions.
+The **map** module defines the `map` type and all the map manipulation related functions.
 
 A `map` is an associative container that can store heterogeneous types.
 
@@ -40,7 +40,7 @@ Gives the output:
 {Answer?: 42, 0: Zero, 1: One}
 ```
 
-Note that the elements are not stored in the order they are given. They are lexicographically sorted
+Note that the elements are not stored in any particular order and thus does not necessarily follow the given one
 
 ### len
 ```