-2005-1-9 Peter O'Gorman <peter@pogma.com>
+2005-01-09 Gary V. Vaughan <gary@gnu.org>
- * config/ltmain.m4sh (func_extract_archives,func_extract_an_archive):
- On darwin, uniq can not take the flags -cd together, thanks to Ralf
- for the fix, also ar does not accept N, so we use the fact that
- ar x libfoo.a foo.o will always extract the first foo.o in the
- archive and we then delete foo.o from the archive, which will also
- delete only the first foo.o, then rinse and repeat.
+ * ChangeLog: Reformatting.
+ * HACKING: Fix section numbering.
+ (Editing 'ChangeLog'): New notes on ChangeLog entry format.
+
+2005-01-09 Peter O'Gorman <peter@pogma.com>
+
+ * config/ltmain.m4sh (func_extract_archives)
+ (func_extract_an_archive): On darwin, uniq can not take the flags
+ -cd together, thanks to Ralf for the fix, also ar does not accept
+ N, so we use the fact that ar x libfoo.a foo.o will always extract
+ the first foo.o in the archive and we then delete foo.o from the
+ archive, which will also delete only the first foo.o, then rinse
+ and repeat.
2004-12-30 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* config/getopt.m4sh (func_version, func_usage, func_help):
Use `$SED -n' instead of `$SED RANGE {..}; d' as AIX sed cannot
- handle the latter.
+ handle the latter.
(func_help): start autoconf and automake in subshells to avoid
error messages from ash or Bourne shell if not available.
* Makefile.am, bootstrap, clcommit.m4sh, libtoolize.m4sh,
config/ltmain.m4sh: Replace `set --' with `set dummy [...]; shift'
- for portability. tests/sh.test: Test for this.
+ for portability.
+ * tests/sh.test: Test for this.
2004-12-28 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
- * libtoolize.m4sh, config/ltmain.m4sh (most functions):
- New variable $opt_debug is either `:' or `set -x' depending on --debug.
- Execute at most function entries to cater for ksh which resets `-x'.
+ * libtoolize.m4sh, config/ltmain.m4sh (most functions): New
+ variable $opt_debug is either `:' or `set -x' depending on
+ --debug. Execute at most function entries to cater for ksh which
+ resets `-x'.
* tests/defs.m4sh: Ditto for VERBOSE=debug.
- * m4/libtool.m4 (_LT_LINKER_SHLIBS)
- [cygwin, mingw, pw32 ]: _LT_TAGVAR missing for `fix_srcfile_path'.
- [ sysv4, sysv5 ]: _LT_TAGVAR missing for `export_dynamic_flag_spec'.
+ * m4/libtool.m4 (_LT_LINKER_SHLIBS) [cygwin, mingw, pw32]:
+ _LT_TAGVAR missing for `fix_srcfile_path'.
+ [sysv4, sysv5]: _LT_TAGVAR missing for
+ `export_dynamic_flag_spec'.
* doc/libtool.texi (all over): Use @option and @command.
Some more minor formatting updates, typos.
- * m4/libtool.m4 (_LT_PROG_ECHO_BACKSLASH): Fix variable
- quoting; allows lt_ECHO to match --fallback-echo again.
+ * m4/libtool.m4 (_LT_PROG_ECHO_BACKSLASH): Fix variable quoting;
+ allows lt_ECHO to match --fallback-echo again.
* config/ltmain.m4sh (func_extract_archives): Not all shells grok
`read -r' (unnecessary in this case).
Reported by Ralf Menzel <menzel@ls6.cs.uni-dortmund.de>.
- * config/general.m4sh: New variable quote_scanset..
- (func_quote_for_eval, func_quote_for_expand) ..use it to work around
- SunOS ksh `case' backslash-escaping bug: protect character class by
- variable expansion. Reported by Alexander Kurz <alexander.kurz@qsc.de>.
+ * config/general.m4sh: New variable quote_scanset...
+ (func_quote_for_eval, func_quote_for_expand): ...use it to work
+ around SunOS ksh `case' backslash-escaping bug: protect character
+ class by variable expansion.
+ Reported by Alexander Kurz <alexander.kurz@qsc.de>.
* tests/quote.test: Restart under the correct shell (the one
$ECHO was computed for).
2004-12-20 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
- * libtoolize.m4sh: Install `install-sh' as well, needed for configure ..
- * Makefile.am, Makefile.maint: .. install, update it.
- * NEWS, doc/libtool.texi (Distributing): .. document it.
+ * libtoolize.m4sh: Install `install-sh' as well, needed for
+ configure.
+ * Makefile.am, Makefile.maint: Install, update it.
+ * NEWS, doc/libtool.texi (Distributing): Document it.
Reported by Ross Boylan <ross@biostat.ucsf.edu>.
- * m4/libtool.m4 [solaris] (_LT_LINKER_SHLIBS): Add '${wl}-z ${wl}text'
- to archive_cmds and archive_expsyms_cmds. I.e., do not allow nopic in
- shared libraries.
+ * m4/libtool.m4 (_LT_LINKER_SHLIBS) [solaris]: Add '${wl}-z
+ ${wl}text' to archive_cmds and archive_expsyms_cmds. I.e., do not
+ allow nopic in shared libraries.
- * m4/libtool.m4 [solaris] (_LT_LINKER_SHLIBS): Change no_undefined_flag
- back to ' -z defs'. Problems with linking against libgcc.a will have
- to be resolved differently.
+ * m4/libtool.m4 (_LT_LINKER_SHLIBS) [solaris]: Change
+ no_undefined_flag back to ' -z defs'. Problems with linking
+ against libgcc.a will have to be resolved differently.
* tests/demo-nopic.test [solaris, sunos]: Skip test.
2004-12-18 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
- * libtool.m4 [linux] (_LT_COMPILER_PIC, _LT_LANG_CXX_CONFIG):
- Match icpc* and ecpc* (ia64 version of icpc) instead of only icpc.
+ * libtool.m4 (_LT_COMPILER_PIC, _LT_LANG_CXX_CONFIG) [linux]:
+ Match icpc* and ecpc* (ia64 version of icpc) instead of only
+ icpc.
- * libltdl/lt__dirent.c [mingw] (opendir): Fix write of constant
+ * libltdl/lt__dirent.c (opendir) [mingw]: Fix write of constant
strings past end of buffer.
(opendir, readdir): Fix read past end of buffer.
2004-12-13 Albert Chin-A-Young <china@thewrittenword.com>
* libtool.m4 (_LT_LINKER_SHLIBS, _LT_LANG_CXX_CONFIG):
- Append -G to link command-line on AIX to honor -brtl on command-line
- (runtime linking). Already done for IBM C/C++ compilers.
+ Append -G to link command-line on AIX to honor -brtl on
+ command-line (runtime linking). Already done for IBM C/C++
+ compilers.
2004-12-13 Bob Friesenhahn <bfriesen@simple.dallas.tx.us>
2004-12-09 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
- * config/ltmain.m4sh (func_mode_finish) [solaris]: Fix [] escaping bug.
+ * config/ltmain.m4sh (func_mode_finish) [solaris]: Fix [] escaping
+ bug.
2004-12-02 Bob Friesenhahn <bfriesen@simple.dallas.tx.us>
* m4/ltdl.m4 (LT_LIB_DLLOAD): Define HAVE_LIBDLLOADER if we
have a dlloader to preload.
- * libltdl/ltdl.c (lt_dlinit): Only preload if HAVE_LIBDLLOADER, only
- declare preloaded_symbols then. Fixes libltdl on static platforms.
+ * libltdl/ltdl.c (lt_dlinit): Only preload if HAVE_LIBDLLOADER,
+ only declare preloaded_symbols then. Fixes libltdl on static
+ platforms.
* NEWS: Updated.
2004-11-28 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2004-11-24 Jeff Squyres <jsquyres@lam-mpi.org>
- * m4/libtool.m4 [linux] (_LT_COMPILER_PIC, _LT_LINKER_SHLIBS,
- _LT_LANG_CXX_CONFIG), NEWS, THANKS: Support for Portland Group
- (aka "pgi") compilers.
+ * m4/libtool.m4 (_LT_COMPILER_PIC, _LT_LINKER_SHLIBS)
+ (_LT_LANG_CXX_CONFIG) [linux]: Support for Portland Group (aka
+ "pgi") compilers.
+ * NEWS, THANKS: Updated.
2004-11-23 Gary V. Vaughan <gary@gnu.org>
2004-11-23 Peter O'Gorman <peter@pogma.com>
Do not require that libtoolize --ltdl=/some/path end in libltdl.
- Move most libltdl headers to libtldl/libltdl to allow
+ Move most libltdl headers to libtldl/libltdl to allow
`#include <libltdl/ltdl.h>' to always work:
- * libltdl/Makefile.am, libltdl/loaders/Makefile.am: Look for includes
- in the new location.
- * libltdl/libltdl/lt__alloc.h, libltdl/libltdl/lt__dirent.h,
+ * libltdl/Makefile.am, libltdl/loaders/Makefile.am: Look for
+ includes in the new location.
+ * libltdl/libltdl/lt__alloc.h, libltdl/libltdl/lt__dirent.h,
libltdl/libltdl/lt__glibc.h, libltdl/libltdl/lt__private.h,
libltdl/libltdl/lt_dlloader.h, libltdl/libltdl/lt_error.h,
libltdl/libltdl/lt_system.h, libltdl/libltdl/ltdl.h,
libltdl/libltdl/slist.h: Added files, moved from libtdl/.
* libltdl/lt__alloc.h, libltdl/lt__dirent.h, libltdl/lt__glibc.h,
libltdl/lt__private.h, libltdl/lt_dlloader.h, libltdl/lt_error.h,
- libltdl/lt_system.h, libltdl/ltdl.h, libltdl/slist.h: Removed, moved
- to libltdl/libltdl.
+ libltdl/lt_system.h, libltdl/ltdl.h, libltdl/slist.h: Removed,
+ moved to libltdl/libltdl.
2004-11-23 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2004-11-18 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
- * m4/libtool.m4 (_LT_LINKER_SHLIBS) [cygwin/mingw/pw32]:
+ * m4/libtool.m4 (_LT_LINKER_SHLIBS) [cygwin, mingw, pw32]:
tag-protect setting of ld_shlibs.
2004-11-17 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
2004-11-17 Mats Rynge <rynge@isi.edu>
* libtool.m4 [linux]: Use only the CC basename in case statment
- when checking for icc/ecc. Allows for setting CC to the full path
+ when checking for icc/ecc. Allows for setting CC to the full path
to the compiler.
* libtool.m4 [solaris]: Added missing 'with linker' flags to
Fix error message with `-objectlist' file that does not exist.
* tests/objectlist.test: New test for this.
- * Makefile.am: config/ltmain.sh is generated by config/ltmain.m4sh.
+ * Makefile.am: config/ltmain.sh is generated by
+ config/ltmain.m4sh.
2004-11-09 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* Changes other than bug fixes must be mentioned in NEWS
-2. Test Suite
+3. Test Suite
=============
* Use "make check" liberally, on as many platforms as you can. Use as
many compilers and linkers you can.
-3. Naming
+4. Naming
=========
* We've adopted the convention that exported Autoconf macros should be
with the `_lt_' macro namespace).
-4. Editing `.am' Files
+5. Editing 'ChangeLog'
+======================
+
+* When in doubt, check that emacs can syntax-color properly in
+ change-log-mode. And preferably use emacs 'C-x 4 a'
+ (add-change-log-entry-other-window) to open ChangeLog with an
+ appropriate new template.
+
+* If this change is by a different author, or on a different date to the
+ last entry start a new entry at the top of the file with the format
+ (note two spaces between each field):
+
+yyyy-mm-dd Name of Author <email@address>
+
+* 'Name of Author' is the name of the person who made the change being
+ documented, or if that person didn't supply a ChangeLog, the author
+ of the ChangeLog entry. If more than one person collaborated on the
+ change, additional authors can be listed on subsequent lines, thus:
+
+yyyy-mm-dd Name of Main Author <email@address>,
+ Name of Contributor <another@email.address>
+
+* Preferably the next part should be a description of the overall
+ purpose of the change, separated from the header by a blank line,
+ indented by 1 tab, and filled at column 72. The last character of the
+ description should be a colon, :.
+
+* If the author of the change is different from the author of the
+ ChangeLog, then the change outhor should be credited, separated from
+ the previous field by a blank line and indented by 1 tab (note, only
+ 1 space between fields here):
+
+ From Author of Actual Change <email@address>:
+
+* Changes to each file come next. Each new file starts on a new line,
+ indented by 1 tab and starting with an asterisk and a space. Multiple
+ files can be listed here relative to $top_srcdir, and comma separated.
+ Names of functions (or sections as appropriate) to which the change
+ applies should be named inside parentheses and comma separated. If
+ this goes beyond column 72, then parens should be closed and re-opened
+ on the next line:
+
+ * file, another/file, test/testcases/foo.test (func_foo)
+ (func_bar, func_baz): Description of changes.
+
+* If the change does not apply to particular functions (or sections),
+ the section list can be omitted:
+
+ * file, another/file, test/testcases/foo.test: General changes.
+
+* If the changes are particular to certain architectures, they should be
+ listed after the functions in square brackets:
+
+ * file, another/file (func_foo) [linux, solaris]: Description of
+ changes.
+
+* Subsequent changes in other files that are related to the same overall
+ enhancement or bugfix should be listed concurrently, without blank
+ lines. Always start a fresh line for a new file:
+
+ * file, another/file (func_foo) [linux, solaris]: Description of
+ changes.
+ * doc/foo.texi (Invoking Foo): Document.
+ * NEWS: Updated.
+
+* If the change is in response to a problem reported by someone other
+ than the author, then credit them at the end of the description with:
+
+ Reported by Reporter Name <email@address>.
+
+* See the GNU Coding Standards document for more details on ChangeLog
+ formatting.
+
+
+2005-01-08 Gary V. Vaughan <gary@gnu.org>,
+ Peter O'Gorman <peter@pogma.com>
+
+ This is the overall description of the purpose of this change
+ and any useful background for a model ChangeLog entry:
+
+ From Ralf Wildenhues <Ralf.Wildenhues@gmx.de>:
+ * HACKING: Updated copyright. This isn't attached to a
+ particular section of the file, so it comes first.
+ (Editing 'ChangeLog'): New section. This applies to the same
+ file, but since it applies to a particular section it starts on
+ a new line.
+ (Introduction, Maintenance Notes, Test Suite, Naming)
+ (Editing '.am' Files): If I had changed all these sections in
+ the same way, I can list them like this, being careful to close
+ and reopen the parentheses when starting a new line. The colon
+ only comes after the last section before this description.
+ * NEWS: Updated.
+ Reported by Bob Friesenhahn <bfriesen@simple.dallas.tx.us>.
+
+
+6. Editing `.am' Files
======================
* Always use $(...) and not ${...}
of the loop itself should print each "important" command it runs.
-5. Editing `.m4sh' Files
+7. Editing `.m4sh' Files
========================
* Use shell functions, but be careful not to assume local scope for
functions should begin indented by 4 spaces.
-6. Abstraction layers in libltdl
+8. Abstraction layers in libltdl
================================
* The libltdl API uses a layered approach to differentiate internal and
lt__private.h
-7. Release Procedure
+9. Release Procedure
====================
* If you are a libtool maintainer, but have not yet registered your
-7. Alpha release note template
-==============================
+10. Alpha release note template
+===============================
To: libtool@gnu.org, autotools-announce@gnu.org
Subject: GNU Libtool @VERSION@ released (alpha release).
-8. Full release note template
-=============================
+11. Full release note template
+==============================
To: info-gnu@gnu.org
Cc: libtool@gnu.org, autotools-announce@gnu.org
--
-Copyright (C) 2004 Free Software Foundation, Inc.
+Copyright (C) 2004, 2005 Free Software Foundation, Inc.
The canonical source of this file is maintained with the
GNU Libtool package. Report bugs to bug-libtool@gnu.org.