thirdparty/scummvm
2
0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

SCI: Clarify docs of GC related SegmentObj methods

Browse source 
svn-id: r50440
This commit is contained in:
Max Horn 2010-06-28 12:28:29 +00:00
parent b3011faaef
commit 4f606cc10d
2 changed files with 15 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

6
engines/sci/engine/script.h
View file

@ -107,6 +107,12 @@ public:
virtual Common::Array<reg_t> listAllDeallocatable(SegmentId segId) const; virtual Common::Array<reg_t> listAllDeallocatable(SegmentId segId) const;
virtual Common::Array<reg_t> listAllOutgoingReferences(reg_t object) const; virtual Common::Array<reg_t> listAllOutgoingReferences(reg_t object) const;
/**
* Return a list of all references to objects in this script
* (and also to the locals segment, if any).
* Used by the garbage collector.
* @return a list of outgoing references within the object
*/
Common::Array<reg_t> listObjectReferences() const; Common::Array<reg_t> listObjectReferences() const;
virtual void saveLoadWithSerializer(Common::Serializer &ser); virtual void saveLoadWithSerializer(Common::Serializer &ser);

14
engines/sci/engine/segment.h
View file

@ -105,6 +105,7 @@ public:
/** /**
* Finds the canonic address associated with sub_reg. * Finds the canonic address associated with sub_reg.
* Used by the garbage collector.
* *
* For each valid address a, there exists a canonic address c(a) such that c(a) = c(c(a)). * 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. * This address "governs" a in the sense that deallocating c(a) will deallocate a.
@ -115,14 +116,15 @@ public:
/** /**
* Deallocates all memory associated with the specified address. * Deallocates all memory associated with the specified address.
* Used by the garbage collector.
* @param sub_addr address (within the given segment) to deallocate * @param sub_addr address (within the given segment) to deallocate
*/ */
virtual void freeAtAddress(SegManager *segMan, reg_t sub_addr) {} virtual void freeAtAddress(SegManager *segMan, reg_t sub_addr) {}
/** /**
* Iterates over and reports all addresses within the current segment. * Iterates over and reports all addresses within the segment.
* @param note Invoked for each address on which free_at_address() makes sense * Used by the garbage collector.
* @param param parameter passed to 'note' * @return a list of addresses within the segment
*/ */
virtual Common::Array<reg_t> listAllDeallocatable(SegmentId segId) const { virtual Common::Array<reg_t> listAllDeallocatable(SegmentId segId) const {
return Common::Array<reg_t>(); return Common::Array<reg_t>();
@ -130,9 +132,11 @@ public:
/** /**
* Iterates over all references reachable from the specified object. * Iterates over all references reachable from the specified object.
* Used by the garbage collector.
* @param object object (within the current segment) to analyse * @param object object (within the current segment) to analyse
* @return refs a list of outgoing references within the object * @return a list of outgoing references within the object
* Note: This function may also choose to report numbers (segment 0) as adresses *
* @note This function may also choose to report numbers (segment 0) as adresses
*/ */
virtual Common::Array<reg_t> listAllOutgoingReferences(reg_t object) const { virtual Common::Array<reg_t> listAllOutgoingReferences(reg_t object) const {
return Common::Array<reg_t>(); return Common::Array<reg_t>();