diff --git a/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___FUNCTION__.h b/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___FUNCTION__.h
index 03d68a6..5aae42b 100644
--- a/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___FUNCTION__.h
+++ b/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___FUNCTION__.h
@@ -2,9 +2,8 @@
 
 #undef HAVE___FUNCTION__
 
-/* HAVE___FUNCTION__
- * __FUNCTION__ is another name for __func__, provided for backward
- * compatibility with old versions of GCC.
- * Although it is seemingly available everywhere else.
+/* __FUNCTION__ is another name for __func__, provided for backward
+ * compatibility with old versions of GCC. Although it is seemingly
+ * available everywhere else.
  */
 #define HAVE___FUNCTION__ 1
diff --git a/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___func__.h b/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___func__.h
index 0f65495..4eb9d4f 100644
--- a/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___func__.h
+++ b/libbuild2-autoconf/libbuild2/autoconf/checks/HAVE___func__.h
@@ -2,8 +2,7 @@
 
 #undef HAVE___func__
 
-/* HAVE___func__
- * __func__ was added to the standard in C99 and C++11. But seemingly exists
+/* __func__ was added to the standard in C99 and C++11. But seemingly exists
  * almost everywhere before that as well.
  */
 
diff --git a/libbuild2-autoconf/libbuild2/autoconf/checks/SIZEOF_PTHREAD_T.h b/libbuild2-autoconf/libbuild2/autoconf/checks/SIZEOF_PTHREAD_T.h
index c3929bf..b917074 100644
--- a/libbuild2-autoconf/libbuild2/autoconf/checks/SIZEOF_PTHREAD_T.h
+++ b/libbuild2-autoconf/libbuild2/autoconf/checks/SIZEOF_PTHREAD_T.h
@@ -2,6 +2,11 @@
 
 #undef SIZEOF_PTHREAD_T
 
+/* Using the size of pointer appears to be a reasonable heuristics and
+ *  __SIZEOF_POINTER__ is availbale everywhere where we have pthread (see
+ *  SIZEOF_POINTER.h for details). Note also that we have a test that verifies
+ *  this assumption.
+ */
 #ifndef _MSC_VER
 #  ifdef __SIZEOF_POINTER__
 #    define SIZEOF_PTHREAD_T __SIZEOF_POINTER__