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.