Release ready.

Author: KaruroChori

RELEASE.md

@@ -2,11 +2,14 @@
 
 Introduced tree-rewrite capabilities with `s:for` via the additional attributes `src-children` and `dst-children`.  
 Basically the same for cycle is applied recursively inside the relative path described by `src-children` and applied inside `dst-children`.  
+The actual behaviour of `dst-children` has not been fully implemented yet, as it requires access to children in reverse order, making it incompatible with the rest of the codebase.  
+As such, some custom implementation is needed. For now one can only specify the direct name of the tag embedding children, without nesting as it should be in its final form.  
+The nested behaviour of `s:for` is going to change a bit in `v0.4.9` once `dst-children` is fully fixed.
 
 We also added support for more VM functions:
 - `timestamp` as the name implies
 - `rid` to generate a 256bit random ID serialized as hex string.
 - `sid` to generate an `int`-sized sequential ID, autoincrementing and with an optional family ID to have independent sequences.
 
-Finally, logs now have a proper context which provided the path of the several locations which are affected, as well as the offset which can be used to locate the issue.  
-For more details check changes to `log_t::ctx`.
+Finally, logs have now a proper context which provides paths and offsets to the template, data and destination locations which triggered the message.  
+For more details, check changes to `log_t::ctx`.

TODO.md

@@ -2,7 +2,7 @@
 
 ## `v0.4.9`
 
-- [ ] Properly show ctx information while logging
+- [ ] Complete handling of `dst-children` in `for` which is quite incomplete for now.
 - [ ] In the UI for the demo, add a loader as the first boot is quite slow
 - [ ] Fill in the docs at least of the public interface
 - [ ] `string_view` version of `strnatcmp` to optimize the dot comparisons
@@ -14,7 +14,7 @@
 - [ ] Optimization for lower-end systems by reducing explicit memory allocations if possible and adopting string views.
 - [ ] Expose a mechanism to allow externally defined expressions? Not sure about this one, but it might be good when embedding this library.
 
-## `v1.0.0`
+## `v1.0.x`
 
 - [ ] Some good testing coverage is highly desirable.
 - [ ] Add a proper xml schema for this language (rng in place of xsd as they are more flexible for unordered files that I want to support)

docs/releases/v0.4.7.md

@@ -0,0 +1,13 @@
+Introduced tree-rewrite capabilities with `s:for` via the additional attributes `src-children` and `dst-children`.  
+Basically the same for cycle is applied recursively inside the relative path described by `src-children` and applied inside `dst-children`.  
+The actual behaviour of `dst-children` has not been fully implemented yet, as it requires access to children in reverse order, making it incompatible with the rest of the codebase.  
+As such, some custom implementation is needed. For now one can only specify the direct name of the tag embedding children, without nesting as it should be in its final form.  
+The nested behaviour of `s:for` is going to change a bit in `v0.4.9` once `dst-children` is fully fixed.
+
+We also added support for more VM functions:
+- `timestamp` as the name implies
+- `rid` to generate a 256bit random ID serialized as hex string.
+- `sid` to generate an `int`-sized sequential ID, autoincrementing and with an optional family ID to have independent sequences.
+
+Finally, logs have now a proper context which provides paths and offsets to the template, data and destination locations which triggered the message.  
+For more details, check changes to `log_t::ctx`.

meson.build

@@ -1,7 +1,7 @@
 project(
   'vs-templ',
   ['cpp'],
-  version: '0.4.6',
+  version: '0.4.7',
   meson_version: '>= 1.1',
   default_options: ['cpp_std=c++20'],
 )