Instruction set reference
HIPE_OP_FREE_LOCATION
Send this instruction to the display server to free server resources
associated with a hipe_loc location handle the client application no longer needs.
Usually a location that has been deleted. After this operation, the tag may still exist on
the screen but no longer has a location value connected to it.
- location: The location reference to be discarded.
- arg[0] (optional): a list of locations to free instead, e.g. "57,1000-1499" (comma-separated numbers and ranges, no spaces). The location field is then ignored. A malformed list is fatal.
Notes
Freeing a location takes it off its element. The element's events are no longer reported, and if the element returns to the document later (for example by undo), it has no location. Locations inside content replaced by HIPE_OP_SET_TEXT stay in use until freed. See "Locations".
Location handle resources held by the display server are freed automatically when your application terminates. However, it is still polite to free unneeded location handles from time to time, especially if your application uses a lot of them.
Discard any local copies of hipe_loc values whenever you free them, since they are no longer valid for use in Hipe instructions.