fluffos/docs/efun/objects/destruct.md
gesslar 1ad5953549
docs: validate "See Also" references, drop dead ones, document valid_ffi (#1251)
* empty

* docs: validate "See Also" references, drop dead ones, document valid_ffi

Reviewed the "See Also" section of every doc and dropped man-page
cross-references whose target page does not exist (verified against the
driver source, not just the docs tree):

  - errorp, each, opcprof, dump_socket_status, extract, shadowp,
    destruct_env_of, move, inventory_visible, inventory_accessible

These name efuns/applies that no longer exist in FluffOS. keys/values now
point at the `for` construct in place of the defunct `each` efun.

valid_ffi was the one "referenced but undocumented" case: it is a real
master apply (APPLY_VALID_FFI) gating every ffi_load/symbol/prepare/
callback, so it gets a proper apply page rather than having its references
removed. Sidebar regenerated to include it.

The 13 modern markdown-link "See Also" sections were already clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-12 01:09:17 -04:00

26 lines
557 B
Markdown

---
title: objects / destruct
---
# destruct
### NAME
destruct() - remove an object from the games
### SYNOPSIS
void destruct( object ob );
### DESCRIPTION
Completely destroy and remove object 'ob'. After the call to
destruct(), no global variables will exist any longer, only locals, and
arguments. If 'ob' is this_object(), execution will continue, but it
is best to return a value immediately.
If no object is supplied, this efun will default to this_object().
### SEE ALSO
clone_object(3), new(3)