chore: better comments and cleanups

a3p-integration/proposals/p:upgrade-19/.gitignore

@@ -1,3 +1,2 @@
 replaceFeeDistributor/
 testUpgradedBoard/
-upgradeBoard/

a3p-integration/proposals/p:upgrade-19/eval.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# add gov4 address
+# evaluate the proposals in the /submission/ directory
 
 echo "UPGRADE-19  Running proposal declared in package.json"
 # copy to run in the proposal package so the dependencies can be resolved

a3p-integration/proposals/p:upgrade-19/upgradedBoard.test.js

@@ -8,6 +8,7 @@ import test from 'ava';
 import { evalBundles } from '@agoric/synthetic-chain';
 
 test('test upgraded board', async t => {
+  // agoricProposal.sdk-generate in package.json generates this proposal
   await evalBundles('testUpgradedBoard');
 
   t.pass();

packages/builders/scripts/testing/replace-feeDistributor-short.js

@@ -1,6 +1,12 @@
 import { makeHelpers } from '@agoric/deploy-script-support';
 import { getManifestForReplaceFeeDistributor } from '@agoric/inter-protocol/src/proposals/replace-fee-distributor.js';
 
+/**
+ * @file
+ * a Variant of ../inter-protocol/replace-feeDistributor.js that shortens the
+ * collectionInterval for testing
+ */
+
 /** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
 export const defaultProposalBuilder = async (_, opts) => {
   console.log('feeDist  OPTS', opts);

packages/vats/src/proposals/testUpgradedBoard.js

@@ -12,13 +12,13 @@ export const testUpgradedBoard = async ({
   const thing1Id = await E(board).getId(thing1);
   assert(thing1Id.match(/^board0[0-9]+$/));
 
-  // /////// can we retrieve something stored long ago?  ////////
   const marshaller = await E(board).getReadonlyMarshaller();
   assert(marshaller, 'expected a marshaller');
 
   const stableBrand = await stableBrandP;
   // /////// can we retrieve a well-known object via its ID?  ////////
   const stableID = await E(board).getId(stableBrand);
+  // /////// can we retrieve something stored long ago?  ////////
   const stableBrandRetrieved = await E(board).getValue(stableID);
   assert(stableBrandRetrieved === stableBrand, 'retrieved matching brand');
 };