[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: some modernizations to the documentation (esp. VPATH builds)

From: Ralf Wildenhues
Subject: Re: some modernizations to the documentation (esp. VPATH builds)
Date: Mon, 5 Jun 2006 09:58:19 +0200
User-agent: Mutt/1.5.11+cvs20060403

Hi Paul,

* Paul Eggert wrote on Sun, Jun 04, 2006 at 09:44:25AM CEST:
> I installed the following patch to the Autoconf documentation to
> modernize things a bit.  The biggest deal is that this changes
> INSTALL to recommend only GNU make for VPATH builds.  I recently
> discovered that VPATH builds don't work for Solaris make.

Well, they do work.

> The problems are already well documented in the Autoconf manual.
> Rather than try to support them (which would be difficult -- it's
> mostly an Automake issue, I think) we might as well just warn people
> away from them.

I'm just a wee bit unhappy about this.  I think advising users to use
GNU make for VPATH builds is fine; I'd still like to encourage
developers to write portable's though, even if it's not
easy.  Oh well.  I'm not unhappy enough to write a patch for this.

> The patch also marks several macros as obsolescent; if you think they
> aren't obsolescent, please let me know.  (I have no current plans to
> remove these macros.)

Well, this makes autoscan output inconsistent with the documentation
now.  Also,
  AC_C_BACKSLASH_A has only been introduced in 2.54,
  AC_FUNC_LSTAT                                2.50,
  AC_FUNC_STAT                                 2.50,
  AC_FUNC_STRNLEN                              2.53.

And Gnulib only now added checks for strndup, which are of similar reach
as strnlen, and explicitly targetted to support AIX 5.1.  Furthermore,

  AC_FUNC_LSTAT has seen changes in 2.53,

So, yes, I have a problem with these, even if I don't *know* how
obsolescent some of these are in fact.  And I would have liked to start
building tarballs today.  Now I don't know what to do.  Given your
patch, it would only be consistent to apply the patch below.  But I
don't want to do that, it seems much too far-reaching to me.

I could just back out your complete patch.  But I don't want to do that
either, because it has other changes which are clearly good.  :-/


        * lib/autoscan/autoscan.list: Do not suggest obsolescent macros
        any more.

Index: lib/autoscan/autoscan.list
RCS file: /cvsroot/autoconf/autoconf/lib/autoscan/autoscan.list,v
retrieving revision 1.15
diff -u -r1.15 autoscan.list
--- lib/autoscan/autoscan.list  13 May 2006 09:55:13 -0000      1.15
+++ lib/autoscan/autoscan.list  5 Jun 2006 07:50:47 -0000
@@ -1,6 +1,6 @@
 # Automatically Generated: do not edit this file
 # autoscan's mapping to Autoconf macros      -*- Makefile -*-
-# Copyright (C) 1992, 1993, 1994, 1996, 1999, 2000, 2001, 2002
+# Copyright (C) 1992, 1993, 1994, 1996, 1999, 2000, 2001, 2002, 2006
 # Free Software Foundation, Inc.
 # This program is free software; you can redistribute it and/or modify
@@ -21,19 +21,14 @@
 function: __argz_next          AC_CHECK_FUNCS
 function: __argz_stringify             AC_CHECK_FUNCS
 function: __fpending           AC_CHECK_FUNCS
-function: _doprnt              AC_FUNC_VPRINTF
 function: acl          AC_CHECK_FUNCS
 function: alarm                AC_CHECK_FUNCS
 function: alloca               AC_FUNC_ALLOCA
 function: atexit               AC_CHECK_FUNCS
-function: bcmp         AC_HEADER_STDC
-function: bcopy                AC_HEADER_STDC
 function: btowc                AC_CHECK_FUNCS
 function: bzero                AC_CHECK_FUNCS
-function: bzero                AC_HEADER_STDC
 function: chown                AC_FUNC_CHOWN
 function: clock_gettime                AC_CHECK_FUNCS
-function: closedir             AC_FUNC_CLOSEDIR_VOID
 function: dcgettext            AM_GNU_GETTEXT
 function: doprnt               AC_CHECK_FUNCS
 function: dup2         AC_CHECK_FUNCS
@@ -66,22 +61,18 @@
 function: getmntinfo           AC_CHECK_FUNCS
 function: getpagesize          AC_CHECK_FUNCS
 function: getpass              AC_CHECK_FUNCS
-function: getpgrp              AC_FUNC_GETPGRP
 function: getspnam             AC_CHECK_FUNCS
 function: gettimeofday         AC_CHECK_FUNCS
 function: getusershell         AC_CHECK_FUNCS
 function: getwd                warn: getwd is deprecated, use getcwd instead
 function: hasmntopt            AC_CHECK_FUNCS
