Happens at least with `vi`, other full-screen tools might suffer as well. If an unsupported terminal is in TERM, `vi` rejects starting with a misleading message: $ TERM=abc123 vi 111 vi: No terminal database found i.e. "no terminal database found" instead of "no terminal database entry found", "unknown terminal type", etc. The message can confuse even experienced users, not saying for novices. For me it appeared during system upgrade in virtualbox, TERM was `screen.xterm-256color` as provided by newer `screen` versions (even after forcing with "-T screen" - this is `screen` issue not for this ticket), so, the exact moment suggested upgrade error. Please consider replacing it with more elaborated error description.
this seems to be a limitation of the https://man.freebsd.org/setupterm(3) function. the code is there, https://github.com/freebsd/freebsd-src/blob/133b132bc1b612abe591c8f54680c3da8491e194/contrib/nvi/cl/cl_main.c#L228 but we don't hit it