fluffos/docs/apply/master
Yucong Sun c5f3c3bdc7
docs: document call_out handle validity and mid-compile valid_read behavior (#1252)
Follow-up to reviewing PRs #1068 and #932, both of whose bugs are already
fixed on master:

- #1068 (call_out handles below the allocation counter rejected as
  invalid) was fixed by #1220 with a regression test in
  testsuite/single/tests/efuns/remove_call_out.lpc. Document the
  guaranteed semantics in call_out.md / remove_call_out.md: a handle
  stays valid until it fires or is removed, regardless of newer
  call_outs; 0 is never a valid handle.

- #932 (an error thrown from valid_read during #include handling left
  compile_file's reentrancy guard set, wedging all future loads) is
  fixed by the compiler front-end rewrite: compile_file's scope guard
  restores all compiler state and clears the guard on exception
  unwinding. Document in valid_read.md that the apply runs mid-compile
  for #include checks, must not trigger another compile, and that a
  thrown error aborts only that compilation.


Claude-Session: https://claude.ai/code/session_01JRvUnh3x5MYPWPk2MiiUS2

Co-authored-by: Claude <noreply@anthropic.com>
2026-07-12 02:02:56 -04:00
..
author_file.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
compile_object.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
connect.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
crash.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
creator_file.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
domain_file.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
epilog.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
error_handler.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
flag.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
get_bb_uid.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
get_include_path.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
get_mud_stats.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
get_root_uid.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
get_save_file_name.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
include_file.md Add inherit_program / include_file master applies; auto hot-reload demo (#1230) 2026-07-10 10:27:27 -04:00
inherit_program.md Add inherit_program / include_file master applies; auto hot-reload demo (#1230) 2026-07-10 10:27:27 -04:00
log_error.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
make_path_absolute.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
object_name.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
parser_error_message.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
preload.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
privs_file.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
retrieve_ed_setup.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
save_ed_setup.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_bind.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_database.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_ffi.md docs: validate "See Also" references, drop dead ones, document valid_ffi (#1251) 2026-07-12 01:09:17 -04:00
valid_hide.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_link.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_object.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_override.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_read.md docs: document call_out handle validity and mid-compile valid_read behavior (#1252) 2026-07-12 02:02:56 -04:00
valid_save_binary.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_seteuid.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_shadow.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_socket.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00
valid_write.md Add local search and documentation guide for docs site (#1221) 2026-07-09 22:09:55 -04:00