documentation: Various doc tidyup

configure.ac: Tidy up coap_defines.h generation

doc/upgrade_4.3.4_4.3.5.txt: Document upgrade requirements

doc/Makefile.am: Include upgrade_4.3.4_4.3.5.txt

cmake_coap_defines.h.in: Add brief description
src/coap_sha1.c: Add in brief description

Note: With Ubuntu 24.04.01, when running a2x, spurious entries
 <unknown>:1: SyntaxWarning: invalid escape sequence '\S'
occur. Fixed by asciidoc-py/asciidoc-py#267

cmake_coap_defines.h.in

@@ -9,6 +9,11 @@
  * of use.
  */
 
+/**
+ * @file coap_defines.h
+ * @brief List of libcoap library build defines
+ */
+
 #ifndef COAP_DEFINES_H_
 #define COAP_DEFINES_H_
 

configure.ac

@@ -1554,7 +1554,9 @@ else
 fi
 
 mkdir -p include/coap$LIBCOAP_API_VERSION
-LT_TEMP=`grep -B2 " COAP_" coap_config.h > include/coap$LIBCOAP_API_VERSION/coap_defines.h`
+head -19 cmake_coap_defines.h.in > include/coap$LIBCOAP_API_VERSION/coap_defines.h
+LT_TEMP=`grep -B2 " COAP_" coap_config.h >> include/coap$LIBCOAP_API_VERSION/coap_defines.h`
+tail -2 cmake_coap_defines.h.in >> include/coap$LIBCOAP_API_VERSION/coap_defines.h
 if test "x$LT_TEMP" != "x" ; then
     AC_MSG_ERROR([Unable to build coap_defines.h])
 fi

doc/Makefile.am

@@ -21,6 +21,7 @@ EXTRA_DIST = \
   upgrade_4.3.1_4.3.2.txt \
   upgrade_4.3.2_4.3.3.txt \
   upgrade_4.3.3_4.3.4.txt \
+  upgrade_4.3.4_4.3.5.txt \
   main.md \
   module_api_wrap.h
 
@@ -244,7 +245,7 @@ man-page-build: upg-page-build man-page-start
 	done
 
 if BUILD_MANPAGES
-UPG_LIST = upgrade_4.2.1_4.3.0.txt upgrade_4.3.0_4.3.1.txt upgrade_4.3.1_4.3.2.txt upgrade_4.3.2_4.3.3.txt upgrade_4.3.3_4.3.4.txt
+UPG_LIST = upgrade_4.2.1_4.3.0.txt upgrade_4.3.0_4.3.1.txt upgrade_4.3.1_4.3.2.txt upgrade_4.3.2_4.3.3.txt upgrade_4.3.3_4.3.4.txt upgrade_4.3.4_4.3.5.txt
 
 upg-page-build:
 	@for FILE in $(UPG_LIST) ; do \

doc/upgrade_4.3.4_4.3.5.txt

@@ -0,0 +1,5 @@
+= Upgrade from 4.3.4 to 4.3.5
+
+== Summary
+
+No code or binary changes required.

src/coap_sha1.c

@@ -63,6 +63,11 @@
  * Reformatted as appropriate.
  */
 
+/**
+ * @file coap_sha1.c
+ * @brief SHA-1 handling functions
+ */
+
 #include "coap3/coap_libcoap_build.h"
 
 #if COAP_WS_SUPPORT && !defined(COAP_WITH_LIBOPENSSL) && !defined(COAP_WITH_LIBGNUTLS) && !defined(COAP_WITH_LIBMBEDTLS) && !defined(COAP_WITH_LIBWOLFSSL)