about summary refs log tree commit diff
path: root/src/doc/intro.md
AgeCommit message (Collapse)AuthorLines
2015-04-18Remove the 30 minute introSteve Klabnik-583/+2
Fixes #24569.
2015-04-14Fallout: move from scoped to spawnAaron Turon-0/+4
2015-04-08Rollup merge of #24139 - xfq:patch-1, r=steveklabnikManish Goregaokar-3/+3
Use HTTPS where possible to avoid plaintext HTTP connections.
2015-04-07Auto merge of #23277 - aochagavia:intro, r=steveklabnikbors-22/+14
cc @steveklabnik
2015-04-07Update intro.mdXue Fuqiao-3/+3
Use HTTPS where possible to avoid plaintext HTTP connections.
2015-03-22Re-word explanation on closures in introSteve Klabnik-10/+10
Fixes #23571
2015-03-16Fix 404 to crates.io's doc on integrating with a native toolchainPaul ADENOT-1/+1
This looks like the most logical target to give to this link, or at least what I would expect as someone that want to integrate with a native library. r? @steveklabnik
2015-03-11Remove unnecessary Arc usage in introductionAdolfo OchagavĂ­a-22/+14
2015-03-08Make concurrent examples actually run concurrentlyJake Goulding-4/+4
If we end the `scoped` call with a semicolon, the `JoinGuard` will be dropped and not returned from the `map`. The thread will start up and we immediately block, making for a very expensive sequential loop.
2015-03-08Update example that uses deprecated Thread::scopedJake Goulding-9/+9
2015-03-05Rollup merge of #22947 - ic:master, r=steveklabnikManish Goregaokar-5/+8
Changed guaranteed for \"quaranteed\", and Made failing/working examples look alike. r? @steveklabnik
2015-03-04Made failing/working examples look alike.Eric Platon-5/+8
The failing concurrency example was doing something different from the working example. This commit changes just enough of the failing example to (1) still fail with the same error, (2) tries to do the same as the working example (increment a vector value and print it). r? @steveklabnik
2015-02-28Change quaranteed -> guaranteed in README.mdAlexander Campbell-1/+1
2015-02-28Change slithtly -> slightly in README.mdAlexander Campbell-4/+4
2015-02-28change to iterate over &vetFuGangqiang-1/+1
2015-02-27remove the call `.iter()`FuGangqiang-2/+2
2015-02-22Update intro.md to fix thread spawning example Closes #22419Jessy Diamond Exum-34/+30
Fixed example threaded code in intro doc never printing results. Threads were created with Thread::spawn instead of Thread::scoped.
2015-02-18Update docs by dropping suffixes except where they served to instruct.Niko Matsakis-2/+2
2015-02-13Correct typo for 'underyling'Duane Edwards-1/+1
2015-01-31Kill more `isize`sTobias Bucher-3/+3
2015-01-21Fix type inference problems in tests and docsAaron Turon-5/+3
2015-01-21Fallout from stabilization.Aaron Turon-2/+2
2015-01-17Replace obsolete constructions in into examplesAndrew Barchuk-12/+12
Replace deprecated integer suffixes. Remove integer type notations altogether where possible. Replace uses of deprecated `range()` function with range notation.
2015-01-17Remove Thread::detach() call from intro exampleAndrew Barchuk-1/+1
The mentioned method are no longer part of Thread. Spawned threads are detached by default as of now.
2015-01-17Fix intro concurrency examples compilation warnsAndrew Barchuk-5/+5
* Use range notation instead of deprecated `range()` * Remove deprecated `u` integer suffixes used in ranges * Replace deprecated `i` integer suffixes with `is` for vector numbers `Thread::spawn()` still gives "use of unstable item" warning which I hadn't found a way to fix.
2015-01-15rollup merge of #21075: iKevinY/intro-changesAlex Crichton-21/+21
- Make punctuation/formatting consistent with the changes made to *The Rust Programming Language* in #20782. - Use title casing for "Safety and Speed" section. - Reword some phrases to improve clarity.
2015-01-12Various changes to Rust IntroductionKevin Yap-21/+21
- Make punctuation/formatting consistent with the changes made to "The Rust Programming Language" in #20782. - Use title casing for "Safety and Speed" section. - Reword some phrases to improve clarity.
2015-01-12Improve example in the intro.Steve Klabnik-10/+11
Thank you @bluss for the suggested implementation. Fixes #20844
2015-01-10Updates fixed-size suffixDuncan Regan-3/+3
Compiler gives the following warning: `warning: the `u` suffix on integers is deprecated; use `us` or one of the fixed-sized suffixes` And also the errror: `error: mismatched types: expected `u64`, found `usize` (expected u64, found usize)` Changing the suffix to `u64` results in a successful `cargo run` outputting the desired `Versions compared successfully!`
2015-01-08"The Rust Programming Language"Steve Klabnik-4/+5
This pulls all of our long-form documentation into a single document, nicknamed "the book" and formally titled "The Rust Programming Language." A few things motivated this change: * People knew of The Guide, but not the individual Guides. This merges them together, helping discoverability. * You can get all of Rust's longform documentation in one place, which is nice. * We now have rustbook in-tree, which can generate this kind of documentation. While its style is basic, the general idea is much better: a table of contents on the left-hand side. * Rather than a almost 10,000-line guide.md, there are now smaller files per section.
2015-01-07rollup merge of #20693: EchoAce/intro-oboeAlex Crichton-2/+2
Issue #20686, proposed by nstoddard.
2015-01-07oboe removedFakeKane-2/+2
2015-01-06Fallout from stabilizationAaron Turon-5/+4
2014-12-29std: Return Result from RWLock/Mutex methodsAlex Crichton-1/+1
All of the current std::sync primitives have poisoning enable which means that when a task fails inside of a write-access lock then all future attempts to acquire the lock will fail. This strategy ensures that stale data whose invariants are possibly not upheld are never viewed by other tasks to help propagate unexpected panics (bugs in a program) among tasks. Currently there is no way to test whether a mutex or rwlock is poisoned. One method would be to duplicate all the methods with a sister foo_catch function, for example. This pattern is, however, against our [error guidelines][errors]. As a result, this commit exposes the fact that a task has failed internally through the return value of a `Result`. [errors]: https://github.com/rust-lang/rfcs/blob/master/text/0236-error-conventions.md#do-not-provide-both-result-and-fail-variants All methods now return a `LockResult<T>` or a `TryLockResult<T>` which communicates whether the lock was poisoned or not. In a `LockResult`, both the `Ok` and `Err` variants contains the `MutexGuard<T>` that is being returned in order to allow access to the data if poisoning is not desired. This also means that the lock is *always* held upon returning from `.lock()`. A new type, `PoisonError`, was added with one method `into_guard` which can consume the assertion that a lock is poisoned to gain access to the underlying data. This is a breaking change because the signatures of these methods have changed, often incompatible ways. One major difference is that the `wait` methods on a condition variable now consume the guard and return it in as a `LockResult` to indicate whether the lock was poisoned while waiting. Most code can be updated by calling `.unwrap()` on the return value of `.lock()`. [breaking-change]
2014-12-18Revise std::thread API to join by defaultAaron Turon-9/+17
This commit is part of a series that introduces a `std::thread` API to replace `std::task`. In the new API, `spawn` returns a `JoinGuard`, which by default will join the spawned thread when dropped. It can also be used to join explicitly at any time, returning the thread's result. Alternatively, the spawned thread can be explicitly detached (so no join takes place). As part of this change, Rust processes now terminate when the main thread exits, even if other detached threads are still running, moving Rust closer to standard threading models. This new behavior may break code that was relying on the previously implicit join-all. In addition to the above, the new thread API also offers some built-in support for building blocking abstractions in user space; see the module doc for details. Closes #18000 [breaking-change]
2014-12-15rollup merge of #19735: sethpollack/patch-1Brian Anderson-4/+4
2014-12-15rollup merge of #19714: steveklabnik/gh16219Brian Anderson-2/+2
These should be properly annotated instead. Fixes #16219.
2014-12-14Update guide/intro to take into account the removal of `proc`.Niko Matsakis-24/+32
cc @steveklabnick
2014-12-11Update intro.mdSeth Pollack-4/+4
2014-12-10Fix up some {ignore} and {notrust}sSteve Klabnik-2/+2
These should be properly annotated instead. Fixes #16219.
2014-12-09Test fixes and rebase conflicts from the rollupAlex Crichton-4/+4
2014-12-09rollup merge of #19614: steveklabnik/gh19599Alex Crichton-2/+2
Fixes #19599
2014-12-07remove usage of notrust from the docsSteve Klabnik-2/+2
Fixes #19599
2014-12-06Add missing semicolon to hello world program in intro.jbranchaud-1/+1
2014-11-07Prepend should be append in the 30 minute introCarol Nichols-1/+1
The examples are about adding to the end of the array, not the beginning.
2014-10-31small fix to output of code sample in intro.mdRolf van de Krol-6/+6
2014-10-23Improve code in the intro.Steve Klabnik-1/+1
All these stars aren't needed anymore.
2014-10-18[Docs] more intro typosNeil Pankey-7/+7
2014-10-18[Docs] intro typoNeil Pankey-4/+4
2014-10-03Re-do the 30 minute introSteve Klabnik-358/+499
This was originally on my blog, so it's incredibly informal. Let's make it better.