Hi to everybody,
Today I tried to install the latest stable version of Nim (0.15.2) on my Linux Mint system. I think I spotted a few problems in the documentation; I am reporting them here because it is not clear to me if the Nim's GitHub bugtracker is appropriate for this kind of issues.
I followed the instructions on the website («Installation based on generated C code»), which seems to be the preferred way to install Nim under Linux. I downloaded the tarball, unpacked it and compiled the nim executable. At this point, I was not able to create the executable for nimsuggest. The site says:
To build associated tools like nimble and nimsuggest run nim c koch && koch tools
However, the koch executable bundled with Nim 0.15.2 does not seem to support the tools command, and while koch nimble works, koch nimsuggest prints the help screen and exits.
I turned to the Nim Documentation index, and I spotted the paragraph explaining how to install nimsuggest:
cd compiler/nimsuggest
nim c -d:release nimsuggest
So I decided to follow this advice. However, the latter command returned the following error message:
compiler/nimsuggest/nimsuggest.nim(12, 8) Error: This project has moved to the following repo: https://github.com/nim-lang/nimsuggest
Ok, so I turned to the nimsuggest GitHub webpage, which says:
Starting with version 0.15.3, nimsuggest is part of the Nim repository again. This is only used as an issue tracker. […] Nimsuggest is part of the Nim core now, koch can build nimsuggest for you.
So I am back to the start! With a little bit of effort I should be able to compile nimsuggest manually, as I used Nim quite a lot a few years ago. However, a novice user might get confused.
(I would suggest to add some text/link at the bottom of each page on the website, which should explain what is the proper way to report errors/omissions/suggestions about the website itself. Should one post on the forum, like I am doing right now, or open a ticket on the bugtracker, or…?)
EDIT: I found the right instructions, they are in the file install.txt.
EDIT: Kock 0.16.0 still does not recognize the tool nimsuggest, and nimble fails to build nimsuggest, both when using the 0.15.2 tag and @#head. (See https.)