FYI, I love indices :)

[Akim Demaille]

BUt it seems I like them too much.  BTW, for some reason, make pdf
produces a PDF which, when read with acroread, has killed my machine
after having swallowed all the swap.  It was when browsing the
`Programs and Functions Index'.

Index: ChangeLog
from  Akim Demaille  <address@hidden>
        * doc/Makefile.am (fu): New index, can't use fn because of defmac.
        Use it.

2001-08-15  Akim Demaille  <address@hidden>

Index: doc/Makefile.am
===================================================================
RCS file: /cvs/autoconf/doc/Makefile.am,v
retrieving revision 1.22
diff -u -u -r1.22 Makefile.am
--- doc/Makefile.am 2001/08/15 12:34:16 1.22
+++ doc/Makefile.am 2001/08/15 13:22:30
@@ -32,6 +32,7 @@
             autoconf.ev autoconf.evs autoconf.ac autoconf.acs \
              autoconf.ov autoconf.ovs autoconf.ms autoconf.mss \
             autoconf.at autoconf.ats autoconf.pr autoconf.prs \
+            autoconf.fu autoconf.fus \
             autoconf.tmp \
             autoconf*.html standards*.html \
             autoconf*.pdf standards*.pdf
Index: doc/Makefile.in
===================================================================
RCS file: /cvs/autoconf/doc/Makefile.in,v
retrieving revision 1.106
diff -u -u -r1.106 Makefile.in
--- doc/Makefile.in 2001/08/15 12:34:16 1.106
+++ doc/Makefile.in 2001/08/15 13:22:30
@@ -76,7 +76,7 @@
 
 # Files from texi2dvi that should be removed, but which Automake does
 # not know.
-CLEANFILES = autoconf.cvs           autoconf.ev autoconf.evs autoconf.ac 
autoconf.acs              autoconf.ov autoconf.ovs autoconf.ms autoconf.mss     
   autoconf.at autoconf.ats autoconf.pr autoconf.prs       autoconf.tmp         
   autoconf*.html standards*.html          autoconf*.pdf standards*.pdf
+CLEANFILES = autoconf.cvs           autoconf.ev autoconf.evs autoconf.ac 
autoconf.acs              autoconf.ov autoconf.ovs autoconf.ms autoconf.mss     
   autoconf.at autoconf.ats autoconf.pr autoconf.prs       autoconf.fu 
autoconf.fus        autoconf.tmp            autoconf*.html standards*.html      
    autoconf*.pdf standards*.pdf
 
 mkinstalldirs = $(SHELL) $(top_srcdir)/config/mkinstalldirs
 CONFIG_CLEAN_FILES = 
Index: doc/autoconf.texi
===================================================================
RCS file: /cvs/autoconf/doc/autoconf.texi,v
retrieving revision 1.505
diff -u -u -r1.505 autoconf.texi
--- doc/autoconf.texi 2001/08/15 12:34:16 1.505
+++ doc/autoconf.texi 2001/08/15 13:22:32
@@ -107,9 +107,24 @@
 @c portability sections and so on.
 @defindex pr
 
address@hidden Put the programs and funcions into their own index.
address@hidden fn pr
address@hidden Define an index for functions: `alloca' etc.  Used for the
address@hidden portability sections and so on.  We can't use `fn' (aka 
`fnindex),
address@hidden since address@hidden' goes into it => we'd get all the macros 
too.
 
address@hidden   FIXME: Aaarg!  It seems there are too many indices for TeX :(
address@hidden
address@hidden   ! No room for a new @write .
address@hidden   l.112 @defcodeindex fu
address@hidden
address@hidden   so don't define yet another one :(  Just put some tags before 
each
address@hidden   @prindex which is actually a @funindex.
address@hidden
address@hidden   @defcodeindex fu
address@hidden
address@hidden
address@hidden   @c Put the programs and funcions into their own index.
address@hidden   @syncodeindex fu pr
+
 
 @node Top, Introduction, (dir), (dir)
 @comment  node-name,  next,  previous,  up
@@ -3238,13 +3253,15 @@
 
 @table @asis
 @item @code{sprintf}
address@hidden sprintf
address@hidden @fuindex sprintf
address@hidden @code{sprintf}
 The ISO C standard says @code{sprintf} and @code{vsprintf} return the
 number of characters written, but on some old systems (SunOS for
 instance) they return the buffer pointer instead.
 
 @item @code{unlink}
address@hidden unlink
address@hidden @fuindex unlink
address@hidden @code{unlink}
 The @sc{posix} spec says that @code{unlink} causes the given files to be
 removed only after there are no more open file handles for it.  Not all
 OS's support this behaviour though.  So even on systems that provide
@@ -3268,6 +3285,8 @@
 @cvindex C_ALLOCA
 @cvindex HAVE_ALLOCA_H
 @ovindex ALLOCA
address@hidden @fuindex alloca
address@hidden @code{alloca}
 Check how to get @code{alloca}.  Tries to get a builtin version by
 checking for @file{alloca.h} or the predefined C preprocessor macros
 @code{__GNUC__} and @code{_AIX}.  If this macro finds @file{alloca.h},
@@ -3318,6 +3337,8 @@
 
 @defmac AC_FUNC_CHOWN
 @acindex FUNC_CHOWN
address@hidden @fuindex chown
address@hidden @code{chown}
 If the @code{chown} function is available and works (in particular, it
 should accept @option{-1} for @code{uid} and @code{gid}), define
 @code{HAVE_CHOWN}.
@@ -3327,6 +3348,8 @@
 @defmac AC_FUNC_CLOSEDIR_VOID
 @acindex FUNC_CLOSEDIR_VOID
 @cvindex CLOSEDIR_VOID
address@hidden @fuindex closedir
address@hidden @code{closedir}
 If the @code{closedir} function does not return a meaningful value,
 define @code{CLOSEDIR_VOID}.  Otherwise, callers ought to check its
 return value for an error indicator.
@@ -3334,12 +3357,16 @@
 
 @defmac AC_FUNC_ERROR_AT_LINE
 @acindex FUNC_ERROR_AT_LINE
address@hidden @fuindex error_at_line
address@hidden @code{error_at_line}
 If the @code{error_at_line} function is not found, require an
 @code{AC_LIBOBJ} replacement of @samp{error}.
 @end defmac
 
 @defmac AC_FUNC_FNMATCH
 @acindex FUNC_FNMATCH
address@hidden @fuindex fnmatch
address@hidden @code{fnmatch}
 If the @code{fnmatch} function is available and works (unlike the one on
 Solaris 2.4), define @code{HAVE_FNMATCH}.
 @end defmac
@@ -3350,6 +3377,10 @@
 @cvindex HAVE_WORKING_FORK
 @cvindex HAVE_WORKING_VFORK
 @cvindex vfork
address@hidden @fuindex fork
address@hidden @code{fork}
address@hidden @fuindex vfork
address@hidden @code{vfork}
 This macro checks for the @code{fork} and @code{vfork} functions. If a
 working @code{fork} is found, define @code{HAVE_WORKING_FORK}. This macro
 checks whether @code{fork} is just a stub by trying to run it.
@@ -3379,6 +3410,8 @@
 @defmac AC_FUNC_FSEEKO
 @acindex FUNC_FSEEKO
 @cvindex _LARGEFILE_SOURCE
address@hidden @fuindex fseeko
address@hidden @code{fseeko}
 If the @code{fseeko} function is available, define @code{HAVE_FSEEKO}.
 Define @code{_LARGEFILE_SOURCE} if necessary.
 @end defmac
@@ -3386,6 +3419,8 @@
 @defmac AC_FUNC_GETGROUPS
 @acindex FUNC_GETGROUPS
 @ovindex GETGROUPS_LIBS
address@hidden @fuindex getgroups
address@hidden @code{getgroups}
 If the @code{getgroups} function is available and works (unlike on
 Ultrix 4.3, where @samp{getgroups (0, 0)} always fails), define
 @code{HAVE_GETGROUPS}.  Set @code{GETGROUPS_LIBS} to any libraries
@@ -3407,6 +3442,8 @@
 @ovindex NEED_SETGID
 @ovindex KMEM_GROUP
 @ovindex GETLOADAVG_LIBS
address@hidden @fuindex getloadavg
address@hidden @code{getloadavg}
 Check how to get the system load averages.  If the system has the
 @code{getloadavg} function, define @code{HAVE_GETLOADAVG}, and set
 @code{GETLOADAVG_LIBS} to any libraries needed to get that function.
@@ -3445,6 +3482,8 @@
 @defmac AC_FUNC_GETMNTENT
 @acindex FUNC_GETMNTENT
 @cvindex HAVE_GETMNTENT
address@hidden @fuindex getmntent
address@hidden @code{getmntent}
 Check for @code{getmntent} in the @file{sun}, @file{seq}, and @file{gen}
 libraries, for Irix 4, PTX, and Unixware, respectively.  Then, if
 @code{getmntent} is available, define @code{HAVE_GETMNTENT}.
@@ -3453,6 +3492,8 @@
 @defmac AC_FUNC_GETPGRP
 @acindex FUNC_GETPGRP
 @cvindex GETPGRP_VOID
address@hidden @fuindex getpgrp
address@hidden @code{getpgrp}
 If @code{getpgrp} takes no argument (the @sc{posix.1} version), define
 @code{GETPGRP_VOID}.  Otherwise, it is the @sc{bsd} version, which takes
 a process ID as an argument.  This macro does not check whether
@@ -3463,6 +3504,8 @@
 @defmac AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
 @acindex FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
 @cvindex LSTAT_FOLLOWS_SLASHED_SYMLINK
address@hidden @fuindex lstat
address@hidden @code{lstat}
 If @file{link} is a symbolic link, then @code{lstat} should treat
 @file{link/} the same as @file{link/.}.  However, many older
 @code{lstat} implementations incorrectly ignore trailing slashes.
@@ -3478,6 +3521,8 @@
 
 @defmac AC_FUNC_MALLOC
 @acindex FUNC_MALLOC
address@hidden @fuindex malloc
address@hidden @code{malloc}
 If the @code{malloc} works correctly (@samp{malloc (0)} returns a valid
 pointer), define @code{HAVE_MALLOC}.
 @end defmac
@@ -3485,6 +3530,8 @@
 @defmac AC_FUNC_MEMCMP
 @acindex FUNC_MEMCMP
 @ovindex LIBOBJS
address@hidden @fuindex memcmp
address@hidden @code{memcmp}
 If the @code{memcmp} function is not available, or does not work on
 8-bit data (like the one on SunOS 4.1.3), or fails when comparing 16
 bytes or more and with at least one buffer not starting on a 4-byte
@@ -3495,6 +3542,8 @@
 @defmac AC_FUNC_MKTIME
 @acindex FUNC_MKTIME
 @ovindex LIBOBJS
address@hidden @fuindex mktime
address@hidden @code{mktime}
 If the @code{mktime} function is not available, or does not work
 correctly, require an @code{AC_LIBOBJ} replacement for @samp{mktime}.
 @end defmac
@@ -3502,6 +3551,8 @@
 @defmac AC_FUNC_MMAP
 @acindex FUNC_MMAP
 @cvindex HAVE_MMAP
address@hidden @fuindex mmap
address@hidden @code{mmap}
 If the @code{mmap} function exists and works correctly, define
 @code{HAVE_MMAP}.  Only checks private fixed mapping of already-mapped
 memory.
@@ -3520,6 +3571,8 @@
 @cvindex SELECT_TYPE_ARG1
 @cvindex SELECT_TYPE_ARG234
 @cvindex SELECT_TYPE_ARG5
address@hidden @fuindex select
address@hidden @code{select}
 Determines the correct type to be passed for each of the
 @code{select} function's arguments, and defines those types
 in @code{SELECT_TYPE_ARG1}, @code{SELECT_TYPE_ARG234}, and
@@ -3531,6 +3584,8 @@
 @defmac AC_FUNC_SETPGRP
 @acindex FUNC_SETPGRP
 @cvindex SETPGRP_VOID
address@hidden @fuindex setpgrp
address@hidden @code{setpgrp}
 If @code{setpgrp} takes no argument (the @sc{posix.1} version), define
 @code{SETPGRP_VOID}.  Otherwise, it is the @sc{bsd} version, which takes
 two process IDs as arguments.  This macro does not check whether
@@ -3544,6 +3599,10 @@
 @acindex FUNC_LSTAT
 @cvindex HAVE_STAT_EMPTY_STRING_BUG
 @cvindex HAVE_LSTAT_EMPTY_STRING_BUG
address@hidden @fuindex stat
address@hidden @code{stat}
address@hidden @fuindex lstat
address@hidden @code{lstat}
 Determine whether @code{stat} or @code{lstat} have the bug that it
 succeeds when given the zero-length file name argument.  The @code{stat}
 and @code{lstat} from SunOS 4.1.4 and the Hurd (as of 1998-11-01) do
@@ -3557,6 +3616,8 @@
 @defmac AC_FUNC_SETVBUF_REVERSED
 @acindex FUNC_SETVBUF_REVERSED
 @cvindex SETVBUF_REVERSED
address@hidden @fuindex setvbuf
address@hidden @code{setvbuf}
 If @code{setvbuf} takes the buffering type as its second argument and
 the buffer pointer as the third, instead of the other way around, define
 @code{SETVBUF_REVERSED}.
@@ -3565,6 +3626,8 @@
 @defmac AC_FUNC_STRCOLL
 @acindex FUNC_STRCOLL
 @cvindex HAVE_STRCOLL
address@hidden @fuindex strcoll
address@hidden @code{strcoll}
 If the @code{strcoll} function exists and works correctly, define
 @code{HAVE_STRCOLL}.  This does a bit more than
 @samp{AC_CHECK_FUNCS(strcoll)}, because some systems have incorrect
@@ -3574,6 +3637,8 @@
 @defmac AC_FUNC_STRTOD
 @acindex FUNC_STRTOD
 @ovindex POW_LIB
address@hidden @fuindex strtod
address@hidden @code{strtod}
 If the @code{strtod} function does not exist or doesn't work correctly,
 ask for an @code{AC_LIBOBJ} replacement of @samp{strtod}.  In this case,
 because @file{strtod.c} is likely to need @samp{pow}, set the output
@@ -3584,6 +3649,8 @@
 @acindex FUNC_STRERROR_R
 @cvindex HAVE_STRERROR_R
 @cvindex HAVE_WORKING_STRERROR_R
address@hidden @fuindex strerror_r
address@hidden @code{strerror_r}
 If @code{strerror_r} is available, define @code{HAVE_STRERROR_R}.  If
 its implementation correctly returns a @code{char *}, define
 @code{HAVE_WORKING_STRERROR_R}.  On at least DEC UNIX 4.0[A-D] and HP-UX
@@ -3595,6 +3662,8 @@
 @defmac AC_FUNC_STRFTIME
 @acindex FUNC_STRFTIME
 @cvindex HAVE_STRFTIME
address@hidden @fuindex strftime
address@hidden @code{strftime}
 Check for @code{strftime} in the @file{intl} library, for SCO @sc{unix}.
 Then, if @code{strftime} is available, define @code{HAVE_STRFTIME}.
 @end defmac
@@ -3602,6 +3671,8 @@
 @defmac AC_FUNC_UTIME_NULL
 @acindex FUNC_UTIME_NULL
 @cvindex HAVE_UTIME_NULL
address@hidden @fuindex utime
address@hidden @code{utime}
 If @samp{utime(@var{file}, NULL)} sets @var{file}'s timestamp to
 the present, define @code{HAVE_UTIME_NULL}.
 @end defmac
@@ -3610,6 +3681,8 @@
 @acindex FUNC_VPRINTF
 @cvindex HAVE_VPRINTF
 @cvindex HAVE_DOPRNT
address@hidden @fuindex vprintf
address@hidden @code{vprintf}
 If @code{vprintf} is found, define @code{HAVE_VPRINTF}.  Otherwise, if
 @code{_doprnt} is found, define @code{HAVE_DOPRNT}.  (If @code{vprintf}
 is available, you may assume that @code{vfprintf} and @code{vsprintf}