Add a bit more structure via documentation

lib/src/command.rs

@@ -1,3 +1,5 @@
+//! Command construction and configuration thereof.
+
 use tokio::process::Command;
 
 /// Shell to use to run commands.

lib/src/error.rs

@@ -1,4 +1,4 @@
-//! Watchexec has two error types: for critical and for runtime errors.
+//! Error types for critical, runtime, and specialised errors.
 
 use std::path::PathBuf;
 

lib/src/event.rs

@@ -1,3 +1,5 @@
+//! Synthetic event type, derived from inputs, triggers actions.
+//!
 //! Fundamentally, events in watchexec have three purposes:
 //!
 //! 1. To trigger the launch, restart, or other interruption of a process;

lib/src/fs.rs

@@ -1,3 +1,5 @@
+//! Event source for changes to files and directories.
+
 use std::{
 	collections::{HashMap, HashSet},
 	path::PathBuf,

lib/src/lib.rs

@@ -27,7 +27,7 @@
 pub mod error;
 pub mod event;
 pub mod fs;
-pub mod shell;
+pub mod command;
 pub mod signal;
 
 // the core experience

lib/src/signal.rs

@@ -1,3 +1,5 @@
+//! Event source for signals / notifications sent to the main process.
+
 use tokio::{select, sync::mpsc};
 use tracing::{debug, trace};