NEWS, README: documented recent changes for the upcoming 2010.02.14 releasev2010.02.14

4 files changed, 67 insertions, 93 deletions

diff --git a/NEWS b/NEWS
index 0ff520c..c09e8ba 100644
--- a/NEWS
+++ b/NEWS
@@ -1,7 +1,7 @@
 #+TITLE: Autoconf Archive NEWS                 -*- mode:org;fill-column:79; -*-
 #+STARTUP: showall
 
-* Noteworthy changes in release ?.? (????-??-??) [?]
+* Noteworthy changes in release 2010.02.14 (2010-02-14) [beta]
 
   All macros have been assigned a unique serial number that corresponds to the
   number of commits that have modified the macro in the Archive's Git
@@ -32,6 +32,11 @@
 
   AX_SYS_LARGEFILE_SENSITIVE has improved support for x86_64 hosts.
 
+  AX_MPIP has been added.
+
+  In all macros, calls to the obsolete AC_HELP_STRING function have been
+  replaced with the newer, recommended AS_HELP_STRING.
+
 * Noteworthy changes in release 2009.12.16 (2009-12-16) [alpha]
 
   All macros that used a prefix other than AX_ -- or no prefix at all -- have
diff --git a/README b/README
index a57ebe7..af52355 100644
--- a/README
+++ b/README
@@ -1,94 +1,68 @@
 Autoconf Archive
 ================
 
--------------------------------------------------------------------------------
+The Autoconf Archive is a collection of more than 450 freely re-usable macros
+for `GNU Autoconf <http://www.gnu.org/software/autoconf>`_ that have been
+contributed by friendly supporters of the cause from all over the Internet.
 
-:Macro Index By:  Category_ ; Author_ ; License_
-:Latest Release:  autoconf-archive-2009.12.16.tar.bz2_
-:Change History:  `ATOM Log`_ ; `RSS Feed`_
-:GIT Repository:  git clone git://git.sv.gnu.org/autoconf-archive.git
+The term "free" means two things in this context: (1) all macros distributed by
+the Archive can be used free of charge and (2) their use imposes no restrictions
+whatsoever on the licensing of the generated `configure` script, i.e. it is
+possible to use those macros in `configure` scripts that are meant for non-free
+software.
 
--------------------------------------------------------------------------------
+The best place to start exploring the Archive is the `on-line documentation
+<http://www.nongnu.org/autoconf-archive/>`_. There is also the `Autoconf Archive
+home page <http://savannah.nongnu.org/projects/autoconf-archive/>`_ at Savannah.
 
-Synopsis
---------
+Downloads
+---------
 
-The `Autoconf Archive`_ is a collection of more than 500 freely re-usable
-Autoconf_ macros. These macros have been contributed by friendly supporters
-of the cause from all over the Internet.
+Here are the compressed sources:
 
-How To Contribute
------------------
+* autoconf-archive-2010.02.14.tar.gz_   (785KB)
+* autoconf-archive-2010.02.14.tar.bz2_  (577KB)
+* autoconf-archive-2010.02.14.tar.xz_   (442KB)
 
-Please post to the `patch tracker`_ to submit a macro for inclusion in the
-archive. Your submission should contain:
+Here are the GPG detached signatures:
 
-* synopsis that shows how the macro must be be called,
+* autoconf-archive-2010.02.14.tar.gz.sig_
+* autoconf-archive-2010.02.14.tar.bz2.sig_
+* autoconf-archive-2010.02.14.tar.xz.sig_
 
-* brief description of the macro's purpose,
+You can use either of the above signature files to verify that the
+corresponding file (without the .sig suffix) is intact. First, be sure
+to download both the .sig file and the corresponding tarball. Then, run
+a command like this::
 
-* list of authors (optionally with e-mail addresses),
+  gpg --verify autoconf-archive-2010.02.14.tar.gz.sig
 
-* licensing terms, and
+If that command fails because you don't have the required public key,
+then run this command to import it::
 
-* m4 source code.
+  gpg --keyserver keys.gnupg.net --recv-keys 99089D72
 
-Macros can be submitted under any `GPL-compatible free software license`_.
-The Free Software Foundation, however, recommends use of the `all-permissive
-license`_ for Autoconf macros.
-
-Migration to Savannah
----------------------
-
-The Autoconf Archive is now hosted on Savannah. Previously cloned Git
-repositories can be migrated to the new location by updating the settings
-for "origin" and "master"::
-
-  git config remote.origin.url 'git://git.sv.gnu.org/autoconf-archive.git'
-  git config remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'
-
-  git config branch.master.remote origin
-  git config branch.master.merge refs/heads/master
-
-Now, run `git pull` to update the master branch.
+and rerun the `gpg --verify' command.
 
 License
 -------
 
-Compilation Copyright 2009 Autoconf Archive Maintainers <autoconf-archive-maintainers@nongnu.org>
+Compilation Copyright 2010 Autoconf Archive Maintainers <autoconf-archive-maintainers@nongnu.org>
 
-The Autoconf Archive is free software: you can redistribute it and/or
-modify it under the terms of the `GNU General Public License version 3
-<http://www.gnu.org/licenses/gpl.html>`_ or (at your option) any later
-version.
+The Autoconf Archive is free software: you can redistribute it and/or modify it
+under the terms of the `GNU General Public License version 3
+<http://www.gnu.org/licenses/gpl.html>`_ or (at your option) any later version.
 
 All macros are copyrighted by their respective authors. Please refer to the
 individual files for details.
 
 
