[SCM] GNU M4 source repository branch, master, updated. cvs-readonly-359-gd69fa52

[Eric Blake]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU M4 source repository".

http://git.sv.gnu.org/gitweb/?p=m4.git;a=commitdiff;h=d69fa5284851b2b7aac25ffac638b6b379994db5

The branch, master has been updated
       via  d69fa5284851b2b7aac25ffac638b6b379994db5 (commit)
       via  9ad9cd6305ce42713c7cce9ae0bfb81c7a758326 (commit)
      from  a6d4737a42a19cca2400d9f3d2cd035a016dcab4 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d69fa5284851b2b7aac25ffac638b6b379994db5
Author: Eric Blake <address@hidden>
Date:   Sat Dec 31 14:56:15 2016 -0600

    maint: improve generation of ChangeLog from git commits
    
    Follow the practice set in numerous other GNU projects, where
    the ChangeLog (since 2015) is generated from git commit messages.
    This avoids duplication or subtle differences between the two,
    as well as making it easier to merge patches across branches
    (as good as Bruno Haible's 'git-merge-changelog' helper program
    is, it still doesn't handle cross-branch cherry-picks very well).
    
    * Makefile.am (EXTRA_DIST): Rely on gnulib to ship gitlog-to-changelog.
    ($(changelog)): Update rule to match branch-1.4 style.
    * .gitattributes: Drop stale mention of Changelog.
    * HACKING: Reword to match new procedure, and simplify by
    referring to an external description of ChangeLog style.
    
    Signed-off-by: Eric Blake <address@hidden>
    (cherry picked from commit 5456676ea90dfedd9b54c843f15b006d02150d06)
    [commit 6bdb0a4b75 already started the conversion, but this updates
    the approach to be more like other GNU projects, and branch-1.4]

commit 9ad9cd6305ce42713c7cce9ae0bfb81c7a758326
Author: Eric Blake <address@hidden>
Date:   Mon Jan 9 12:07:51 2017 -0600

    maint: improve 'make distcheck'
    
    Commit b29e2867 added gnulib's src/assure.h during bootstrap to fix
    development builds, but forgot to check that tarballs also build.
    
    With this patch, things get further, although I'm still facing a
    failure because the VPATH 'make check' portion of distcheck is
    failing to load modules, where an in-tree build succeeded.
    
    * Makefile.am (src_m4_SOURCES): Add assure.h.
    
    Signed-off-by: Eric Blake <address@hidden>

-----------------------------------------------------------------------

Summary of changes:
 .gitattributes |    1 -
 HACKING        |   90 ++++++++++++++------------------------------------------
 Makefile.am    |   19 +++++++-----
 3 files changed, 33 insertions(+), 77 deletions(-)

diff --git a/.gitattributes b/.gitattributes
index 233cfcd..f7c0ed7 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,6 +1,5 @@
 # See ./bootstrap for some helpful ~/.gitconfig or .git/config settings
 # needed for using these attributes effectively.
-ChangeLog merge=merge-changelog
 *.texi* diff=texinfo
 null.* diff merge
 iso8859.m4 diff merge
diff --git a/HACKING b/HACKING
index 83990e1..0e5cd66 100644
--- a/HACKING
+++ b/HACKING
@@ -154,70 +154,24 @@ and is not part of a release distribution.
 5. Editing 'ChangeLog'
 ======================
 
+* The ChangeLog is generated from git commit comments.  Each commit log
+  should start with a one-line summary, a blank line, and then a
+  ChangeLog-style entry for all affected files.  However, it's fine --
+  even recommended -- to write a few lines of prose describing the
+  change, when the summary and ChangeLog entries don't give enough of
+  the big picture.  Omit the leading TABs that you're used to seeing in
+  a "real" ChangeLog file, but keep the maximum line length at 72 or
+  smaller, so that the generated ChangeLog lines, each with its leading
+  TAB, will not exceed 80 columns.  As for the ChangeLog-style content,
+  please follow these guidelines:
+
+    http://www.gnu.org/software/guile/changelogs/guile-changelogs_3.html
+
 * 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  <address@hidden>
-
-*  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  <address@hidden>,
-            Name of Contributor  <address@hidden>
-
-* Where a change author did not supply a copyright assignment, but the
-  changes they submitted were sufficiently trivial to commit in any case
-  (see the GCS for guidelines on this), then flag this against their
-  name in the header, thus:
-
-yyyy-mm-dd  Name of Author  <address@hidden>  (tiny change)
-
-* 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, :.
-
-* 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 <address@hidden>.
+  appropriate new template, which you can then paste into your git
+  commit editing session.
 
 * See the GNU Coding Standards document for more details on ChangeLog
   formatting.
@@ -225,8 +179,8 @@ yyyy-mm-dd  Name of Author  <address@hidden>  (tiny change)
 6. Formatting
 =============
 
-* Use space-only indentation in nearly all files (Makefile and
-  ChangeLogs being the exception).
+* Use space-only indentation in nearly all files (Makefile inputs being
+  the exception).
 
   If you use Emacs and your m4 working directory name matches,
   this code in your ~/.emacs enables the right mode:
@@ -290,8 +244,8 @@ yyyy-mm-dd  Name of Author  <address@hidden>  (tiny change)
   In particular, ensure that the gnulib version is at least as new as
   the latest stable libtool release.
 
-* Update the version number in NEWS and ChangeLog, and mention in README
-  whether the release is stable.  See
+* Update the version number in NEWS, and mention in README whether the
+  release is stable.  See
   http://www.gnu.org/software/libtool/contribute.html for details of the
   numbering scheme (M4 uses a similar scheme to libtool, although
   intra-release versions carry more information thanks to
@@ -337,9 +291,9 @@ yyyy-mm-dd  Name of Author  <address@hidden>  (tiny change)
   See http://www.gnu.org/software/libtool/contribute.html for details of
   the numbering scheme.
 
-* Update NEWS, README, and ChangeLog to start the intra-release changes,
-  and run `git commit'.  Then run `git push origin refs/tags/v<version>'
-  to push the release tag and complete the release.
+* Update NEWS and README to start the intra-release changes, and run
+  `git commit'.  Then run `git push origin refs/tags/v<version>' to push
+  the release tag and complete the release.
 
 * For stable releases, update the webpages.
   Run `build-aux/gnu-web-doc-update', which runs `make web-manual' on a
diff --git a/Makefile.am b/Makefile.am
index 1f38595..d432696 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -65,22 +65,24 @@ AM_CPPFLAGS    += -Im4/gnu -I$(srcdir)/m4/gnu \
                  -Im4 -I$(srcdir)/m4
 AM_LDFLAGS     += $(OS2_LDFLAGS)
 EXTRA_DIST     += bootstrap cfg.mk maint.mk .version .prev-version \
-                 $(config_macro_dir)/gnulib-cache.m4 $(gitlog_to_changelog)
+                 $(config_macro_dir)/gnulib-cache.m4
 BUILT_SOURCES  += .version
 .version:
-       echo $(VERSION) > address@hidden && mv address@hidden $@
+       $(AM_V_GEN)echo $(VERSION) > address@hidden && mv address@hidden $@
 dist-hook: dist-tarball-version
 dist-tarball-version:
-       echo $(VERSION) > $(distdir)/.tarball-version
+       $(AM_V_GEN)echo $(VERSION) > $(distdir)/.tarball-version
 
 dist-hook: $(changelog)
 changelog_start_date = 2011-01-01
 $(changelog): FORCE
-       $(AM_V_GEN)if test -d '$(srcdir)/.git'; then    \
-         $(gitlog_to_changelog)                        \
-           --since=$(changelog_start_date) > 'address@hidden'; \
-         rm -f '$@'; mv 'address@hidden' '$@';                 \
-         cat '$(changelog_old)' >> '$@';               \
+       $(AM_V_GEN)if test -d '$(top_srcdir)/.git'; then        \
+          test -e '$(log_fix)'                                 \
+            && amend_git_log="--amend=$(log_fix)"              \
+            || amend_git_log=;                                 \
+         $(gitlog_to_changelog) $$amend_git_log                \
+           --since=$(changelog_start_date) > 'address@hidden'          \
+         && rm -f '$@' && mv 'address@hidden' '$@';                    \
        fi
 
 # Sort in traditional ASCII order, regardless of the current locale;
@@ -123,6 +125,7 @@ MAINTAINERCLEANFILES += \
 
 bin_PROGRAMS   = src/m4
 src_m4_SOURCES = \
+                 src/assure.h \
                  src/xstrtoul.c \
                  src/xstrtol-error.c \
                  src/xstrtol.c \


hooks/post-receive
-- 
GNU M4 source repository