[or-cvs] r16710: {updater} other cleanups while reading through it (updater/trunk/specs)

[arma@xxxxxxxx]

Author: arma
Date: 2008-08-31 20:47:45 -0400 (Sun, 31 Aug 2008)
New Revision: 16710

Modified:
   updater/trunk/specs/U2-formats.txt
Log:
other cleanups while reading through it


Modified: updater/trunk/specs/U2-formats.txt
===================================================================
--- updater/trunk/specs/U2-formats.txt	2008-08-31 23:54:53 UTC (rev 16709)
+++ updater/trunk/specs/U2-formats.txt	2008-09-01 00:47:45 UTC (rev 16710)
@@ -78,7 +78,7 @@
 
    A "package" is a single independent downloadable, installable
    binary archive.  It could be an MSI, an RPM, a DMG, or so on.
-   Every package is compiled version of some version of some piece of
+   Every package is a compiled instance of some piece of
    software (an 'application') for some (os, architecture,
    version) combinations.  Some packages are "glue" that make other
    packages work well together or get configured properly.
@@ -102,7 +102,7 @@
 
 Architecture: Roles
 
-   Every role in the system are associated with a key.  Replacing
+   Every role in the system is associated with a key.  Replacing
    anything but a root key is supposed to be relatively easy.
 
    Root-keys sign other keys, and certify them as belonging to roles.
@@ -155,7 +155,7 @@
 
     /packages/packagename/os-arch/version/(some filename)
 
-         The actual files 
+         The actual files   [XXX finish sentence]
 
 File formats: general principles
 
@@ -187,7 +187,7 @@
           (signature ({(keyid K) (method M) (ATTR VAL)*}) SIG)+
        )
 
-   where: X is a list whose fist element describes the signed object.
+   where: X is a list whose first element describes the signed object.
           K is the identifier of a key signing the document
           M is the method to be used to make the signature
           (ATTR VAL) is an arbitrary list whose first element is a
@@ -283,7 +283,7 @@
   elements of the order element are numbers defining the order in
   which the packages are installed, updated, and removed respectively.
   The "optional" element is present if the package is optional.
-  "Gloss" is an short utf-8 human-readable string explaining what the
+  "Gloss" is a short utf-8 human-readable string explaining what the
   package provides for the bundle; "longloss" is a longer such
   utf-8 string.
 
@@ -292,6 +292,9 @@
   example, "The Anonymous Email Bundle needs the Python Runtime to run
   Mixminion.")
 
+  [XXX consider translated strings here, if the gloss strings are ever
+   meant to be shown to users. -RD]
+
 File formats: package files
   (package
     ({(name NAME)
@@ -420,7 +423,7 @@
   mirror keys should be stored encrypted.
 
   All the formats above allow for multiple keys to sign a single
-  document.  To replace a compromised master key, it suffices to sign
+  document.  To replace a compromised root key, it suffices to sign
   keylist documents with both the compromised key and its replacement
   until all clients have updated to a new version of the autoupdater.