refs #35 serializatino framework refactored: implementation put in open methods of Obj/ObjClass for flexibility

docs/OOP.md

@@ -250,11 +250,10 @@ Note `Real` class: it is global variable for Real class; there are such class in
     assert('$'::class == Char)
     >>> void
 
-More complex is singleton classes, because you don't need to compare their class
-instances and generally don't need them at all, these are normally just Obj:
+Singleton classes also have class:
 
     null::class
-    >>> Obj
+    >>> Null
 
 At this time, `Obj` can't be accessed as a class.
 

docs/time.md

@@ -98,11 +98,16 @@ so it is possible to truncate it to milliseconds, microseconds or seconds:
     import lyng.serialization
 
     // max supported size (now microseconds for serialized value):
-    assert( Lynon.encode(Instant.now()).size in [8,9] )
+    // note that encoding return _bit array_ and this is a _bit size_:
+    val s0 = Lynon.encode(Instant.now()).size
+
     // shorter: milliseconds only
-    assertEquals( 7, Lynon.encode(Instant.now().truncateToMillisecond()).size )
+    val s1 = Lynon.encode(Instant.now().truncateToMillisecond()).size
+
     // truncated to seconds, good for file mtime, etc:
-    assertEquals( 6, Lynon.encode(Instant.now().truncateToSecond()).size )
+    val s2 = Lynon.encode(Instant.now().truncateToSecond()).size 
+    assert( s1 < s0 )
+    assert( s2 < s1 )
     >>> void
 
 ## Formatting instants

docs/tutorial.md

@@ -1217,25 +1217,26 @@ Concatenation is a `+`: `"hello " + name` works as expected. No confusion.
 
 Typical set of String functions includes:
 
-| fun/prop           | description / notes                                        |
-|--------------------|------------------------------------------------------------|
-| lower()            | change case to unicode upper                               |
-| upper()            | change case to unicode lower                               |
+| fun/prop          | description / notes                                        |
+|-------------------|------------------------------------------------------------|
+| lower()           | change case to unicode upper                               |
+| upper()           | change case to unicode lower                               |
 | startsWith(prefix) | true if starts with a prefix                               |
-| endsWith(prefix)   | true if ends with a prefix                                 |
-| take(n)            | get a new string from up to n first characters             |
-| takeLast(n)        | get a new string from up to n last characters              |
-| drop(n)            | get a new string dropping n first chars, or empty string   |
-| dropLast(n)        | get a new string dropping n last chars, or empty string    |
-| size               | size in characters like `length` because String is [Array] |
-| (args...)          | sprintf-like formatting, see [string formatting]           |
-| [index]            | character at index                                         | 
-| [Range]            | substring at range                                         |
-| s1 + s2            | concatenation                                              |
-| s1 += s2           | self-modifying concatenation                               |
-| toReal()           | attempts to parse string as a Real value                   |
-| toInt()            | parse string to Int value                                  |
-| characters()       | create [List] of characters (1)                            |
+| endsWith(prefix)  | true if ends with a prefix                                 |
+| take(n)           | get a new string from up to n first characters             |
+| takeLast(n)       | get a new string from up to n last characters              |
+| drop(n)           | get a new string dropping n first chars, or empty string   |
+| dropLast(n)       | get a new string dropping n last chars, or empty string    |
+| size              | size in characters like `length` because String is [Array] |
+| (args...)         | sprintf-like formatting, see [string formatting]           |
+| [index]           | character at index                                         | 
+| [Range]           | substring at range                                         |
+| s1 + s2           | concatenation                                              |
+| s1 += s2          | self-modifying concatenation                               |
+| toReal()          | attempts to parse string as a Real value                   |
+| toInt()           | parse string to Int value                                  |
+| characters()      | create [List] of characters (1)                            |
+| encodeUtf8()      | returns [Buffer] with characters encoded to utf8           |
 
 (1)
 : List is mutable therefore a new copy is created on each call.