Fix the syntax of doc comments

Author: Marek Suchánek

src/cmd_line.rs

@@ -16,10 +16,10 @@ You should have received a copy of the GNU General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-///! # `cmd_line.rs`
-///!
-///! This module defines the command-line arguments and behavior of `newdoc`.
-///! It relies on the `clap` crate.
+//! # `cmd_line.rs`
+//!
+//! This module defines the command-line arguments and behavior of `newdoc`.
+//! It relies on the `clap` crate.
 use clap::{command, Arg, ArgGroup, ArgMatches};
 
 /// Define the command-line arguments and return them as the `clap::ArgMatches` struct.

src/lib.rs

@@ -28,10 +28,11 @@ along with this program.  If not, see <https://www.gnu.org/licenses/>.
 // Forbid unsafe code in this program.
 #![forbid(unsafe_code)]
 
-///! # newdoc
-///! The `newdoc` tool generates pre-populated module and assembly files formatted with AsciiDoc,
-///! which are used in Red Hat and Fedora documentation. The generated files follow
-///! the Modular Documentation guidelines: <https://redhat-documentation.github.io/modular-docs/>.
+//! # newdoc
+//! The `newdoc` tool generates pre-populated module and assembly files formatted with AsciiDoc,
+//! which are used in Red Hat and Fedora documentation. The generated files follow
+//! the Modular Documentation guidelines: <https://redhat-documentation.github.io/modular-docs/>.
+
 use clap::ArgMatches;
 use color_eyre::eyre::{bail, eyre, Result, WrapErr};
 

src/module.rs

@@ -16,7 +16,8 @@ You should have received a copy of the GNU General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-/// This module defines the `Module` struct, its builder struct, and methods on both structs.
+//! This module defines the `Module` struct, its builder struct, and methods on both structs.
+
 use std::fmt;
 use std::path::{Component, Path, PathBuf};
 

src/validation.rs

@@ -16,8 +16,9 @@ You should have received a copy of the GNU General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
-/// This module provides functionality to validate (lint) existing module and assembly files,
-/// to check if the files meet the template structure and other requirements.
+//! This module provides functionality to validate (lint) existing module and assembly files,
+//! to check if the files meet the template structure and other requirements.
+
 use std::ffi::OsStr;
 use std::fmt;
 use std::fs;