1. Forum
  2. DOVE-Net
  3. Synchronet Programming

  • src/sbbs3/scfg/CLAUDE.md

    From Rob Swindell (on Debian L@VERT to Git commit to main/sbbs/m on Sunday, May 24, 2026 03:00:00
    https://gitlab.synchro.net/main/sbbs/-/commit/745819dbe8a7c6699ce49614
    Added Files:
    src/sbbs3/scfg/CLAUDE.md
    Log Message:
    scfg: add CLAUDE.md with menu help text and search index conventions

    Captures lessons learned across recent SCFG work:

    * uifc.helpbuf format conventions (title in backticks, ~72-col wrap,
    backtick-quoted option names, sysop voice, no internal-symbol
    references) with canonical examples to template from.
    * Helpbufs live inline in scfg*.c, NOT in ctrl/text.dat -- different
    system from the text[] runtime string database.
    * Shared menu helpers (js_startup_cfg, login_attempt_cfg,
    rate_limit_cfg, max_concurrent_cfg) -- one edit changes every
    caller's menu.
    * No automated test; validate F1-rendered help interactively.
    * CP437 box-drawing characters in helpbufs are corrupted by string-
    substitution editors; preserve raw bytes.
    * scfgindex.h is auto-generated by gen_option_index.py; regenerate
    after menu changes; out-of-tree builds skip the auto-regen rule
    so always re-run by hand.
    * When adding a new dispatch pattern, verify is_navigable_list()
    still classifies the menu correctly or the options silently drop
    from search.

    In-repo home for these makes them visible to future sessions and
    teammates working in src/sbbs3/scfg/ without having to consult any
    per-user memory.

    ---
    þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net
  • From Rob Swindell (on Debian L@VERT to Git commit to main/sbbs/m on Monday, May 25, 2026 01:31:00
    https://gitlab.synchro.net/main/sbbs/-/commit/4492c97053fabc92def51ced
    Modified Files:
    src/sbbs3/scfg/CLAUDE.md scfgsrvr.c
    Log Message:
    scfg: rich helpbuf for Services Server Settings menu

    Replace the one-line "for full documentation, see ..." stub with a
    per-option breakdown (Enabled, Log Level, Network Interfaces, Lookup
    Client Hostname, Configuration File, Login Requirements, Login Info
    Save, Limit Rate of Connections, JavaScript Settings, Failed Login
    Attempts) following the format used by rate_limit_cfg / js_startup_cfg.

    Also extend src/sbbs3/scfg/CLAUDE.md with two clarifications uncovered
    while writing this:

    - 72 columns is the renderer's hard wrap (help window width 76 minus
    2 borders minus 2x1 pad in showbuf()), not a stylistic target;
    longer lines auto-wrap mid-word.
    - The wrap budget is *visible* width: ` and ~ are highlight/inverse
    toggles consumed by WIN_HLP rendering, plus control bytes 1/2.
    - Don't cross-reference sbbsctrl in helpbufs; SCFG is cross-platform
    but sbbsctrl is Windows-only.

    ---
    þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net
  • From Rob Swindell (on Debian L@VERT to Git commit to main/sbbs/m on Monday, May 25, 2026 01:31:00
    https://gitlab.synchro.net/main/sbbs/-/commit/a658ce66e51684cbc02fda5c
    Modified Files:
    src/sbbs3/scfg/CLAUDE.md scfgnet.c
    Log Message:
    scfg: rich helpbuf for Networks > Internet E-mail menu

    Replace the two-line stub menu intro with a per-option breakdown
    (System Address, Inbound/Outbound semaphores, Allow Sending, Allow
    File Attachments, Send Using Alias, Kill After Sent, Cost) that
    explains this menu sets *user-facing* policy for outbound SMTP Ä not server-side delivery, which lives under Servers > Mail Server.

    Also tighten src/sbbs3/scfg/CLAUDE.md: pack lines close to the 72
    visible-col ceiling instead of leaving 10+ chars of slack, which
    produces a column of short lines that reads as choppy.

    ---
    þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net
  • From Rob Swindell (on Windows@VERT to Git commit to main/sbbs/m on Friday, May 29, 2026 00:55:00
    https://gitlab.synchro.net/main/sbbs/-/commit/0426071d7dcca761f58b19b7
    Modified Files:
    src/sbbs3/scfg/CLAUDE.md
    Log Message:
    scfg/CLAUDE.md: document helpbuf two-space sentence convention

    Helpbuf text uses ". " between sentences (period + double-space +
    capital), matching the in-tree convention. Mixed single/double
    spacing within one help block reads as inconsistent at runtime.

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

    ---
    þ Synchronet þ Vertrauen þ Home of Synchronet þ [vert/cvs/bbs].synchro.net