-function: index                AC_HEADER_STDC
 function: inet_ntoa            AC_CHECK_FUNCS
-function: ioctl                AC_PROG_GCC_TRADITIONAL
 function: isascii              AC_CHECK_FUNCS
 function: iswprint             AC_CHECK_FUNCS
 function: lchown               AC_CHECK_FUNCS
 function: listmntent           AC_CHECK_FUNCS
 function: localeconv           AC_CHECK_FUNCS
 function: localtime_r          AC_CHECK_FUNCS
-function: lstat                AC_FUNC_LSTAT
 function: lstat                AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
 function: major                AC_HEADER_MAJOR
 function: makedev              AC_HEADER_MAJOR
@@ -90,14 +81,9 @@
 function: mbrlen               AC_CHECK_FUNCS
 function: mbrtowc              AC_FUNC_MBRTOWC
 function: memchr               AC_CHECK_FUNCS
-function: memchr               AC_HEADER_STDC
-function: memcmp               AC_FUNC_MEMCMP
-function: memcpy               AC_HEADER_STDC
 function: memmove              AC_CHECK_FUNCS
-function: memmove              AC_HEADER_STDC
 function: mempcpy              AC_CHECK_FUNCS
 function: memset               AC_CHECK_FUNCS
-function: memset               AC_HEADER_STDC
 function: minor                AC_HEADER_MAJOR
 function: mkdir                AC_CHECK_FUNCS
 function: mkfifo               AC_CHECK_FUNCS
@@ -118,21 +104,16 @@
 function: regcmp               AC_CHECK_FUNCS
 function: regcomp              AC_CHECK_FUNCS
 function: resolvepath          AC_CHECK_FUNCS
-function: rindex               AC_HEADER_STDC
 function: rint         AC_CHECK_FUNCS
 function: rmdir                AC_CHECK_FUNCS
 function: rpmatch              AC_CHECK_FUNCS
 function: select               AC_CHECK_FUNCS
-function: select               AC_FUNC_SELECT_ARGTYPES
 function: setenv               AC_CHECK_FUNCS
 function: sethostname          AC_CHECK_FUNCS
 function: setlocale            AC_CHECK_FUNCS
-function: setpgrp              AC_FUNC_SETPGRP
-function: setvbuf              AC_FUNC_SETVBUF_REVERSED
 function: signal               AC_TYPE_SIGNAL
 function: socket               AC_CHECK_FUNCS
 function: sqrt         AC_CHECK_FUNCS
-function: stat         AC_FUNC_STAT
 function: stime                AC_CHECK_FUNCS
 function: stpcpy               AC_CHECK_FUNCS
 function: strcasecmp           AC_CHECK_FUNCS
@@ -142,10 +123,8 @@
 function: strdup               AC_CHECK_FUNCS
 function: strerror             AC_CHECK_FUNCS
 function: strerror_r           AC_FUNC_STRERROR_R
-function: strftime             AC_FUNC_STRFTIME
 function: strncasecmp          AC_CHECK_FUNCS
 function: strndup              AC_CHECK_FUNCS
-function: strnlen              AC_FUNC_STRNLEN
 function: strpbrk              AC_CHECK_FUNCS
 function: strrchr              AC_CHECK_FUNCS
 function: strspn               AC_CHECK_FUNCS
@@ -160,13 +139,9 @@
 function: tzset                AC_CHECK_FUNCS
 function: uname                AC_CHECK_FUNCS
 function: utime                AC_CHECK_FUNCS
-function: utime                AC_FUNC_UTIME_NULL
 function: utmpname             AC_CHECK_FUNCS
 function: utmpxname            AC_CHECK_FUNCS
 function: vfork                AC_FUNC_FORK
-function: vfprintf             AC_FUNC_VPRINTF
-function: vprintf              AC_FUNC_VPRINTF
-function: vsprintf             AC_FUNC_VPRINTF
 function: wait3                AC_FUNC_WAIT3
 function: wcwidth              AC_CHECK_FUNCS
 header: OS.h           AC_CHECK_HEADERS
@@ -174,11 +149,9 @@
 header: alloca.h               AC_FUNC_ALLOCA
 header: argz.h         AC_CHECK_HEADERS
 header: arpa/inet.h            AC_CHECK_HEADERS
-header: dirent.h               AC_HEADER_DIRENT
 header: fcntl.h                AC_CHECK_HEADERS
 header: fenv.h         AC_CHECK_HEADERS
 header: float.h                AC_CHECK_HEADERS
