Re: TERMINFO_DIRS

[Thomas Klausner <wiz%netbsd.org@localhost>]

Hi!

Ok, thanks for the rationale. What do you think of the attached diff
for terminfo(5)?
 Thomas

Index: terminfo.5.in
===================================================================
RCS file: /cvsroot/src/lib/libterminfo/terminfo.5.in,v
retrieving revision 1.24
diff -u -r1.24 terminfo.5.in
--- terminfo.5.in	5 Jun 2020 22:08:11 -0000	1.24
+++ terminfo.5.in	18 Oct 2025 13:41:29 -0000
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 5, 2020
+.Dd October 18, 2025
 .Dt TERMINFO 5
 .Os
 .Sh NAME
@@ -245,12 +245,41 @@
 .It Pa /usr/share/misc/terminfo.cdb
 Database of terminal descriptions.
 .El
+.Sh COMPATIBILITY
+Please note that
+.Ev TERMINFO_DIRS
+in
+.Nx
+.Nm
+must point to
+.Nm
+files.
+When using ncurses, it must point to directories instead, since
+ncurses splits out the information into a directory tree.
 .Sh SEE ALSO
 .Xr infocmp 1 ,
 .Xr tic 1 ,
 .Xr tput 1 ,
 .Xr curses 3 ,
 .Xr cdb 5
+.Sh ENVIRONMENT VARIABLES
+.Bl -tag -width 15n
+.It Ev TERM
+Terminal information to use.
+.It Ev TERMCAP
+.Xr termcap 3
+file that will be used if it matches
+.Ev TERM .
+.It Ev TERMINFO
+.Nm
+file that will be used if it matches
+.Ev TERM .
+.It Ev TERMINFO_DIRS
+Colon-separated path of
+.Nm
+files to search for
+.Ev TERM .
+.El
 .Sh STANDARDS
 .Nm
 complies with the