README.md: Config reference tidying

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/README.md b/README.md
index 8996a661ab4011855cb48b5abdec1a2df725129f..97ff6f1dd94f3efb0826af9b4f20afcb50624834 100644 (file)
--- a/README.md
+++ b/README.md
@@ -241,8 +241,9 @@ files.
 Source directories and packages (toplevel)
 ------------------------------------------
 
-Note that unlike everything else, these keys `packages` and `subdirs`
-are read only from `Cargo.nail` (see "Limitations and bugs", below).
+Note that unlike everything else, these keys (`packages` and
+`subdirs`) are read only from `Cargo.nail` (see "Limitations and
+bugs", below).
 
 These keys specify a combination of (i) a mapping from package name to
 source subdirectory (ii) a set of subdirectories whose `Cargo.toml`
@@ -262,9 +263,9 @@ must be massaged.
 
   * `subdirs`: a list of subdirectory names to process.
 
-    Each subdirectory's `Cargo.toml` will be massaged; also, the
-    subdirectory will be examined to see what package it contains and
-    it will be used as the source for that package, unless that
+    Each subdirectory's `Cargo.toml` will be massaged.  Also, the
+    subdirectory will be examined to see what package it contains; it
+    will then be used as the source for that package, unless that
     package appears in an entry in `packages`, or an earlier entry in
     `subdirs`.
 
@@ -272,7 +273,7 @@ must be massaged.
     ['myproject','mylibrary']`).  Or it can be single multi-line
     string containing one subdirectory name per line; in that
     case, `#`-comments are supported and tabs and spaces are ignored
-    (See "Most basic example usage" above.)
+    (see "Most basic example usage" above.)
 
 In each case the subdirectory should usually be a relative pathname;
 it is relative to the directory containing `Cargo.nail`.