[Fwd] Documentation of AX_CXX_COMPILE_STDCXX_11 on Autoconf macro archives

[Peter Simons]

Forwarding this message to the respective macro's authors:

 | Subject: Documentation of AX_CXX_COMPILE_STDCXX_11 on Autoconf macro archives
 | Date: 2017-01-22 07:39
 | From: Robert Hairgrove <address@hidden>
 | To: address@hidden
 |
 | This is more of a documentation bug. In the introduction on this page,
 | it is mentioned that one must also install the macro
 | AX_CXX_COMPILE_STDCXX in order to use it:
 |
 | https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_11.html
 |
 | What is NOT mentioned is that it is also necessary to install
 | AX_REQUIRE_DEFINED if you don't already have it. I didn't have it, and
 | as a result got errors in configure about a "possibly undefined macro
 | AC_MSG_WARN". Fortunately, it was easy to spot by looking at the line
 | number in configure which appeared in the error message. But it would
 | have saved me some time if it had been mentioned in the same page.
 |
 | I am using version 2.69 of autoconf.

It's kind of ironic that the process fails because it lacks a macro
which's only purpose is to give a good error message in case a macro is
missing.

A quick call to "grep" reveals that there might be other candidates for
an extension of the documentation:

  ax_append_compile_flags.m4
  ax_append_link_flags.m4
  ax_cflags_force_c89.m4
  ax_cflags_strict_prototypes.m4
  ax_cflags_warn_all.m4
  ax_compiler_flags_cflags.m4
  ax_compiler_flags_cxxflags.m4
  ax_compiler_flags_gir.m4
  ax_compiler_flags_ldflags.m4
  ax_compiler_flags.m4
  ax_cxx_compile_stdcxx_11.m4
  ax_cxx_compile_stdcxx_14.m4
  ax_cxx_compile_stdcxx_17.m4
  ax_cxx_compile_stdcxx.m4
  ax_with_curses.m4

Best regards,
Peter