-header: float.h                AC_HEADER_STDC
 header: fs_info.h              AC_CHECK_HEADERS
 header: inttypes.h             AC_CHECK_HEADERS
 header: langinfo.h             AC_CHECK_HEADERS
@@ -190,7 +163,6 @@
 header: memory.h               AC_CHECK_HEADERS
 header: mntent.h               AC_CHECK_HEADERS
 header: mnttab.h               AC_CHECK_HEADERS
-header: ndir.h         AC_HEADER_DIRENT
 header: netdb.h                AC_CHECK_HEADERS
 header: netinet/in.h           AC_CHECK_HEADERS
 header: nl_types.h             AC_CHECK_HEADERS
@@ -199,18 +171,13 @@
 header: resolv.h               AC_HEADER_RESOLV
 header: sgtty.h                AC_CHECK_HEADERS
 header: shadow.h               AC_CHECK_HEADERS
-header: stdarg.h               AC_HEADER_STDC
 header: stddef.h               AC_CHECK_HEADERS
-header: stddef.h               AC_HEADER_STDC
 header: stdint.h               AC_CHECK_HEADERS
 header: stdio_ext.h            AC_CHECK_HEADERS
 header: stdlib.h               AC_CHECK_HEADERS
-header: stdlib.h               AC_HEADER_STDC
 header: string.h               AC_CHECK_HEADERS
-header: string.h               AC_HEADER_STDC
 header: strings.h              AC_CHECK_HEADERS
 header: sys/acl.h              AC_CHECK_HEADERS
-header: sys/dir.h              AC_HEADER_DIRENT
 header: sys/file.h             AC_CHECK_HEADERS
 header: sys/filsys.h           AC_CHECK_HEADERS
 header: sys/fs/s5param.h               AC_CHECK_HEADERS
@@ -220,7 +187,6 @@
 header: sys/mkdev.h            AC_HEADER_MAJOR
 header: sys/mntent.h           AC_CHECK_HEADERS
 header: sys/mount.h            AC_CHECK_HEADERS
-header: sys/ndir.h             AC_HEADER_DIRENT
 header: sys/param.h            AC_CHECK_HEADERS
 header: sys/socket.h           AC_CHECK_HEADERS
 header: sys/statfs.h           AC_CHECK_HEADERS
@@ -229,7 +195,6 @@
 header: sys/time.h             AC_CHECK_HEADERS
 header: sys/timeb.h            AC_CHECK_HEADERS
 header: sys/vfs.h              AC_CHECK_HEADERS
-header: sys/wait.h             AC_HEADER_SYS_WAIT
 header: sys/window.h           AC_CHECK_HEADERS
 header: syslog.h               AC_CHECK_HEADERS
 header: termio.h               AC_CHECK_HEADERS
@@ -241,15 +206,7 @@
 header: values.h               AC_CHECK_HEADERS
 header: wchar.h                AC_CHECK_HEADERS
 header: wctype.h               AC_CHECK_HEADERS
-identifier: S_ISBLK            AC_HEADER_STAT
-identifier: S_ISCHR            AC_HEADER_STAT
-identifier: S_ISDIR            AC_HEADER_STAT
-identifier: S_ISFIFO           AC_HEADER_STAT
-identifier: S_ISLNK            AC_HEADER_STAT
-identifier: S_ISREG            AC_HEADER_STAT
-identifier: S_ISSOCK           AC_HEADER_STAT
 identifier: bool               AC_HEADER_STDBOOL
-identifier: const              AC_C_CONST
 identifier: false              AC_HEADER_STDBOOL
 identifier: gid_t              AC_TYPE_UID_T
 identifier: inline             AC_C_INLINE
@@ -269,8 +226,6 @@
 identifier: st_blocks          AC_STRUCT_ST_BLOCKS
 identifier: st_rdev            AC_CHECK_MEMBERS([struct stat.st_rdev])
 identifier: sys_siglist                AC_CHECK_DECLS([sys_siglist])
-identifier: timeval            AC_HEADER_TIME
-identifier: tm         AC_STRUCT_TM
 identifier: tm_zone            AC_STRUCT_TIMEZONE
 identifier: true               AC_HEADER_STDBOOL
 identifier: uid_t              AC_TYPE_UID_T
@@ -278,7 +233,6 @@
 identifier: uint32_t           AC_TYPE_UINT32_T
 identifier: uint64_t           AC_TYPE_UINT64_T
 identifier: uint8_t            AC_TYPE_UINT8_T
-identifier: volatile           AC_C_VOLATILE
 makevar: AWK           AC_PROG_AWK
 makevar: BISON         AC_PROG_YACC
 makevar: CC            AC_PROG_CC

reply via email to

[Prev in Thread] Current Thread [Next in Thread]