HACKING: catch up with libsigrok docs (mem alloc, var decl)

Bring the "Random notes" section closer to the libsigrok documentation.
Adjust the discussion of memory allocation. Prefer variable declaration
at the start of routines, and separate them from value assignments.