Alex's review

Signed-off-by: Miguel Ojeda <[email protected]>

Author: ojeda

Documentation/rust/quick-start.rst

@@ -8,7 +8,7 @@ This document describes how to get started with Rust kernel development.
 Requirements
 ------------
 
-A nightly Rust toolchain (at least ``rustc``, ``cargo`` and ``rustfmt``) is required. In the future, this restriction will be lifted. If you are using ``rustup``, run::
+A recent nightly Rust toolchain (at least ``rustc``, ``cargo`` and ``rustfmt``) is required, e.g. `nightly-2020-08-27`. In the future, this restriction will be lifted. If you are using ``rustup``, run::
 
     rustup toolchain install nightly
 

rust/kernel/src/filesystem.rs

@@ -1,5 +1,7 @@
 // SPDX-License-Identifier: GPL-2.0
 
+// TODO: `filesystem` is really incomplete -- deletion to be considered
+
 use alloc::boxed::Box;
 use core::default::Default;
 use core::marker;

rust/kernel/src/lib.rs

@@ -51,6 +51,8 @@ macro_rules! kernel_module {
     ($module:ty, $($name:ident : $value:expr),*) => {
         static mut __MOD: Option<$module> = None;
 
+        // Built-in modules are initialized through an initcall pointer
+        //
         // TODO: find a proper way to emulate the C macro, including
         // dealing with `HAVE_ARCH_PREL32_RELOCATIONS`
         #[cfg(not(module))]