From 499ca1ff23dc47629151da63c4e29610f0241e36 Mon Sep 17 00:00:00 2001
From: David Glasser <glasser@meteor.com>
Date: Fri, 27 Jun 2014 14:24:07 -0700
Subject: [PATCH] Extra comment about catalog initiatialization

---
 tools/main.js | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tools/main.js b/tools/main.js
index 497967b32f..898b411b39 100644
--- a/tools/main.js
+++ b/tools/main.js
@@ -647,6 +647,13 @@ Fiber(function () {
     catalog.official.initialize({
       offline: !!process.env.METEOR_OFFLINE_CATALOG
     });
+
+    // So to be explicit: at this point, catalog.complete reflects whatever was
+    // in data.json when we started up (no sync with the server), and
+    // catalog.official is EMPTY.  Calling catalog.official.refresh() will sync
+    // with the server (unless offline) and then load from data.json;
+    // catalog.complete.refresh() will re-sync with data.json (eg, if we just
+    // refreshed catalog.official).
   });
   if (messages.hasMessages()) {
     process.stderr.write("=> Errors while scanning packages:\n\n");