One of the things that made me so excited about Rust when I first used it was the capabilities of the Rustdoc system. The built in examples that are also unit tests, the ease of just using markdown... and now the linking is even simpler. It’s one of my favorite things about the language, and I think is why so many crates have such good documentation, because it’s easy to do. (and it’s tested and validated so you know…
Not directly related, but when I was learning programming back in highschool (before the Internet) what made it easy was the built in help in Turbo Pascal. You could press F1 over any function or keyword and you were given a detailed description and example of usage. Learning C later using the K&R book and Google was a huge downgrade. Even today I think that language help built into the IDE should be a basic function…
Rust 1.48
111–119 of 119 posts
Re: Rust 1.48
#112Earlier quoted context omitted.
Not directly related, but when I was learning programming back in highschool (before the Internet) what made it easy was the built in help in Turbo Pascal. You could press F1 over any function or keyword and you were given a detailed description and example of usage. Learning C later using the K&R book and Google was a huge downgrade. Even today I think that language help built into the IDE should be a basic function…
You could do the same with C in Visual Studio for at least 15 years now
Re: Rust 1.48
#113A few months ago I tried Rust but found that the tooling like auto completion and highlighting where still a bit alpha. IIRC I used VSCode with the most popular Rust plugin at the time. Did I miss something or is there some progress being made in that respect?
I don't want this to sound like a criticism, but I would like to understand your point of view: do you really consider this a reason for choosing a language over any other? Even if you had to use notepad to program - or had very basic syntax highlighting - wouldn't be what the language provides a more compelling point to make these choices?
Absolutely yes.
I no longer consider a programming language finished unless it has at least tab-complete and proper debugging support. Inline popup doc-comments are nearly mandatory too.
Not designing a new language for modern tooling is a cardinal sin. It's giving up decades of progress for... what exactly? Some sort of ascetic purity?
One disappointing design aspect of Rust specifically is that it has a tendency to "hide" functions unless explicitly imported. This makes things difficult for IDE tab-completion. It gives the false impression that some functions are missing, when in fact they were simply not imported into scope.
The language seems to be designed for developers that know ahead of time what they will or will not use, to the finest detail, before they even start typing code.
I've only ever met one programmer that could do that: start at the top of the file and type continuously, left-to-right and top-to-bottom without editing, without pause, without having to go back and fill in anything he had missed. Let's just say he was a "special sort" and leave it at that.
The rest of us are much more productive with IDEs and debuggers.
Re: Rust 1.48
#114Earlier quoted context omitted.
You could do the same with C in Visual Studio for at least 15 years now
That requires an internet connection and opens a page in your browser.
The Web version came much later.
Re: Rust 1.48
#115Earlier quoted context omitted.
That requires an internet connection and opens a page in your browser.
Nope, because one would install the MSDN documentation locally from the bundled CDs and use Windows help infrastructure. The Web version came much later.
Re: Rust 1.48
#116Earlier quoted context omitted.
Nope, because one would install the MSDN documentation locally from the bundled CDs and use Windows help infrastructure. The Web version came much later.
Which means that currently it requires an internet connection and opens a page in your browser.
Re: Rust 1.48
#117Earlier quoted context omitted.
Which means that currently it requires an internet connection and opens a page in your browser.
No it doesn't. https://docs.microsoft.com/en-us/visualstudio/help-viewer/ov...
https://docs.microsoft.com/en-us/dotnet/api/microsoft.codean...
Re: Rust 1.48
#118Earlier quoted context omitted.
No it doesn't. https://docs.microsoft.com/en-us/visualstudio/help-viewer/ov...
Have you actually tried that? I just installed it and it's just a buch of help files that link to the web. F1 continues to work the same way, bringing up websites, often useless ones like this one for a for loop: https://docs.microsoft.com/en-us/dotnet/api/microsoft.codean...
Re: Rust 1.48
#119Earlier quoted context omitted.
Have you actually tried that? I just installed it and it's just a buch of help files that link to the web. F1 continues to work the same way, bringing up websites, often useless ones like this one for a for loop: https://docs.microsoft.com/en-us/dotnet/api/microsoft.codean...
Have you installed the Help Viewer and configured as advised?