From: Edward Z. Yang Date: Wed, 3 Mar 2010 06:12:37 +0000 (-0500) Subject: Move from TODO to documentation, fix missing DNSError. X-Git-Url: https://scripts.mit.edu/gitweb/wizard.git/commitdiff_plain/6727d7bb8ee58e9a30927947149919f64cfd8fa5 Move from TODO to documentation, fix missing DNSError. Signed-off-by: Edward Z. Yang --- diff --git a/TODO b/TODO index a785257..4781ad0 100644 --- a/TODO +++ b/TODO @@ -78,21 +78,6 @@ GIT COMMIT FIELDS: Committer: Real Name Author: lockername locker -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 c459629..cba7f34 100644 --- 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 b4dc876..5f4ce82 100644 --- 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 f748ecd..259577d 100644 --- 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 ---------------