morph.1.in | 34 +++++++++++++++++++++++++++++-----
1 file changed, 29 insertions(+), 5 deletions(-)
diff --git a/morph.1.in b/morph.1.in
index 38bff72..639f457 100644
@@ -23,7 +23,34 @@ Baserock is an embedded Linux system.
is its workflow tool.
It manages building binaries,
and branching and merging of the entire system.
-See the Baserock home page for more information.
+Morph is designed to turn collections of git repositories into system images
+using morphology files to define their dependencies.
+image is defined as a group of
+each of which comprises a series of
+, each of which in turn corresponds
+to an individual upstream project. For example, there might be a 'generic
+developer system' system morphology, containing a stratum for the basic
+bootable system and another for developer tools; the latter would then have
+individual chunks for make, gcc, binutils and so forth.
+A chunk is a git repository based on an individual upstream project's revision
+control system (converted into git if upstream does not already use it), which
+contains a branch named 'baserock', that both contains a JSON configuration file
+defining how to build the chunk and any other changes required to get the
+repository to build with the rest of Baserock.
+Morph is also capable of branching the whole system (that is branching all constituent
+git repositories of a system simultaneously) in order to allow system-wide changes that
+cross the boundaries of individual git repositories, and of generating commits to the
+group of git repositories that have been modified in such a branch.
+For more details, please see the Baserock wiki at http://wiki.baserock.org
@@ -87,7 +114,7 @@ sets the environment variable to
-looks for plugins additionally in the directories given in this variable.
+looks for additional plugins in the directories given in this variable.
Syntax is same as for
(i.e., colon delimited pathnames).
@@ -97,9 +124,6 @@ The
manual page has some more variables that affect
-This manual page is badly incomplete,
-but at least it should include all options correctly.
.SH "SEE ALSO"
.BR cliapp (5).