Normalize comments in *nix build system m4 files

Normalization include:
- Use dnl for everything that can be ommitted when configure is built in
  favor of the shell comment character # which is visible in the output.
- Line length normalized to 80 columns
- Dots for most of the one line sentences
- Macro definitions include similar pattern header comments now

Author: petk

TSRM/threads.m4

@@ -28,7 +28,7 @@ dnl  OF THE POSSIBILITY OF SUCH DAMAGE.
 dnl
 dnl PTHREADS_FLAGS
 dnl
-dnl Set some magic defines to achieve POSIX threads conformance
+dnl Set some magic defines to achieve POSIX threads conformance.
 dnl
 AC_DEFUN([PTHREADS_FLAGS],[
   if test -z "$host_alias" && test -n "$host"; then
@@ -52,18 +52,17 @@ AC_DEFUN([PTHREADS_FLAGS],[
     PTHREAD_FLAGS=-D_REENTRANT;;
   *sco*)
     PTHREAD_FLAGS=-D_REENTRANT;;
-dnl Solves sigwait() problem, creates problems with u_long etc.
-dnl    PTHREAD_FLAGS="-D_REENTRANT -D_XOPEN_SOURCE=500 -D_POSIX_C_SOURCE=199506 -D_XOPEN_SOURCE_EXTENDED=1";;
   esac
 
   if test -n "$PTHREAD_FLAGS"; then
     CPPFLAGS="$CPPFLAGS $PTHREAD_FLAGS"
   fi
-])dnl
+])
+
 dnl
 dnl PTHREADS_CHECK_COMPILE
 dnl
-dnl Check whether the current setup can use POSIX threads calls
+dnl Check whether the current setup can use POSIX threads calls.
 dnl
 AC_DEFUN([PTHREADS_CHECK_COMPILE], [
 AC_LINK_IFELSE([ AC_LANG_SOURCE([
@@ -85,11 +84,12 @@ int main() {
   ], [
   pthreads_checked=no
   ]
-) ] )dnl
+) ] )
+
 dnl
-dnl PTHREADS_CHECK()
+dnl PTHREADS_CHECK
 dnl
-dnl Try to find a way to enable POSIX threads
+dnl Try to find a way to enable POSIX threads.
 dnl
 dnl  Magic flags
 dnl  -kthread          gcc (FreeBSD)
@@ -102,7 +102,6 @@ dnl  -qthreaded        AIX cc V5
 dnl  -threads          gcc (HP-UX)
 dnl
 AC_DEFUN([PTHREADS_CHECK],[
-
 save_CFLAGS=$CFLAGS
 save_LIBS=$LIBS
 PTHREADS_ASSIGN_VARS
@@ -151,8 +150,12 @@ if test "$pthreads_working" = "yes"; then
 else
   threads_result="POSIX-Threads not found"
 fi
-])dnl
+])
+
 dnl
+dnl PTHREADS_ASSIGN_VARS
+dnl
+dnl Adds pthreads linker and compiler flags.
 dnl
 AC_DEFUN([PTHREADS_ASSIGN_VARS],[
 if test -n "$ac_cv_pthreads_lib"; then
@@ -162,4 +165,4 @@ fi
 if test -n "$ac_cv_pthreads_cflags"; then
   CFLAGS="$CFLAGS $ac_cv_pthreads_cflags"
 fi
-])dnl
+])

TSRM/tsrm.m4

