diff --git a/consensus/reactor.go b/consensus/reactor.go
index 27d1537ad..51f6f9902 100644
--- a/consensus/reactor.go
+++ b/consensus/reactor.go
@@ -296,7 +296,7 @@ func (conR *ConsensusReactor) SetEventSwitch(evsw types.EventSwitch) {
 	conR.conS.SetEventSwitch(evsw)
 }
 
-// FastSync returns whether the consensus reactor is currently fast syncing
+// FastSync returns whether the consensus reactor is in fast-sync mode.
 func (conR *ConsensusReactor) FastSync() bool {
 	conR.mtx.RLock()
 	defer conR.mtx.RUnlock()
diff --git a/rpc/core/pipe.go b/rpc/core/pipe.go
index 6c1930598..92e5746a6 100644
--- a/rpc/core/pipe.go
+++ b/rpc/core/pipe.go
@@ -28,6 +28,8 @@ type P2P interface {
 }
 
 //----------------------------------------------
+// These package level globals come with setters
+// that are expected to be called only once, on startup
 
 var (
 	// external, thread safe interfaces