commit 0497fa91cf3896d848576a2845f7300fff63b9fc
parent 01aa8f4f7983ccd75a26a1056534e953e52f5624
Author: Drew DeVault <sir@cmpwn.com>
Date: Sat, 4 Dec 2021 21:10:45 +0100
docs/modules.md: improve use of "module root"
Signed-off-by: Drew DeVault <sir@cmpwn.com>
Diffstat:
1 file changed, 8 insertions(+), 8 deletions(-)
diff --git a/docs/modules.md b/docs/modules.md
@@ -53,14 +53,14 @@ in a Hare identifier.
## Locating modules on the filesystem
-Each module, identified by its namespace, is organized into "root" directory,
-where all of its source files may be found, either as members or descendants.
-This directory corresponds to a file path which is formed by replacing the
-namespace delimiters (`::`) with the path separator for the target host system
-(e.g. `/`). This forms a relative path, which is then applied to each of several
-possible **source roots**.
-
-A source root is a directory which forms the root of a hierarchy of Hare modules
+Each module, identified by its namespace, is organized into a "**module root**"
+directory, where all of its source files may be found, either as members or
+descendants. This directory corresponds to a file path which is formed by
+replacing the namespace delimiters (`::`) with the path separator for the target
+host system (e.g. `/`). This forms a relative path, which is then applied to
+each of several possible **source roots**.
+
+A source root is a directory which forms the top of a hierarchy of Hare modules
and their sources. This directory may also itself be a module, namely the **root
module**: it provides the unit for the empty namespace, where, for example, the
"main" function can be found. Generally speaking, there will be at least two