# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1676756919 -3600
# Node ID 97d131d6a09b1f351db7e1697065e89a64b737d8
# Parent  914dbfb7bcaaa67299838054b79eefa0e13c4e4a
Added various docstrings.

diff -r 914dbfb7bcaa -r 97d131d6a09b libexec/lib/src/process_creator.cc
--- a/libexec/lib/src/process_creator.cc	Sat Feb 18 01:30:37 2023 +0100
+++ b/libexec/lib/src/process_creator.cc	Sat Feb 18 22:48:39 2023 +0100
@@ -167,7 +167,8 @@
 }
 
 /* Initialise the region mapper with details of the payload program regions
-   and of the associated capabilities. */
+   and of the associated capabilities, configure the region mapper thread,
+   populate its stack, and start the thread. */
 
 long ProcessCreator::start_region_mapper()
 {
@@ -248,6 +249,9 @@
   return _process.thread_start(_rm_payload->entry_point(), rm_st);
 }
 
+/* Configure a thread for a program, populate its stack, and start the
+   thread. */
+
 long ProcessCreator::start_program(int argc, const char *argv[])
 {
   /* NOTE: Environment vector is currently not defined. */
@@ -275,6 +279,9 @@
   return _process.thread_start(_program_payload->entry_point(), program_st);
 }
 
+/* Start a new process for the given payload, providing the indicated program
+   arguments. */
+
 long ProcessCreator::start(file_t *file, int argc, const char *argv[])
 {
   long err;
@@ -306,6 +313,8 @@
   return start_program(argc, argv);
 }
 
+/* Set the given notifier on the system-level pager for a process. */
+
 void ProcessCreator::set_notifier(Notifier *notifier)
 {
   _exec_pager.set_notifier(notifier);