More manual

src/SUMMARY.md

@@ -12,12 +12,13 @@
 
 - [System overview](./operation/index.md)
 - [The System Bus: syndicate-server](./operation/system-bus.md)
-  - [Bus scripting language](./operation/scripting.md)
+  - [Services and service dependencies](./operation/service.md)
   - [Built-in services and service classes](./operation/builtin/index.md)
     - [Gatekeeper](./operation/builtin/gatekeeper.md)
     - [TCP/IP and Unix-socket Transports](./operation/builtin/relay-listener.md)
     - [Configuration watcher](./operation/builtin/config-watcher.md)
-    - [Process supervision and management](./operation/builtin/daemon.md)
+    - [Daemons and external programs](./operation/builtin/daemon.md)
+  - [Configuration scripting language](./operation/scripting.md)
 - [Configuration files and directories]()
   - [The boot layer]()
     - [Logging]()

src/glossary.md

@@ -3,9 +3,9 @@
 ## Actor
 ## Assertion
 ## Attenuation
-## Bus Scripting Language
 ## Capability
 ## Compositional
+## Configuration Scripting Language
 ## Conversational State
 ## Dataspace
 ## E

src/operation/builtin/index.md

@@ -1 +1,3 @@
 # Built-in services and service classes
+
+The `syndicate-server` program 

src/operation/index.md

@@ -7,7 +7,6 @@ tree](../glossary.md#supervision-tree), conceptually rooted at the [system
 bus](./system-bus.md) (NB. not at PID 1).
 
 ```ditaa system-supervision-tree
-(Example)
               +----------------------------------+
               |Root System Bus (syndicate–server)|
               +----------------+-----------------+

src/operation/scripting.md

@@ -1 +1 @@
-# Bus scripting language
+# Configuration scripting language

src/operation/service.md

@@ -0,0 +1 @@
+# Services and service dependencies

src/operation/system-bus.md

@@ -6,26 +6,36 @@
 The `syndicate-server` program has a number of closely-related functions. In many ways, it is a
 reification of the [system layer concept](../glossary.md#system-layer) itself.
 
- 1. It provides a root **system bus** service for use by other programs. In this way, it is
+It provides:
+
+ 1. A **[root system bus](#the-root-system-bus)** service for use by other programs. In this way, it is
     analogous to D-Bus.
 
- 2. It provides a [**gatekeeper** service](./builtin/gatekeeper.md), for exposing
+ 2. A general-purpose **[service dependency tracking facility](./service.md)**.
+
+ 3. A [**gatekeeper** service](./builtin/gatekeeper.md), for exposing
     [capabilities](../glossary.md#capability) to running objects as (potentially long-lived)
     [macaroon](../glossary.md#macaroon)-style "sturdy references", plus TCP/IP- and
     Unix-socket-based **[transports](./builtin/relay-listener.md)** for accessing capabilities
     through the gatekeeper.
 
- 3. It provides a limited **[configuration scripting language](./scripting.md)** suitable for
+ 4. A limited **[configuration scripting language](./scripting.md)** suitable for
     programming [dataspaces](../glossary.md#dataspace) with simple reactive behaviours.
 
- 4. It provides an [`inotify`](https://en.wikipedia.org/wiki/Inotify)-based **[configuration
+ 5. An [`inotify`](https://en.wikipedia.org/wiki/Inotify)-based **[configuration
     loader](./builtin/config-watcher.md)** which loads and executes configuration files written
     in the scripting language.
 
- 5. It provides [**process supervision** and **dependency tracking**](./builtin/daemon.md)
-    services for starting other programs.
+ 6. [**Process startup and supervision**](./builtin/daemon.md)
+    services for running external programs.
 
-## The main system bus
+The program can also be used as an "inferior" bus. For example, there may be a per-user bus, or
+a per-session bus, or both. Each bus would appropriately scope the lifetime of its supervised
+processes.
+
+Finally, it can be used completely standalone, outside a Synit context.
+
+## The root system bus
 
 The [`synit-pid1`](./index.md#sbinsynit-pid1) program invokes `syndicate-server` like this: