# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1630273908 -7200
# Node ID fc8b3fb6acce0cfba921fe3d1b2c991fe14d4bfd
# Parent  23412250df9b9a524f823a4dcd373d7b9c4fb693
Added accompanying prose for the diagram.

diff -r 23412250df9b -r fc8b3fb6acce docs/wiki/Components
--- a/docs/wiki/Components	Sun Aug 29 19:48:42 2021 +0200
+++ b/docs/wiki/Components	Sun Aug 29 23:51:48 2021 +0200
@@ -13,6 +13,11 @@
 document are described using excerpts from the appropriate interface
 descriptions.
 
+== Overview ==
+
+An overview of the component interactions involved in opening a file is
+provided by the diagram below.
+
 ######## A graph showing the interactions between components
 
 {{{#!graphviz
@@ -74,6 +79,16 @@
 
 ########
 
+In pseudocode, the operations as conducted by the client program are as
+follows:
+
+{{{
+opener = filesystem.open_for_user(user)
+context = opener.context()
+context.write("filename") # this being a memory access operation
+file = context.open(flags, ...)
+}}}
+
 == Filesystems ==
 
 Filesystems implement the `Filesystem` interface which provides the