@@ -1,13 +1,19 @@
-AC_DEFUN([TSRM_BASIC_CHECKS],[
+dnl This file contains TSRM specific autoconf macros.
 
+dnl
+dnl TSRM_BASIC_CHECKS
+dnl
+AC_DEFUN([TSRM_BASIC_CHECKS],[
 AC_REQUIRE([AC_PROG_CC])dnl
 AC_REQUIRE([AC_PROG_RANLIB])dnl
 
 AC_CHECK_FUNCS(sigprocmask)
 ])
 
+dnl
+dnl TSRM_CHECK_PTH
+dnl
 AC_DEFUN([TSRM_CHECK_PTH],[
-
 AC_MSG_CHECKING(for GNU Pth)
 PTH_PREFIX="`$1 --prefix`"
 if test -z "$PTH_PREFIX"; then
@@ -20,9 +26,11 @@ LIBS="$LIBS `$1 --libs`"
 
 AC_DEFINE(GNUPTH, 1, [Whether you use GNU Pth])
 AC_MSG_RESULT(yes - installed in $PTH_PREFIX)
-
 ])
 
+dnl
+dnl TSRM_CHECK_ST
+dnl
 AC_DEFUN([TSRM_CHECK_ST],[
   if test -r "$1/include/st.h"; then
     CPPFLAGS="$CPPFLAGS -I$1/include"
@@ -40,8 +48,10 @@ AC_DEFUN([TSRM_CHECK_ST],[
   AC_DEFINE(TSRM_ST, 1, [ ])
 ])
 
+dnl
+dnl TSRM_CHECK_PTHREADS
+dnl
 AC_DEFUN([TSRM_CHECK_PTHREADS],[
-
 PTHREADS_CHECK
 
 if test "$pthreads_working" != "yes"; then
@@ -54,11 +64,13 @@ AC_MSG_CHECKING(for POSIX threads)
 AC_MSG_RESULT(yes)
 ])
 
+dnl
+dnl TSRM_THREADS_CHECKS
+dnl
+dnl For the thread implementations, we always use --with-* to maintain
+dnl consistency.
+dnl
 AC_DEFUN([TSRM_THREADS_CHECKS],[
-
-dnl For the thread implementations, we always use --with-*
-dnl to maintain consistency
-
 AC_ARG_WITH([tsrm-pth],
   [AS_HELP_STRING([[--with-tsrm-pth[=pth-config]]],
     [Use GNU Pth])],
@@ -86,5 +98,4 @@ elif test "$TSRM_ST" != "no"; then
 elif test "$TSRM_PTHREADS" != "no"; then
   TSRM_CHECK_PTHREADS
 fi
-
 ])

Zend/Zend.m4

@@ -1,9 +1,11 @@
+dnl This file contains Zend specific autoconf macros.
+
 dnl
-dnl This file contains Zend specific autoconf functions.
+dnl ZEND_CHECK_FLOAT_PRECISION
 dnl
-
 dnl x87 floating point internal precision control checks
 dnl See: http://wiki.php.net/rfc/rounding
+dnl
 AC_DEFUN([ZEND_CHECK_FLOAT_PRECISION],[
   AC_MSG_CHECKING([for usable _FPU_SETCW])
   AC_LINK_IFELSE([AC_LANG_PROGRAM([[
@@ -116,6 +118,11 @@ AC_DEFUN([ZEND_CHECK_FLOAT_PRECISION],[
   fi
 ])
 
+dnl
+dnl LIBZEND_BASIC_CHECKS
+dnl
+dnl Basic checks specific for the Zend engine library.
+dnl
 AC_DEFUN([LIBZEND_BASIC_CHECKS],[
 AC_REQUIRE([AC_PROG_CC])
 
@@ -130,10 +137,12 @@ unix.h \
 cpuid.h \
 dlfcn.h)
 
-AC_DEFUN([LIBZEND_DLSYM_CHECK],[
+dnl
+dnl LIBZEND_DLSYM_CHECK
 dnl
 dnl Ugly hack to check if dlsym() requires a leading underscore in symbol name.
 dnl
+AC_DEFUN([LIBZEND_DLSYM_CHECK],[
 AC_MSG_CHECKING([whether dlsym() requires a leading underscore in symbol names])
 _LT_AC_TRY_DLOPEN_SELF([
   AC_MSG_RESULT(no)
@@ -152,7 +161,7 @@ AC_CHECK_DECLS([isfinite, isnan, isinf], [], [], [[#include <math.h>]])
 
 ZEND_CHECK_FLOAT_PRECISION
 
-dnl test whether double cast to long preserves least significant bits
+dnl Test whether double cast to long preserves least significant bits.
 AC_MSG_CHECKING(whether double cast to long preserves least significant bits)
 
 AC_RUN_IFELSE([AC_LANG_SOURCE([[
@@ -186,6 +195,9 @@ int main()
 
 ])
 
+dnl
+dnl LIBZEND_OTHER_CHECKS
+dnl
 AC_DEFUN([LIBZEND_OTHER_CHECKS],[
 
 AC_ARG_ENABLE([maintainer-zts],
@@ -247,8 +259,8 @@ else
   AC_MSG_RESULT(no)
 fi
 
-dnl test and set the alignment define for ZEND_MM
-dnl this also does the logarithmic test for ZEND_MM.
+dnl Test and set the alignment define for ZEND_MM. This also does the
+dnl logarithmic test for ZEND_MM.
 AC_MSG_CHECKING(for MM alignment and log values)
 
 AC_RUN_IFELSE([AC_LANG_SOURCE([[
@@ -289,7 +301,7 @@ int main()
   AC_DEFINE_UNQUOTED(ZEND_MM_ALIGNMENT, $LIBZEND_MM_ALIGN, [ ])
   AC_DEFINE_UNQUOTED(ZEND_MM_ALIGNMENT_LOG2, $LIBZEND_MM_ALIGN_LOG2, [ ])
 ], [], [
-  dnl cross-compile needs something here
+  dnl Cross compilation needs something here.
   LIBZEND_MM_ALIGN=8
 ])
 
@@ -392,9 +404,7 @@ else
 fi
 AC_MSG_RESULT($ZEND_GCC_GLOBAL_REGS)
 
-dnl
-dnl Check if atof() accepts NAN
-dnl
+dnl Check if atof() accepts NAN.
 AC_CACHE_CHECK(whether atof() accepts NAN, ac_cv_atof_accept_nan,[
 AC_RUN_IFELSE([AC_LANG_SOURCE([[
 #include <math.h>
@@ -423,9 +433,7 @@ if test "$ac_cv_atof_accept_nan" = "yes"; then
   AC_DEFINE([HAVE_ATOF_ACCEPTS_NAN], 1, [whether atof() accepts NAN])
 fi
 
-dnl
-dnl Check if atof() accepts INF
-dnl
+dnl Check if atof() accepts INF.
 AC_CACHE_CHECK(whether atof() accepts INF, ac_cv_atof_accept_inf,[
 AC_RUN_IFELSE([AC_LANG_SOURCE([[
 #include <math.h>
@@ -457,9 +465,7 @@ if test "$ac_cv_atof_accept_inf" = "yes"; then
   AC_DEFINE([HAVE_ATOF_ACCEPTS_INF], 1, [whether atof() accepts INF])
 fi
 
-dnl
-dnl Check if HUGE_VAL == INF
-dnl
+dnl Check if HUGE_VAL == INF.
 AC_CACHE_CHECK(whether HUGE_VAL == INF, ac_cv_huge_val_inf,[
 AC_RUN_IFELSE([AC_LANG_SOURCE([[
 #include <math.h>
@@ -492,9 +498,7 @@ if test "$ac_cv_huge_val_inf" = "yes"; then
   AC_DEFINE([HAVE_HUGE_VAL_INF], 1, [whether HUGE_VAL == INF])
 fi
 
-dnl
-dnl Check if HUGE_VAL + -HUGEVAL == NAN
-dnl
+dnl Check if HUGE_VAL + -HUGEVAL == NAN.
 AC_CACHE_CHECK(whether HUGE_VAL + -HUGEVAL == NAN, ac_cv_huge_val_nan,[
 AC_RUN_IFELSE([AC_LANG_SOURCE([[
 #include <math.h>
@@ -529,9 +533,7 @@ if test "$ac_cv_huge_val_nan" = "yes"; then
   AC_DEFINE([HAVE_HUGE_VAL_NAN], 1, [whether HUGE_VAL + -HUGEVAL == NAN])
 fi
 
-dnl
-dnl Check whether __cpuid_count is available
-dnl
+dnl Check whether __cpuid_count is available.
 AC_CACHE_CHECK(whether __cpuid_count is available, ac_cv_cpuid_count_available, [
 AC_LINK_IFELSE([AC_LANG_PROGRAM([[
   #include <cpuid.h>