Reformat annotations in preparation for automated extraction

This commit is contained in:
Vinnie Falco
2013-06-07 14:46:09 -07:00
parent 6d8ee90a8d
commit a6fdabc68a
89 changed files with 192 additions and 192 deletions

View File

@@ -1,7 +1,7 @@
#ifndef RIPPLE_FIELDNAMES_H
#define RIPPLE_FIELDNAMES_H
// VFALCO: TODO, lose the macro.
// VFALCO TODO lose the macro.
#define FIELD_CODE(type, index) ((static_cast<int>(type) << 16) | index)
enum SerializedTypeID
@@ -23,7 +23,7 @@ enum SerializedTypeID
STI_VALIDATION = 10003,
};
// VFALCO: TODO, rename this to NamedField
// VFALCO TODO rename this to NamedField
class SField
{
public:
@@ -104,7 +104,7 @@ public:
static int compare(SField::ref f1, SField::ref f2);
// VFALCO: TODO, make these private
// VFALCO TODO make these private
protected:
static std::map<int, ptr> codeToField;
static boost::mutex mapMutex;

View File

@@ -3,7 +3,7 @@ std::map <int, LedgerEntryFormat*> LedgerEntryFormat::byType;
std::map <std::string, LedgerEntryFormat*> LedgerEntryFormat::byName;
// VFALCO: TODO, surely we can think of a better way than macros?
// VFALCO TODO surely we can think of a better way than macros?
#define LEF_BASE \
<< SOElement(sfLedgerIndex, SOE_OPTIONAL) \

View File

@@ -25,7 +25,7 @@ public:
/** Retrieve the packed message data.
*/
// VFALCO: TODO, shouldn't this be const?
// VFALCO TODO shouldn't this be const?
std::vector <uint8_t>& getBuffer()
{
return mBuffer;

View File

@@ -1,6 +1,6 @@
// VFALCO: TODO, remove this when it's safe to do so.
// VFALCO TODO remove this when it's safe to do so.
#ifdef __APPLICATION__
#error Including Application.h is disallowed!
#endif

View File

@@ -3,7 +3,7 @@
/** Protocol specific constant globals.
*/
// VFALCO: NOTE, use these from now on instead of the macros!!
// VFALCO NOTE use these from now on instead of the macros!!
class RippleSystem
{
public:
@@ -28,7 +28,7 @@ public:
}
};
// VFALCO: TODO, I would love to replace these macros with the language
// VFALCO TODO I would love to replace these macros with the language
// constructs above. The problem is the way they are used at
// the point of call, i.e. "User-agent:" SYSTEM_NAME
// It will be necessary to rewrite some of them to use string streams.

View File

@@ -186,7 +186,7 @@ public:
const vector& getValue() const { return value; }
vector& getValue() { return value; }
// VFALCO: NOTE as long as we're married to boost why not use boost::iterator_facade?
// VFALCO NOTE as long as we're married to boost why not use boost::iterator_facade?
//
// vector-like functions
void push_back(const STObject& object) { value.push_back(object.oClone().release()); }

View File

@@ -5,7 +5,7 @@
/** Flags for elements in a SerializedObjectTemplate.
*/
// VFALCO: NOTE, these don't look like bit-flags...
// VFALCO NOTE these don't look like bit-flags...
enum SOE_Flags
{
SOE_INVALID = -1,

View File

@@ -1,7 +1,7 @@
#ifndef RIPPLE_SERIALIZEDTYPES_H
#define RIPPLE_SERIALIZEDTYPES_H
// VFALCO: TODO, fix this restriction on copy assignment.
// VFALCO TODO fix this restriction on copy assignment.
//
// CAUTION: Do not create a vector (or similar container) of any object derived from
// SerializedType. Use Boost ptr_* containers. The copy assignment operator of
@@ -25,12 +25,12 @@ enum PathFlags
PF_ISSUE = 0x80,
};
// VFALCO: TODO, make these non static or otherwise clean constants.
// VFALCO TODO make these non static or otherwise clean constants.
static const uint160 u160_zero(0), u160_one(1);
static inline const uint160& get_u160_zero() { return u160_zero; }
static inline const uint160& get_u160_one() { return u160_one; }
// VFALCO: TODO, replace these with language constructs, gah!
// VFALCO TODO replace these with language constructs, gah!
#define CURRENCY_XRP get_u160_zero()
#define CURRENCY_ONE get_u160_one() // Used as a place holder.
#define CURRENCY_BAD uint160(0x5852500000000000) // Do not allow XRP as an IOU currency.
@@ -79,7 +79,7 @@ public:
virtual bool isDefault() const { return true; }
protected:
// VFALCO: TODO, make accessors for this
// VFALCO TODO make accessors for this
SField::ptr fName;
private:
@@ -476,7 +476,7 @@ private:
}
};
// VFALCO: TODO Make static member accessors for these in STAmount
// VFALCO TODO Make static member accessors for these in STAmount
extern const STAmount saZero;
extern const STAmount saOne;
@@ -631,7 +631,7 @@ private:
class STPathElement
{
private:
// VFALCO: Remove these friend declarations
// VFALCO Remove these friend declarations
friend class STPathSet;
friend class STPath;
friend class Pathfinder;

View File

@@ -1,11 +1,11 @@
#ifndef RIPPLE_TER_H
#define RIPPLE_TER_H
// VFALCO: TODO do not use auto-incrementing. Explicitly assign each
// VFALCO TODO do not use auto-incrementing. Explicitly assign each
// constant so there is no possibility of someone coming in
// and screwing it up.
//
// VFALCO: TODO, consider renaming TER to TxErr or TxResult for clarity.
// VFALCO TODO consider renaming TER to TxErr or TxResult for clarity.
//
enum TER // aka TransactionEngineResult
{
@@ -17,7 +17,7 @@ enum TER // aka TransactionEngineResult
// - Not forwarded
// - No fee check
telLOCAL_ERROR = -399,
telBAD_DOMAIN, // VFALCO: TODO, should read "telBAD_DOMAIN = -398," etc...
telBAD_DOMAIN, // VFALCO TODO should read "telBAD_DOMAIN = -398," etc...
telBAD_PATH_COUNT,
telBAD_PUBLIC_KEY,
telFAILED_PROCESSING,
@@ -143,7 +143,7 @@ enum TER // aka TransactionEngineResult
tecUNFUNDED = 129, // Deprecated, old ambiguous unfunded.
};
// VFALCO: TODO, change these to normal functions.
// VFALCO TODO change these to normal functions.
#define isTelLocal(x) ((x) >= telLOCAL_ERROR && (x) < temMALFORMED)
#define isTemMalformed(x) ((x) >= temMALFORMED && (x) < tefFAILURE)
#define isTefFailure(x) ((x) >= tefFAILURE && (x) < terRETRY)
@@ -151,7 +151,7 @@ enum TER // aka TransactionEngineResult
#define isTesSuccess(x) ((x) == tesSUCCESS)
#define isTecClaim(x) ((x) >= tecCLAIM)
// VFALCO: TODO, group these into a shell class along with the defines above.
// VFALCO TODO group these into a shell class along with the defines above.
extern bool transResultInfo (TER terCode, std::string& strToken, std::string& strHuman);
extern std::string transToken (TER terCode);
extern std::string transHuman (TER terCode);

View File

@@ -3,7 +3,7 @@ std::map<int, TransactionFormat*> TransactionFormat::byType;
std::map<std::string, TransactionFormat*> TransactionFormat::byName;
// VFALCO: TODO, surely we can think of a better way than to use macros??
// VFALCO TODO surely we can think of a better way than to use macros??
#define TF_BASE \
<< SOElement(sfTransactionType, SOE_REQUIRED) \
<< SOElement(sfFlags, SOE_OPTIONAL) \