-.. References used in the text above
-.. .................................
-
-.. _Autoconf Archive: http://www.nongnu.org/autoconf-archive/
-
-.. _Category: macros-by-category.html
-
-.. _Author: macros-by-author.html
-
-.. _License: macros-by-license.html
-
-.. _Git: http://git-scm.com/
-
-.. _RSS Feed: http://git.savannah.gnu.org/gitweb/?p=autoconf-archive.git;a=rss
-
-.. _ATOM Log: http://git.savannah.gnu.org/gitweb/?p=autoconf-archive.git;a=atom
-
-.. _Autoconf: http://www.gnu.org/software/autoconf/
-
-.. _autoconf-archive-2009.12.16.tar.bz2: http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2009.12.16.tar.bz2
-
-.. _GPL-compatible free software license: http://www.gnu.org/licenses/license-list.html
-
-.. _all-permissive license: http://www.gnu.org/prep/maintain/html_node/License-Notices-for-Other-Files.html
+.. References
+.. ..........
 
-.. _patch tracker: https://savannah.nongnu.org/patch/?func=additem&group=autoconf-archive
+.. _autoconf-archive-2010.02.14.tar.gz : http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2010.02.14.tar.gz
+.. _autoconf-archive-2010.02.14.tar.bz2: http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2010.02.14.tar.bz2
+.. _autoconf-archive-2010.02.14.tar.xz:  http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2010.02.14.tar.xz
+.. _autoconf-archive-2010.02.14.tar.gz.sig:  http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2010.02.14.tar.gz.sig
+.. _autoconf-archive-2010.02.14.tar.bz2.sig: http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2010.02.14.tar.bz2.sig
+.. _autoconf-archive-2010.02.14.tar.xz.sig:  http://download.savannah.nongnu.org/releases/autoconf-archive/autoconf-archive-2010.02.14.tar.xz.sig
diff --git a/README-maint b/README-maint
index e37673d..78a8b14 100644
--- a/README-maint
+++ b/README-maint
@@ -19,31 +19,27 @@
   : git clone ssh://[<login>@]git.sv.gnu.org/srv/git/autoconf-archive
   : cd autoconf-archive
   : cvs -z3 -d:ext:[<login>@]cvs.savannah.nongnu.org:/web/autoconf-archive co -d html autoconf-archive
-  # set up autotools and gnulib environment
-  : ./bootstrap.sh
-  # determine system properties
-  : ./configure
-  # create/update all generated files that will be in a release
-  : make maintainer-generate
-  # update texinfo documentation
-  : make
+  : ./bootstrap.sh              # set up autotools and gnulib environment
+  : ./configure                 # determine system properties
+  : make maintainer-generate    # create/update all generated files that will be in a release
+  : make                        # update texinfo documentation
 
 * How to update the web site.
 
-  Run "make generate". The process will typically re-generate a whole bunch of
-  files in the html/ directory (which is a separate CVS repository). Check the
-  diffs, and if you things look good, commit the changes.
+  Run the following commands:
 
-  Unfortunately, the new HTML generator doesn't yet recognize cross-links or
-  any other sort of URI (see TODO file). Until those features are implemented,
-  the website probably shouldn't be regenerated, because the old pages do
-  contain links and an update would overwrite them.
+  : make web-manual             # generate an HTML rendering of the user documentation
+  : ./fix-website.sh            # massage file names generated by texinfo
+  : cp doc/manual/html/* html/  # copy the new files into the CVS checkout
+  : (cd html ; cvs commit -m "generated from autoconf-archive $(git describe)")
 
 * How to make a release.
 
   1. Determine the appropriate version number, i.e. today's date in ISO
      formatting.
 
+  2. Update the date stamps in the README file.
+
   2. Update the NEWS file. The script that generates release tarballs checks
      that the current version number in mentioned in that file. If NEWS isn't
      up-to-date, the script will fail.
@@ -55,12 +51,12 @@
      : git tag v2009.07.31 -s -m 'Autoconf Archive Version 2009.07.31'
 
   4. Run "make </dev/null alpha". Other possible release types are "beta" and
-     "major". Unfortunately, one of the tests performed during that procedure
-     doesn't terminate until it receives an EOF on standard input. I have no
-     idea why, but redirecting from /dev/null remedies the problem.
+     "major". Re-directing standard input to /dev/null ensures that the
+     procedure runs interactively. If you don't do that, you'll have to hit
+     Ctrl+d at one point to satisfy a gnulib test.
 
 * Mounting upload area via FUSE+SSHFS
 
-  : sshfs dl.sv.gnu.org:/releases/autoconf-archive /mnt
-  : ls -l /mnt
-  : fusermount -u /mnt
+  : sshfs dl.sv.gnu.org:/releases/autoconf-archive mnt
+  : ls -l mnt
+  : fusermount -u mnt
diff --git a/TODO b/TODO
index 9015dd6..418e330 100644
--- a/TODO
+++ b/TODO
@@ -1,8 +1,6 @@
 #+TITLE: Autoconf Archive TODO                 -*- mode:org;fill-column:79; -*-
 
-* TODO Improve the web site's front page
 * TODO Improve submission guide lines on the web site
-** Macros must use an AX_ prefix.
 ** Patch submissions should put the original authors on Cc.
 
    Everyone is welcome to submit patches, bug reports, or suggestions to the
@@ -53,12 +51,13 @@
   * [ ] sc_prohibit_magic_number_exit
   * [ ] sc_copyright_check
 
-* TODO Generate serial lines
+* TODO Generate serial lines automatically
 
   The script [[file:set-serial.sh][set-serial.sh]] uses the git repository to determine an appropriate
   serial number (i.e. the number of commits that have occurred) and patches
   that number into the m4 file. The solution seems to work nicely, but it isn't
   integrated into the build process yet.
+
 * TODO Don't repeat license texts in Texinfo for every macro
 
   The Texinfo documentation has a section "license" for every macro that