Document CWalletTx::FindMyNotes

Part of #1447

src/wallet/wallet.cpp

@@ -1117,6 +1117,14 @@ void CWallet::EraseFromWallet(const uint256 &hash)
 }
 
 
+/**
+ * Finds all output notes in the given transaction that have been sent to
+ * PaymentAddresses in this wallet.
+ *
+ * It should never be necessary to call this method with a CWalletTx, because
+ * the result of FindMyNotes (for the addresses available at the time) will
+ * already have been cached in CWalletTx.mapNoteData.
+ */
 mapNoteData_t CWallet::FindMyNotes(const CTransaction& tx) const
 {
     LOCK(cs_SpendingKeyStore);