docs: correct what the guides claim the engine does
Checked every page against engine/source rather than against itself. Three
kinds of problem, all verified before and after editing.
Wrong behavior. The asset guides said refreshAsset() writes the asset's file
and that assets save themselves whenever a field changes. Neither is true
since 4.0 -- refreshAsset only announces the change, saveAsset writes -- so a
reader followed the wiki, never saved, and lost the edit. Both pages now lead
with the text-editor comparison and carry the dirty/save/revert/snapshot API
that replaced it. AssetSnapshot, getAssetSnapshot and setAssetSnapshot are
gone from the engine; createStateSnapshot/restoreStateSnapshot document them.
Wrong names. getWindowExtents, onExtentChanged, clearAllColor, sortByAText,
getcameraSize, setREnderMasks, getitemCount, setPolyScale,
setImageFrameName, getFieldValue, copyModules, restoreAssettags and the edge
collision-shape pair either never existed or were renamed. GuiContentProfile
appeared eight times as the answer to "which profile goes here" and is not a
type at all -- those fields take a GuiControlProfile, and a theme fills each
one from a named category. Callback-Guide lost 18 class blocks naming classes
that do not exist; GuiMenuBar turned out to have a live successor and was
remapped rather than deleted.
Missing coverage. Scene, SceneObject, GuiControl, GuiCanvas,
GuiColorPopupCtrl, CompositeSprite, Taml, FontAsset, ModuleManager and the
rest are now fully documented -- roughly 200 methods, written grouped by task
rather than listed. Where a method has a trap it says so: getMass returns
zero outside a Scene, setSize does nothing when autoSizing is on, a paused
Scene is still drawn, getLoadedPageCount below getPageCount means a font page
image is missing.
ImageFont-Guide becomes a migration signpost -- the class has been gone since
3.3, and the page had documented it in full anyway.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014Xh3XULt9PtdCtsaYHGnYE