fluffos/docs/efun/interactive/request_term_size.md
gesslar 6e6d1c772b
docs: flesh out 31 TBW efun reference pages (#1248)
* empty

* docs: flesh out 31 TBW efun reference pages

Replace the placeholder "TBW" DESCRIPTION and type-only SYNOPSIS in 31
efun docs with real descriptions and named parameters, verified against
the driver source:

- math (general/): log10, log2, norm, dotprod, distance, angle
- matrix (general/): id_matrix, translate, scale, rotate_x/y/z,
  lookat_rotate, lookat_rotate2 -- note the in-place mutation of the
  passed matrix and that rotations are in degrees
- compress (general/): compress, uncompress, compress_file,
  uncompress_file -- note the file variants delete the source on success
- interactive/: send_zmp, act_mxp, request_term_type,
  start_request_term_type, request_term_size
- internals/: dump_trace, destructed_objects, check_memory (flag
  bitmask + DEBUGMALLOC build requirement), dump_stralloc, dump_jemalloc
- core: next_bit, explode_reversible, shallow_inherit_list

Each page keeps the existing manpage-style layout (4-space-indented
NAME/SYNOPSIS/DESCRIPTION, name(3) SEE ALSO). Example blocks are indented
to match, so all files are markdownlint-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-11 22:07:47 -04:00

766 B

title
interactive / request_term_size

request_term_size

NAME

request_term_size() - control telnet window-size (NAWS) reporting

SYNOPSIS

void request_term_size(void | int enable);

DESCRIPTION

Controls telnet NAWS (Negotiate About Window Size) for current_object's
client. Called with no argument, or with a nonzero 'enable', it requests
window-size reporting (telnet DO NAWS). Called with 'enable' equal to 0 it
stops requesting window size (telnet DONT NAWS). Pending output is flushed.

If current_object is not interactive, request_term_size() does nothing and a
warning is emitted.

Note: request_term_size() should only be called from within a user object.

SEE ALSO

request_term_type(3)