From ed41139096014a8e4d890cc55d7112ea946fd076 Mon Sep 17 00:00:00 2001
From: Emery Hemingway <emery@vfemail.net>
Date: Thu, 25 Aug 2016 13:14:48 +0200
Subject: [PATCH] documentation improvements for 16.08

---
 src/server/fb_upscale/README   |  5 ++---
 src/server/rom_fallback/README | 19 ++++++++++++-------
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/src/server/fb_upscale/README b/src/server/fb_upscale/README
index 7fff9e6..1d11421 100644
--- a/src/server/fb_upscale/README
+++ b/src/server/fb_upscale/README
@@ -1,4 +1,3 @@
 The 'fb_upscale' server scales a fixed-resolution framebuffer client session
-to a larger parent framebuffer session. The scaling is linear at a ratio of
-1:1 across the x and y axis. Clients must supply their native resolution at
-the time of session creation.
+to a larger parent framebuffer session. The scaling is linear across height and
+and width. Clients must supply their native resolution at the time of session creation.
diff --git a/src/server/rom_fallback/README b/src/server/rom_fallback/README
index 19180ef..83d5fe1 100644
--- a/src/server/rom_fallback/README
+++ b/src/server/rom_fallback/README
@@ -1,17 +1,22 @@
-Rom_fallback serves ROM sessions by opening sessions at its parent
-using a list of labels, returning the first successfully opened sessions.
+Rom_fallback serves ROM sessions by opening sessions at its parent using
+a list of labels and returning the first successfully opened session.
 
-In the following configuration example an attempt is made to forwarded a
-session from the parent before the sibling 'fs_rom'.
+In the following configuration example an attempt is made to forward
+sessions from the parent with a fallback at the sibling 'fs_rom'.
 ! <start name="rom_fallback">
 !   <.../>
 !   <config>
-!     <fallback/>
+!     <fallback/> <!-- no label prefix -->
 !     <fallback label="fs"/>
 !   </config>
 !   <route>
-!     <service name="ROM" label_prefix="fs ->">
+!
+!     <service name="ROM" label_prefix="fs ->"> <!-- prefixed route -->
 !       <child name="fs_rom"/> </service>
-!     <any-service> <parent/> </any-service>
+!
+!     <service name="ROM"> <!-- default route -->
+!       <parent/> </service>
+!
+!     <.../>
 !   </route>
 ! </start>