Ideally, a program should be self-documenting by using descriptive variable names and easy-to-read code, but there are always cases where additional comments about a program's structure or algorithms are needed. Rust follows the C convention and has:
//line comments; everything on the line after//is commentary and not compiled/* */block or multi-line comments; everything between the start/*and the end*/is not compiled
However, the preferred Rust style is to use only the // comment, also for multiple lines, as shown in the following code:
// see Chapter 2/code/comments.rs
fn main() {
// Here starts the execution of the Game.
// We begin with printing a welcome message:
println!("Welcome to the Game!");
} Use the /* */ comments only to comment out code.
Rust also has a doc comment with ///, useful in larger projects that require an official documentation for customers and developers. Such comments have to appear before an item (like a function) on a separate line to document...