From 23d0336260c05f4725cceb543f06010bb64997c9 Mon Sep 17 00:00:00 2001 From: Ben Elliston Date: Wed, 25 Nov 2009 04:35:01 +0000 Subject: [PATCH] * README: Mention changes to Makefile.in and functions.texi. * gather-docs: Mention 'make stamp-functions' in the header. --- libiberty/ChangeLog | 6 ++++++ libiberty/README | 10 ++++++++-- libiberty/gather-docs | 2 +- 3 files changed, 15 insertions(+), 3 deletions(-) diff --git a/libiberty/ChangeLog b/libiberty/ChangeLog index 79e0462dd26..8fc5ac17344 100644 --- a/libiberty/ChangeLog +++ b/libiberty/ChangeLog @@ -1,3 +1,9 @@ +2009-11-25 Manuel Lopez-Ibanez + Ben Elliston + + * README: Mention changes to Makefile.in and functions.texi. + * gather-docs: Mention 'make stamp-functions' in the header. + 2009-11-23 Ben Elliston Ian Lance Taylor diff --git a/libiberty/README b/libiberty/README index 886bd67bc9d..9f1cc979e49 100644 --- a/libiberty/README +++ b/libiberty/README @@ -25,13 +25,14 @@ There are two sets of files: Those that are "required" will be included in the library for all configurations, while those that are "optional" will be included in the library only if "needed." -To add a new required file, edit Makefile to add the source file +To add a new required file, edit Makefile.in to add the source file name to CFILES and the object file to REQUIRED_OFILES. To add a new optional file, it must provide a single function, and the name of the function must be the same as the name of the file. - * Add the source file name to CFILES. + * Add the source file name to CFILES in Makefile.in and the object + file to CONFIGURED_OFILES. * Add the function to name to the funcs shell variable in configure.ac. @@ -48,6 +49,11 @@ name of the function must be the same as the name of the file. object file to LIBOBJS, and add the function name to the case controlling whether to define HAVE_func. +Finally, in the build directory of libiberty, configure with +"--enable-maintainer-mode", run "make maint-deps" to update +Makefile.in, and run 'make stamp-functions' to regenerate +functions.texi. + The optional file you've added (e.g. getcwd.c) should compile and work on all hosts where it is needed. It does not have to work or even compile on hosts where it is not needed. diff --git a/libiberty/gather-docs b/libiberty/gather-docs index be4dbbfc1e2..94d3fcf8f3a 100644 --- a/libiberty/gather-docs +++ b/libiberty/gather-docs @@ -110,7 +110,7 @@ print "Writing $outfile\n" if $verbose; print OUT "\@c Automatically generated from *.c and others (the comments before\n"; print OUT "\@c each entry tell you which file and where in that file). DO NOT EDIT!\n"; print OUT "\@c Edit the *.c files, configure with --enable-maintainer-mode,\n"; -print OUT "\@c and let gather-docs build you a new copy.\n\n"; +print OUT "\@c run 'make stamp-functions' and gather-docs will build a new copy.\n\n"; for $key (sort keys %name) { print OUT "\@c $src_file{$key}:$src_line{$key}\n"; -- 2.30.2