> Probably it would be good to have in the book some short reference of Nim's
> collections API.
In a book that makes absolutely no sense. I have a few computer books where
such type of references exists, a prominent example is the GTK Book of Mr
Krause. These people had trouble to fill the remaining pages -- some insert
useless pictures, some insert references. No one will really use a paper or pdf
book is these days for such references, and such references are outdated very
fast.
For Nim -- use one of the many editors with great nimsuggest support. For NEd
for example, type seq. and press Ctrl+Space. You get a list of all methods of
sequence type. Scroll down in the list, press Enter. You get seq.setLen. Type (
and press Ctrl+P and you see on the bottom statusbar:
system.setLen proc (s: var seq[T], newlen: Natural){.noSideEffect.}
But a tool for documentation inspection would be nice. For GTK there is a tool
called "devhelp" which makes browsing the documentation very fast and easy.
Something similar would be nice for Nim.