Subj : docs/dropfile_ini.md
To   : Git commit to main/sbbs/master
From : Rob Swindell (on Debian Linux)
Date : Wed Sep 30 2026 19:08:47

https://gitlab.synchro.net/main/sbbs/-/commit/ae6931740a8469bf72584107
Modified Files:
	docs/dropfile_ini.md
Log Message:
docs: DROPFILE.INI draft 0.4

Changes since draft 0.3 (e7a825704e, mode-3-declare, 2026-09-26):

- The bool type is now 0 (false) or any other unsigned decimal (true),
  so a key can later define values above 1 that mean true plus more
  detail, the way TERM_RIP grew from a yes/no into a version. Consumers
  test nonzero and must not compare against 1; producers write only 0
  or 1 unless the key defines another value; a value above 1 must be a
  refinement of true, so a door that treats it as 1 still works.
- TERM_MOUSE is the first key to use that: 1 = cell reports, 2 = pixel
  reports too (SGR-Pixels, mode 1016). The termgfx doors latch pixel
  mode today only from a DECRPM reply some terminals never send, or
  from a report that lands past the text grid; 2 closes that window.
  Source adds DECRQM requests for modes 1006 and 1016 on non-CTerm
  terminals, which report a mode without changing it.
- PREF_MOUSE now means consent, not a hot-spot wish: 0 = the user has
  turned mouse use off, so a door must not enable reporting for
  hot-spots, menus or scrolling. A pointer-driven door (steering,
  aiming) may still capture the pointer and then offers its own switch.
  Synchronet has no per-user hot-spot setting; its MOUSE setting is the
  user's answer to "Does your terminal support mouse reporting".
- Synchronet notes: TERM_MOUSE from per-session detection, falling back
  to the user's setting when detection was silent; PREF_MOUSE=0 when
  the setting is off. New to-do: keep the detected capability on the
  Terminal object, never in autoterm, because Terminal::get_flags()
  ORs the user's manual flags into the detected ones, so a detected
  MOUSE would override a user's "no"; the MOUSE setting then means
  consent and its question is reworded and defaulted from detection.
- The forked-CTerm to-do is ticked (done in 45d5185bdb, lens-28-were,
  2026-09-30).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
--- SBBSecho 3.38-Linux
 * Origin: Vertrauen - [vert/cvs/bbs].synchro.net (1:103/705)

.