From e4048bc279a49d52fdd273658305f671e8460f46 Mon Sep 17 00:00:00 2001
From: Matt Birkholz <matt@birchwood-abbey.net>
Date: Sun, 23 Apr 2017 11:02:55 -0700
Subject: [PATCH] Give example (Ubuntu) developer packages for a few plugin
 READMEs.

---
 src/cairo/README | 14 ++++++++++----
 src/gl/README    | 12 +++++++++---
 src/glib/README  | 16 +++++++++++-----
 src/gtk/README   | 18 ++++++++++++------
 src/pango/README | 18 ++++++++++++------
 5 files changed, 54 insertions(+), 24 deletions(-)

diff --git a/src/cairo/README b/src/cairo/README
index 65c17aebf..f529ae6de 100644
--- a/src/cairo/README
+++ b/src/cairo/README
@@ -2,18 +2,24 @@
 
 The Cairo vector graphics plugin.
 
-To build and install:
+This plugin wraps the Cairo library, so the developers' package needs
+to be installed.  On an Ubuntu system, you might run a commandline
+like this:
+
+    sudo apt-get install libcairo2-dev
+
+Then to build and install the plugin:
 
     ./configure
     make all check
     make install install-html
 
-To use:
+To use the plugin:
 
-    (load-option 'CAIRO)
+    (load-option 'cairo)
     (cairo-image-surface-create 500 500)
 
-To import into a CREF package set (.pkg file):
+To import the plugin's bindings into a CREF package set (.pkg file):
 
     (global-definitions cairo/)
 
diff --git a/src/gl/README b/src/gl/README
index e305fdf01..7a8def22a 100644
--- a/src/gl/README
+++ b/src/gl/README
@@ -2,17 +2,23 @@
 
 The OpenGL/GLU/GLX 3D graphics plugin.
 
-To build and install:
+This plugin wraps the Mesa/OpenGL libraries, so their developers'
+packages need to be installed.  On an Ubuntu system, you might run a
+commandline like this:
+
+    sudo apt-get install libgl1-mesa-dev libglu1-mesa-dev
+
+Then to build and install the plugin:
 
     ./configure
     make all check
     make install
 
-To use:
+To use the plugin:
 
     (load-option 'GL)
     (make-glxgears-demo)
 
-To import into a CREF package set (.pkg file):
+To import the plugin's bindings into a CREF package set (.pkg file):
 
     (global-definitions gl/)
diff --git a/src/glib/README b/src/glib/README
index af3549524..c378b1fe4 100644
--- a/src/glib/README
+++ b/src/glib/README
@@ -1,19 +1,25 @@
 -*-Text-*-
 
-The GLib GNOME utility library plugin.
+The GLib (GNOME utility Library) plugin.
 
-To build and install:
+This plugin wraps the Glib library, so the developers' package needs
+to be installed.  On an Ubuntu system, you might run a commandline
+like this:
+
+    sudo apt-get install libglib2.0-dev
+
+Then to build and install the plugin:
 
     ./configure
     make all check
     make install install-html
 
-To use:
+To use the plugin:
 
-    (load-option 'GLIB)
+    (load-option 'glib)
     (open-input-gfile "https://savannah.gnu.org/projects/mit-scheme")
 
-To import into a CREF package set (.pkg file):
+To import the plugin's bindings into a CREF package set (.pkg file):
 
     (global-definitions glib/)
 
diff --git a/src/gtk/README b/src/gtk/README
index b7f199b53..ca43bc320 100644
--- a/src/gtk/README
+++ b/src/gtk/README
@@ -4,8 +4,8 @@ The GNOME toolkits plugin.
 
 The good news first: this plugin provides specialized Gtk+ widget
 types that inherit the gesture and kinetic scrolling support in
-GtkScrolledWindow.  Thus a Scheme canvas can be scrolled like any
-other widget.
+GtkScrolledWindow.  Thus a Scheme canvas can be scrolled like other
+widgets.
 
 The bad news: Edwin requires these specialized widget types.
 GtkScrolledWindow and GtkPaned do not suffice.  The specialized types
@@ -30,18 +30,24 @@ Unfortunately, implementing both GtkScrolledWindow and GtkScrolledView
 without duplicating a lot of code makes this a less-than-simple
 extension of Gtk+.
 
-To build and install:
+This plugin wraps the Gtk+ library, so the developers' package needs
+to be installed.  On an Ubuntu system, you might run a commandline
+like this:
+
+    sudo apt-get install libgtk-3-dev
+
+Then to build and install the plugin:
 
     ./configure
     make all check
     make install install-html
 
-To use:
+To use the plugin:
 
-    (load-option 'GTK)
+    (load-option 'gtk)
     (make-fix-layout-demo)
 
-To import into a CREF package set (.pkg file):
+To import the plugin's bindings into a CREF package set (.pkg file):
 
     (global-definitions gtk/)
 
diff --git a/src/pango/README b/src/pango/README
index 99dda3c5e..7f8493dee 100644
--- a/src/pango/README
+++ b/src/pango/README
@@ -1,19 +1,25 @@
 -*-Text-*-
 
-The PANGO text layout plugin.
+The Pango text layout plugin.
 
-To build and install:
+This plugin wraps the Pango library, so the developers' package needs
+to be installed.  On an Ubuntu system, you might run a commandline
+like this:
 
-    ./configure [--with-pango=directory]
+    sudo apt-get install libpango1.0-dev
+
+Then to build and install the plugin:
+
+    ./configure
     make all check
     make install install-html
 
-To use:
+To use the plugin:
 
-    (load-option 'PANGO)
+    (load-option 'pango)
     (pango-font-description-from-string "helvetical bold 12")
 
-To import into a CREF package set (.pkg file):
+To import the plugin's bindings into a CREF package set (.pkg file):
 
     (global-definitions pango/)
 
-- 
2.25.1