Rust Essentials - Second Edition

Comments

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 ...