Move from TODO to documentation, fix missing DNSError.

Signed-off-by: Edward Z. Yang <ezyang@mit.edu>

diff --git a/TODO b/TODO
index a785257155416a28204575f748c5585aec9a8fe1..4781ad092ad6d5940fd81d1d14578fb2b9e95e9c 100644 (file)
--- a/TODO
+++ b/TODO
@@ -78,21 +78,6 @@ GIT COMMIT FIELDS:
 Committer: Real Name <username@mit.edu>
 Author: lockername locker <lockername@scripts.mit.edu>
 
-NOTES:
-
-[ XXX: upgrade.rst ]
-
-- It is not required nor expected for update scripts to exist for all
-  intervening versions that were present pre-migration; only for it
-  to work on the most recent migration.
-
-[ XXX: repo.rst ]
-
-- Currently all repositories are initialized with --shared, which
-  means they have basically ~no space footprint.  However, it
-  also means that /mit/scripts/wizard/srv MUST NOT lose revs after
-  deployment.
-
 OVERALL PLAN:
 
 [ XXX: doc/deps.rst ]
@@ -126,7 +111,7 @@ OVERALL PLAN:
 
    12. Run parallel-find.pl to update our inventory
 
-[ XXX: doc/layout.rst ]
+[ XXX: doc/metadata.rst ]
 * The repository for a given application will contain the following files:
 
     - The actual application's files, as from the official tarball

diff --git a/doc/module/wizard.util.rst b/doc/module/wizard.util.rst
index c4596297c1c2a7b32dcbe593a93afa0104952f6c..cba7f347791bbd7796d5625af700a811bb3e36a2 100644 (file)
--- a/doc/module/wizard.util.rst
+++ b/doc/module/wizard.util.rst
@@ -42,3 +42,5 @@ Exceptions
     :show-inheritance:
 .. autoexception:: PermissionsError
     :show-inheritance:
+.. autoexception:: DNSError
+    :show-inheritance:

diff --git a/doc/repo.rst b/doc/repo.rst
index b4dc8764eda82e3f328efe85a1f28911418b2272..5f4ce8263e85cff74bb38fb4802df6d29c02827f 100644 (file)
--- a/doc/repo.rst
+++ b/doc/repo.rst
@@ -123,3 +123,8 @@ the commit generated when the install took place and the user's
 specific configuration was versioned.  ``y`` was the pre-upgrade
 commit generated so that we could then perform a merge; ``x`` is
 the resulting merge commit.
+
+All user repositories are initialized with ``--shared``, which means
+they take no space footprint at the very beginning.  However, this also
+makes it vitally important that the canonical repository in the scripts
+locker not lose revisions.

diff --git a/doc/upgrade.rst b/doc/upgrade.rst
index f748ecde7863c7ce006f275233d7aafadbbb4fc6..259577d0fcb885b762b78f3b508e9409a37408e4 100644 (file)
--- a/doc/upgrade.rst
+++ b/doc/upgrade.rst
@@ -112,6 +112,12 @@ Finally, :meth:`~wizard.app.Application.upgrade` actually performs an upgrade,
 and will most frequently call a shell script or fetches a web page that will
 perform a schema upgrade.
 
+.. note::
+
+    When migrating an old-style autoinstall, it is neither expected nor
+    required for upgrade scripts for the intervening versions to be
+    created.
+
 Troubleshooting
 ---------------