[Scummvm-cvs-logs] SF.net SVN: scummvm:[40720] scummvm/trunk/engines/sci/engine/vm.h
fingolfin at users.sourceforge.net
fingolfin at users.sourceforge.net
Tue May 19 13:22:06 CEST 2009
Revision: 40720
http://scummvm.svn.sourceforge.net/scummvm/?rev=40720&view=rev
Author: fingolfin
Date: 2009-05-19 11:22:06 +0000 (Tue, 19 May 2009)
Log Message:
-----------
SCI: Doxygenified a few comments
Modified Paths:
--------------
scummvm/trunk/engines/sci/engine/vm.h
Modified: scummvm/trunk/engines/sci/engine/vm.h
===================================================================
--- scummvm/trunk/engines/sci/engine/vm.h 2009-05-19 02:10:58 UTC (rev 40719)
+++ scummvm/trunk/engines/sci/engine/vm.h 2009-05-19 11:22:06 UTC (rev 40720)
@@ -67,6 +67,9 @@
public:
virtual ~MemObject() {}
+ inline MemObjectType getType() const { return _type; }
+ inline int getSegMgrId() const { return _segmgrId; }
+
/**
* Dereferences a raw memory pointer.
* @param reg reference to dereference
@@ -75,30 +78,36 @@
*/
virtual byte *dereference(reg_t pointer, int *size);
- inline MemObjectType getType() const { return _type; }
- inline int getSegMgrId() const { return _segmgrId; }
-
- // Finds the canonic address associated with sub_reg
- // Parameters: (reg_t) sub_addr: The base address whose canonic address is to be found
- // For each valid address a, there exists a canonic address c(a) such that c(a) = c(c(a)).
- // This address "governs" a in the sense that deallocating c(a) will deallocate a.
+ /**
+ * Finds the canonic address associated with sub_reg.
+ *
+ * For each valid address a, there exists a canonic address c(a) such that c(a) = c(c(a)).
+ * This address "governs" a in the sense that deallocating c(a) will deallocate a.
+ *
+ * @param sub_addr base address whose canonic address is to be found
+ */
virtual reg_t findCanonicAddress(SegManager *segmgr, reg_t sub_addr) { return sub_addr; }
- // Deallocates all memory associated with the specified address
- // Parameters: (reg_t) sub_addr: The address (within the given segment) to deallocate
+ /**
+ * Deallocates all memory associated with the specified address.
+ * @param sub_addr address (within the given segment) to deallocate
+ */
virtual void freeAtAddress(SegManager *segmgr, reg_t sub_addr) {}
- // Iterates over and reports all addresses within the current segment
- // Parameters: note : (voidptr * addr) -> (): Invoked for each address on which free_at_address()
- // makes sense
- // (void *) param: Parameter passed to 'note'
+ /**
+ * Iterates over and reports all addresses within the current segment.
+ * @param note Invoked for each address on which free_at_address() makes sense
+ * @param param parameter passed to 'note'
+ */
virtual void listAllDeallocatable(SegmentId segId, void *param, NoteCallback note) {}
- // Iterates over all references reachable from the specified object
- // Parameters: (reg_t) object: The object (within the current segment) to analyse
- // (void *) param: Parameter passed to 'note'
- // note : (voidptr * addr) -> (): Invoked for each outgoing reference within the object
- // Note: This function may also choose to report numbers (segment 0) as adresses
+ /**
+ * Iterates over all references reachable from the specified object.
+ * @param object object (within the current segment) to analyse
+ * @param param parameter passed to 'note'
+ * @param note Invoked for each outgoing reference within the object
+ * Note: This function may also choose to report numbers (segment 0) as adresses
+ */
virtual void listAllOutgoingReferences(EngineState *s, reg_t object, void *param, NoteCallback note) {}
};
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
More information about the Scummvm-git-logs
mailing list