Use block comments for module doc comments

RustRover can currently wrap these correctly, in contrast with their
line comment equivalents:
https://youtrack.jetbrains.com/issue/RUST-17888/

Author: mshroyer

coretypes/src/measure.rs

@@ -1,9 +1,10 @@
-//! Simple zero-overhead unit of measure types
-//!
-//! A poor man's version of F#'s units of measure, in order to keep units
-//! correct by construction.  I wrote these rather than use the popular `uom`
-//! crate because the latter obscures the actual storage unit and numeric
-//! type.
+/*!
+Simple zero-overhead unit of measure types
+
+A poor man's version of F#'s units of measure, in order to keep units correct by
+construction.  I wrote these rather than use the popular `uom` crate because the
+latter obscures the actual storage unit and numeric type.
+*/
 
 use std::ops::{Add, AddAssign, Div};
 

coursepointer/src/course.rs

@@ -1,4 +1,6 @@
-//! Abstract course elements
+/*!
+Abstract course elements
+*/
 
 use coretypes::GeoPoint;
 use coretypes::measure::Meters;
@@ -47,9 +49,7 @@ impl CourseSetBuilder {
         for course_builder in self.courses {
             courses.push(course_builder.build());
         }
-        CourseSet {
-            courses,
-        }
+        CourseSet { courses }
     }
 }
 

coursepointer/src/gpx.rs

@@ -1,17 +1,19 @@
-//! GPX track/route and waypoint reader
-//!
-//! # Usage
-//!
-//! Provides an iterator that reads in sequence the trackpoints/routepoints,
-//! waypoints, and other relevant items from a GPX track file.
-//!
-//! This module treats GPX routes and tracks synonymously, except that tracks
-//! may also contain segments.
-//!
-//! To use module, instantiate a [`GpxReader`] by calling
-//! [`GpxReader::from_text`] or [`GpxReader::from_reader`]. Iterating over the
-//! [`GpxReader`] will produce a sequence of [`GpxItem`] describing the
-//! contents of the input.
+/*!
+GPX track/route and waypoint reader
+
+# Usage
+
+Provides an iterator that reads in sequence the trackpoints/routepoints,
+waypoints, and other relevant items from a GPX track file.
+
+This module treats GPX routes and tracks synonymously, except that tracks may
+also contain segments.
+
+To use module, instantiate a [`GpxReader`] by calling
+[`GpxReader::from_text`] or [`GpxReader::from_reader`]. Iterating over the
+[`GpxReader`] will produce a sequence of [`GpxItem`] describing the
+contents of the input.
+*/
 
 use std::io::BufRead;
 use std::num::ParseFloatError;
@@ -20,8 +22,8 @@ use std::{mem, str};
 use coretypes::measure::{Degrees, Meters};
 use coretypes::{GeoPoint, TypeError};
 use quick_xml;
-use quick_xml::events::attributes::AttrError;
 use quick_xml::events::Event;
+use quick_xml::events::attributes::AttrError;
 use quick_xml::name::QName;
 use quick_xml::reader::Reader;
 use thiserror::Error;
@@ -352,7 +354,7 @@ where
 #[cfg(test)]
 mod tests {
     use coretypes::measure::{Degrees, Meters};
-    use coretypes::{geo_points, GeoPoint};
+    use coretypes::{GeoPoint, geo_points};
 
     use super::{GpxError, GpxItem, GpxReader, Result, Waypoint};