3 Now that we have some functions, it’s a good idea to learn about comments.
4 Comments are notes that you leave to other programmers to help explain things
5 about your code. The compiler mostly ignores them.
7 Rust has two kinds of comments that you should care about: *line comments*
11 // Line comments are anything after ‘//’ and extend to the end of the line.
13 let x = 5; // this is also a line comment.
15 // If you have a long explanation for something, you can put line comments next
16 // to each other. Put a space between the // and your comment so that it’s
20 The other kind of comment is a doc comment. Doc comments use `///` instead of
21 `//`, and support Markdown notation inside:
24 /// Adds one to the number given.
31 /// assert_eq!(6, add_one(5));
32 /// # fn add_one(x: i32) -> i32 {
36 fn add_one(x: i32) -> i32 {
41 When writing doc comments, providing some examples of usage is very, very
42 helpful. You’ll notice we’ve used a new macro here: `assert_eq!`. This compares
43 two values, and `panic!`s if they’re not equal to each other. It’s very helpful
44 in documentation. There’s another macro, `assert!`, which `panic!`s if the
45 value passed to it is `false`.
47 You can use the [`rustdoc`](documentation.html) tool to generate HTML documentation
48 from these doc comments, and also to run the code examples as tests!