Use consistent formatting for module-level comments.

cranelift/src/filetest/domtree.rs

@@ -1,4 +1,3 @@
-
 //! Test command for verifying dominator trees.
 //!
 //! The `test domtree` test command looks for annotations on instructions like this:

lib/cretonne/src/ir/immediates.rs

@@ -1,4 +1,3 @@
-
 //! Immediate operands for Cretonne instructions
 //!
 //! This module defines the types of immediate operands that can appear on Cretonne instructions.

lib/cretonne/src/ir/types.rs

@@ -3,12 +3,6 @@
 use std::default::Default;
 use std::fmt::{self, Display, Debug, Formatter};
 
-// ====--------------------------------------------------------------------------------------====//
-//
-// Value types
-//
-// ====--------------------------------------------------------------------------------------====//
-
 /// The type of an SSA value.
 ///
 /// The `VOID` type is only used for instructions that produce no value. It can't be part of a SIMD

lib/reader/src/lexer.rs

@@ -1,9 +1,4 @@
-
+//! Lexical analysis for .cton files.
-// ====--------------------------------------------------------------------------------------====//
-//
-// Lexical analysis for .cton files.
-//
-// ====--------------------------------------------------------------------------------------====//
 
 use std::str::CharIndices;
 use std::u16;

lib/reader/src/parser.rs

@@ -1,9 +1,4 @@
-
+//! Parser for .cton files.
-// ====--------------------------------------------------------------------------------------====//
-//
-// Parser for .cton files.
-//
-// ====--------------------------------------------------------------------------------------====//
 
 use std::collections::HashMap;
 use std::str::FromStr;

lib/wasm/src/environ/dummy.rs

@@ -1,3 +1,5 @@
+//! "Dummy" environment for testing wasm translation.
+
 use environ::{FuncEnvironment, GlobalValue, ModuleEnvironment};
 use translation_utils::{Global, Memory, Table, GlobalIndex, TableIndex, SignatureIndex,
                         FunctionIndex, MemoryIndex};

lib/wasm/src/environ/mod.rs

@@ -1,3 +1,5 @@
+//! Support for configurable wasm translation.
+
 mod spec;
 mod dummy;
 

lib/wasm/src/translation_utils.rs

@@ -1,4 +1,4 @@
-///! Helper functions and structures for the translation.
+//! Helper functions and structures for the translation.
 use wasmparser;
 use cretonne;
 use std::u32;