install caps-rendered as notcurses-info #1745

CMakeLists.txt

@@ -548,6 +548,21 @@ target_link_libraries(notcurses-demo
     Threads::Threads
 )
 
+############################################################################
+# notcurses-info
+file(GLOB INFOSRCS CONFIGURE_DEPENDS src/info/*.c)
+add_executable(notcurses-info ${INFOSRCS})
+target_include_directories(notcurses-info
+  PRIVATE
+    include
+    "${CMAKE_REQUIRED_INCLUDES}"
+    "${PROJECT_BINARY_DIR}/include"
+)
+target_link_libraries(notcurses-info
+  PRIVATE
+    notcurses
+)
+
 ############################################################################
 # notcurses-input
 file(GLOB INPUTSRCS CONFIGURE_DEPENDS src/input/input.cpp)
@@ -786,6 +801,7 @@ list(FILTER MARKDOWN EXCLUDE REGEX "INSTALL.md")
 install(FILES ${MARKDOWN} DESTINATION ${CMAKE_INSTALL_DOCDIR})
 
 install(TARGETS notcurses-demo DESTINATION bin)
+install(TARGETS notcurses-info DESTINATION bin)
 install(TARGETS notcurses-input DESTINATION bin)
 install(TARGETS nctetris DESTINATION bin)
 install(TARGETS ncneofetch DESTINATION bin)

README.md

@@ -123,12 +123,13 @@ may well be possible to use still older versions. Let me know of any successes!
 
 ## Included tools
 
-Seven binaries are installed as part of Notcurses:
+Eight binaries are installed as part of Notcurses:
 * `ncls`: an `ls` that displays multimedia in the terminal
 * `ncneofetch`: a [neofetch](https://github.com/dylanaraps/neofetch) ripoff
 * `ncplayer`: renders visual media (images/videos)
 * `nctetris`: a tetris clone
 * `notcurses-demo`: some demonstration code
+* `notcurses-info`: detect and print terminal capabilities/diagnostics
 * `notcurses-input`: decode and print keypresses
 * `notcurses-tester`: unit testing
 

doc/man/man1/notcurses-info.1.md

@@ -0,0 +1,35 @@
+% notcurses-info(1)
+% nick black <nickblack@linux.com>
+% v2.3.2
+
+# NAME
+
+notcurses-info - Display information about the terminal environment
+
+# SYNOPSIS
+
+**notcurses-info**
+
+# DESCRIPTION
+
+**notcurses-info** prints all the information it knows about the current
+terminal environment, including material loaded from **terminfo(5)** (based
+on the **TERM** environment variable), replies from the terminal in
+response to our queries, and built-in heuristics.
+
+The Unicode half block, quadrant, sextant, and Braille glyphs are all included
+in the output. If their appearance is irregular, it might behoove you to choose
+another font.
+
+# OPTIONS
+
+# NOTES
+
+The behavior of **notcurses-info** (and indeed all of Notcurses) depends on
+the **TERM** and **LANG** environment variables, the installed POSIX locales,
+and the installed **terminfo(5)** databases.
+
+# SEE ALSO
+
+**notcurses(3)**,
+**terminfo(5)**