News for hackers. Stuff that matters.
Re:Modern C [pdf] by jandrese on Monday November 28, 2016 @08:07AM (#13055128)
I was trying to teach myself some Rust and found the state of the documentation to be very frustrating. The core language is decently documented with the manual, but the standard library documentation was out of date in many places, most annoyingly in the first few hits on Google.

I found 5 different ways to read a file on Google, and only one of them still worked. Plus I saw the release notes on the newest version that the syntax that worked is now obsolete in favor of a new operator.

Re:Modern C [pdf] by steveklabnik on Monday November 28, 2016 @10:53AM (#13056175)
The docs should never be "out of date" as in not working, though some parts don't have more than type signatures yet. Working on it. Please file bugs if something is not working, or swing by #rust-beginners, we love to help!
Re:Modern C [pdf] by AsyncAwait on Monday November 28, 2016 @08:37AM (#13055278)
What are you missing from the up-to-date API reference[1]?

[1] - https://doc.rust-lang.org/std/

Re:Modern C [pdf] by jandrese on Monday November 28, 2016 @11:29PM (#13060797)
I was trying to read a file one line at a time (reading only the first few lines of a very large file), and it turned out to be somewhat difficult as the built-in functions seemed to be really keen on operating on the entire file at once.
Re:Modern C [pdf] by ehsanu1 on Monday November 28, 2016 @06:05PM (#13059218)
You still have to be a bit careful about finding old posts and old docs on the internet about Rust, given that many APIs have only been stable for a short while.

In general, unless you know your source is up to date, I'd recommend ignoring the internet at large completely when it comes to Rust APIs and just focusing on the official docs for the release that you're using. They're plenty good enough, though you do have to get used to navigating them.

Re:Modern C [pdf] by sidlls on Monday November 28, 2016 @01:22PM (#13057304)
Really? I read the documentation for file I/O directly out of the Rust online docs and put together a complete serialization module for a project I'm working on. It was actually quite straightforward.