I know you guys are focused on bringing more features to the lib, but it would be good to provide a bit better documentation and examples (I sent another post about this), so the ones willing to use the current version can fully understand what they can do with it..

E.g.

• I am not sure how to use signals, I can see raft::fileread uses raft::eof, but not sure what is done with it.
• I don't

Right now, docs are only what is present in the header files. Make separate docs that can be used easily.

Use

• for bash:

/usr/bin/time --verbose 

perf stat -e cycles,stalled-cycles-frontend,stalled-cycles-backend,instructions,\
cache-references,cache-misses,branches,branch-misses,task-clock,faults,\
minor-faults,cs,migrations -r 3

• for Python:

#cProfile:
python -m cProfile -s cumulative
python -m cProfile -o profile.stats
pip install runsnake
#linepro