Summary: [Lang. Ref.] Documentation for OutOfMemoryException is too poor
Product: REALbasic
ProductVersion: 4.5fc4
Component: Documentation
Severity: Feature Request
CC: realbasic-dr at lists dot realsoftware dot com
Reproduce:
Reproducible: Always
OSVersion: 9.1
CPUType: PowerPC
SubmittedOn:
REALbugsVersion: 1.4.1
Description:
In the Language Reference available inside RB via the Help menu, the entry for
'OutOfMemoryException' is extremely poor. Just saying: 'Raised in certain cases
when you run out of memory' is like elaborated silence.
So please list ALL situations in which RB may raise an OutOfMemoryException;
and add some notes on this. For example, mention that creating a picture object
via 'p = new Picture(...)' may raise an OutOfMemoryException, as opposed to
creating it via (the old and ugly) 'p = newPicture(...)' syntax, which just
returns NIL if there is not enough memory available. And maybe you could add an
example, like:
dim p as Picture
p = new Picture(640, 480, 32)
exception exc as OutOfMemoryException
msgBox "Not enough RAM available for creating the new picture object"
We (the developers) need this information if we want to write stable
applications. If I don't known when OutOfMemoryException may be raised, this is
much more work. You (RS) should already have the information when and why
OutOfMemoryException could occure, so please share this information with us.
All the best,
Roman
WorkaroundNotes:
Workaround: 0
|