[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 Makefile.am'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,
AC_FUNC_SETVBUF_REVERSED 2.54.
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. :-/
Cheers,
Ralf
* 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