HACKING

Branch


Log

Author Commit Date CI Message
Karl Berry 7b7b0d7f 2025-09-21T08:40:44 maint: more info about tags in HACKING. * HACKING: more info about tags.
Karl Berry 0e684652 2025-06-27T09:54:57 maint: 1.18.1 released, version now 1.18.1.91. * configure.ac (AC_INIT): now 1.18.1.91. * m4/amversion.m4 (AM_AUTOMAKE_VERSION): 1.18.1.91 (auto-update). * HACKING: release tweaks.
Karl Berry 153298e2 2025-06-26T10:26:13 maint: prepare for 1.18.1 release. * configure.ac (AC_INIT): 1.18.1. (APIVERSION remains 1.18.) * m4/amversion.m4: likewise (auto-updated). * HACKING: tweak release info some more. * NEWS: likewise.
Karl Berry 1f4ff701 2025-06-25T13:52:29 doc: key maintenance, wording. * HACKING: mention a couple of links wrt key maintenance. * doc/automake.texi: wording tweaks.
Karl Berry dc38a853 2025-06-19T14:34:34 doc: more release stuff in HACKING. * HACKING: more on announcement and signature. Still incomplete.
Karl Berry 9639fc23 2025-05-27T09:01:00 maint: 1.18 released, version now 1.18.0.91. * configure.ac (AC_INIT): now 1.18.0.91. * m4/amversion.m4 (AM_AUTOMAKE_VERSION): 1.18.0.91 (auto-update). * HACKING: release tweaks.
Karl Berry 3f4f7108 2025-05-26T10:31:51 maint: more 1.18 preparations. * HACKING: it's the distcheck results that get distributed; tags. * maintainer/maint.mk (git-tag-release, git-upload-release): show commands that are being run.
Karl Berry a47d7645 2025-05-26T10:07:50 typo
Karl Berry 971aae26 2025-05-26T09:10:25 maint: prepare for 1.18 release. * configure.ac (AC_INIT): 1.18 (APIVERSION): also 1.18. * m4/amversion.m4: likewise (auto-updated). * doc/automake.texi: missing comma in make xref. * HACKING: tweak release info some more. * NEWS: likewise. * INSTALL: missed top-level update from make fetch.
Karl Berry f1bdc6ee 2025-04-12T08:47:59 maint: 1.17.92 pretest released, 1.17.93 for dev. * configure.ac (AC_INIT): now 1.17.93. * m4/amversion.m4 (AM_AUTOMAKE_VERSION): 1.17.93 (auto-update). * HACKING: mention delay between upload and appearance on server.
Karl Berry 8cd1f563 2025-04-11T09:55:05 maint: doc fixes for 1.17.92 pretest. * NEWS: forgot to update the version. * HACKING: mention this.
Karl Berry c0ec787b 2025-04-11T09:45:53 maint: doc and maintainer-check in preparation for 1.17.92. * configure.ac (AC_INIT): now 1.17.92. * m4/amversion.m4 (AM_AUTOMAKE_VERSION): 1.17.92 (auto-update). * HACKING: release wording.
Karl Berry 1608d5e3 2025-04-09T09:44:43 doc: wording, --news-file. * doc/automake.texi: avoid @strong for emphasis; wording. * HACKING: add --news-file option to sample announce-gen invocation.
Karl Berry 1349c729 2025-02-25T14:39:11 maint: doc and maintainer-check in preparation for 1.17.90. * HACKING: mention thanks to individuals. * NEWS: update for 1.17.90. * configure.ac (AC_INIT): now 1.17.90. * m4/amversion.m4 (AM_AUTOMAKE_VERSION): 1.17.90 (auto-update). * maintainer/syntax-checks.mk (sc_tests_command_subst): allow whitespace before # shell comment line. (sc_tests_plain_sleep): emphasize using $sleep without a number; only replace sleep 1 or sleep 2; longer than that would be fine. * t/tap-stderr-prefix.tap: use $sleep instead of sleep 1.
Karl Berry 621ea898 2025-02-25T09:42:23 doc: tiny. * HACKING: mention tag list. * doc/automake.texi: wording.
Karl Berry 92f83bdb 2025-02-04T08:22:26 test: allow running with fatal warnings given in PERL5OPT. * HACKING: mention running the test suite with PERL5OPT=-Mwarnings=FATAL,all in the environment at new Perl (and Automake releases), to try to keep up with new Perl warnings. Suggestion from Jacob Bachmeyer, https://lists.gnu.org/archive/html/automake/2025-02/msg00001.html * t/parallel-tests-log-compiler-example.sh: explicitly use warnings so that this PERL5OPT setting won't be a fatal error. * NEWS: formatting.
Paul Eggert 61075eab 2025-01-01T14:31:02 maint: make update-copyright
Karl Berry 3f9888e2 2024-09-10T15:44:57 automake: recognize all-numeric MAJ.MIN.MICROa.ALPHA versions better. * HACKING: more doc on version numbers. * configure.ac (AC_INIT): 1.17.0.91, since we want (I guess) to retain odd numbers for development and even numbers for pretests. * m4/amversion.m4 (AM_AUTOMAKE_VERSION): 1.17.0.91 (auto-update). (AM_SET_CURRENT_AUTOMAKE_VERSION): likewise. * lib/Automake/Options.pm (_process_option_list): recognize four-part numeric versions as Automake options. * lib/Automake/Version.pm (split): recognize four-part numeric versions. * t/pm/Version.pl (@tests, @bad_versions): update test to check (not reject) four-part numeric versions.
Jim Meyering 5b25b092 2024-07-11T22:52:32 maint: post-release version bump to 1.17.0.90 * configure.ac (AC_INIT): 1.17.0.90. * m4/amversion.m4: likewise (auto-updated). * HACKING: Fix typo in version example.
Karl Berry cb0c4be3 2024-07-10T15:15:04 maint: prepare for 1.17 release. * configure.ac (AC_INIT): 1.17. (APIVERSION): also 1.17. (Yikes.) * m4/amversion.m4: likewise (auto-updated). * HACKING: tweak release info some more.
Karl Berry 9719ecd7 2024-07-08T15:04:48 automake: info about Automake and Libtool being in different prefixes. In response to https://bugs.gnu.org/71847. * doc/automake.texi (Libtool library used but LIBTOOL is undefined): new node. Tweak aclocal section. * lib/Automake/Variable.pm (require_variables): refer to the new node in the message for LT_INIT. * maintainer/maint.mk (announcement) <AO>: new fn; use it to output a link to the new node for test releases only. * HACKING: mention M-x texinfo-master-menu, et al. * doc/amhello/README: mention that the package is named amhello.
Karl Berry 9314b5cf 2024-07-03T08:33:59 doc: tweak announce-gen invocation HACKING. * HACKING: generalize gnulib/build-aux/announce-gen invocation.
Karl Berry 07280092 2024-07-01T08:31:40 doc: tweak release info in HACKING. * HACKING: mention gnulib/build-aux/announce-gen, etc.
Paul Eggert 1d35638b 2024-06-07T08:41:45 maint: spelling and whitespace fixes Most of these spelling fixes are just to comments and documentation. However, some affect tests as follows: * t/cond36.sh (tparse.h): Fix misspelling of dependency. * t/disthook.sh: Fix misspelling of file. * t/help3.sh: Fix misspelling of long option. * t/instdir-ltlib.sh: Fix misspellings of macro names. This causes the test to fail, so someone with libtool expertise needs to look into this. * t/tap-no-spurious-numbers.sh (highno): Fix misspelling of shell var.
Karl Berry 2e3b7da5 2024-06-02T10:47:20 maint: support test releases numbered from .90 for announcements. * maintainer/maint.mk (beta_version_rx, alpha_version_rx): update to use MAJOR.MINOR.90, .92, ..., for "beta" (test) releases, and .91, .93, ... for "alpha" (development). Follows the 2024-01-21 change. * HACKING: typo en passant.
Karl Berry 788615aa 2024-05-31T08:55:10 maint: prepare for next pretest. * HACKING: typo, tweak release info. * maintainer/maint.mk: typo. * maintainer/syntax-checks.mk: typo, and exclude test-defs.sh (actually .in) from the `...` test because I can't figure out how to get the same results with $(...).
Karl Berry 23e69f6e 2024-05-27T12:34:35 test: check that subsecond mtime works with make. Trying to fix https://bugs.gnu.org/68808. * m4/sanity.m4 (_AM_FILESYSTEM_TIMESTAMP_RESOLUTION): check that make works with subsecond mtimes, as well as sleep and ls. (Known to fail with the make 3.81 that ships with macOS.) * configure.ac (MTIME_RESOLUTION): notice if it erroneously expands to the empty string, i.e., fall back to 1 if $am_cv_filesystem_timestamp_resolution ended up being unset. * t/ax/test-defs.in (MTIME_RESOLUTION): also fall back to 1 if the variable to not set, with a message. Fix other typos en passant. * HACKING: tweak.
Karl Berry 2f120f1b 2024-01-30T15:10:21 doc: mention pyenv. * HACKING: mention pyenv as a way to test different Python versions.
Karl Berry 5bb9bb42 2024-01-24T15:43:24 doc: typo for Channels.pm, mention files for which we are the master. * HACKING: mention files for which we are the master. * lib/Automake/ChannelDefs.pm: typo for Automake::Channels; mention that we hold the master copy of this. * lib/Automake/Channels.pm: update/add text for master copy notice. * lib/Automake/Configure_ac.pm: likewise. * lib/Automake/FileUtils.pm: likewise. * lib/Automake/Getopt.pm: likewise. * lib/Automake/XFile.pm: likewise.
Karl Berry 211dc035 2024-01-24T15:34:29 doc: more about pretest numbering. * HACKING: mention change to numbered pretests. * configure.ac: and hence am_beta_version_rx won't match any more. Let's just call all pretests development snapshots.
Paul Eggert b80b5c47 2024-01-01T11:29:06 maint: make update-copyright
Karl Berry 0249be1e 2023-12-25T15:38:15 test: force long sleep with explicit cache variable setting. From https://bugs.gnu.org/67670. * t/ax/test-defs.in: when MTIME_RESOLUTION is set to 1 because automake/autom4te do not support subsecond-mtime, also set am_cv_sleep_fractional_seconds=false. Otherwise the random parallel test failures from given bug and others return. * m4/sanity.m4 (_AM_SLEEP_FRACTIONAL_SECONDS): reformat. (_AM_FILESYSTEM_TIMESTAMP_RESOLUTION): elide "the" in AC_CACHE_CHECK. * t/amassign.sh: end with :. * HACKING: more on debugging tests. * NEWS: update.
Dimitri Papadopoulos f033898f 2023-12-24T14:56:50 doc: update location of FETCHFILES variable. Report and patch: https://bugs.gnu.org/68004. * HACKING: FETCHFILES has been moved: Makefile.am -> maintainer/maint.mk.
Karl Berry 80b72e67 2023-12-18T14:20:55 maint: announcement text tweaks. * HACKING: mention DEVEL_SNAPSHOT=1 for us. * NEWS: tweak text. * maintainer/maint.mk (announcement): tweak text, ls -l ./announcement as a clue as to where the result is.
Karl Berry 5c8dce80 2023-12-13T10:17:49 doc: checklinkx tweaks. * HACKING: mention checklinkx to check for broken links. * contrib/checklinkx: mention us in version info; use warnings instead of -w.
Karl Berry 2d91e57b 2023-10-30T10:14:51 doc: user conditional for dependency tracking. * doc/automake.texi (Automatic dependency tracking): Describe basing a conditional for dependency tracking on the shell variable enable_dependency_tracking. Mentioned by Nick Bowler. https://lists.gnu.org/archive/html/automake/2023-09/msg00004.html * HACKING: Capitalization.
Karl Berry 7db4d7d1 2023-06-24T18:31:29 doc: bring a few examples up to date. * doc/automake.texi (Built Sources Example): use @kbd for typed commands; show current output. (Checking the Distribution): refer to Third-Party Makefiles for the do-nothing dvi target example. Other small wording tweaks throughout. * HACKING: consistently omit $ prompt. Say a bit more about versions of Autoconf. Describe actual current status of branches (only master in use). Give some topic examples. "rerun" not "re-run". Other small wording tweaks throughout.
Karl Berry e5168045 2023-05-27T17:59:51 doc: HACKING bug merge; doc/local.mk help2man update hints. * HACKING: give bug merge example. * doc/local.mk: how to update help2man manually; fix checklinkx sleep comment.
Mike Frysinger 34bdde96 2023-01-04T02:00:14 maint: make update-copyright
Kelvin M. Klann 63216e55 2022-10-06T14:08:55 doc: typo in HACKING changes. * HACKING: allow backward compatibilities again.
Karl Berry 96fd38d7 2022-10-01T09:19:57 more HACKING tweaks
Karl Berry 7191c6b4 2022-10-01T09:02:15 aclocal: protect against Perl undefined warnings. * bin/aclocal.in (usage): check that envvars (ACLOCAL_AUTOMAKE_DIR, ACLOCAL_PATH) are defined before printing values. * HACKING: describe running scripts from checkout, et al.
Karl Berry b64df48b 2022-01-23T14:27:11 doc: singular/plural agreement, since it's easy. * HACKING: singular/plural agreement. * t/README: likewise.
Jim Meyering 6c8ff6a8 2022-01-12T14:15:12 maint: make update-copyright
Dimitri Papadopoulos 522e0d40 2021-08-07T17:54:17 doc: typos from codespell. * HACKING: typo from codespell. * doc/local.mk: likewise. * lib/am/header-vars.am: likewise. * lib/am/lisp.am: likewise. * t/cond24.sh: likewise. * t/cond36.sh: likewise. * t/dist-auxdir-many-subdirs.sh: likewise. * t/link_override.sh: likewise. * t/parallel-tests-console-output.sh: likewise. * t/subobj11a.sh: likewise. * t/subobj11b.sh: likewise.
Jim Meyering d5ca48a6 2021-07-17T12:55:12 doc: NEWS tweak * NEWS: Indent consistently.
Karl Berry bb0cd901 2021-07-17T18:10:21 doc: update HACKING. * HACKING: update for some current realities.
Karl Berry 0c8100cb 2021-05-12T18:08:02 doc: HACKING updates. * HACKING: some additional tidbits.
Jim Meyering 7665b8e2 2020-02-29T08:11:23 doc: gender tweak * HACKING: s/his/their/
Jim Meyering cf27a3df 2020-01-01T11:44:41 maint: make update-copyright
Paul Eggert 5ae02cc8 2019-10-14T13:46:55 maint: make update-copyright
Mathieu Lirzin e8c08f51 2018-01-15T16:42:09 maint: Document how to use Guix for Automake development * HACKING <Setting the development environment>: New part.
Mathieu Lirzin bbaa4cdc 2018-01-04T16:19:30 maint: Update copyright years to 2018 This update has been made with 'make update-copyright'.
Mathieu Lirzin 2e6c978a 2017-11-24T13:28:24 maint: Update HACKING * HACKING (Working with git): Remove reference to the 'micro' branch and adapt branch descriptions to the current branching scheme.
Mathieu Lirzin 5f1e0dde 2017-09-20T12:50:25 maint: 'master' should be merged into 'next' * HACKING: Fix instructions merge instructions.
Mathieu Lirzin ced195a8 2017-09-06T01:11:50 maint: Document new Branch names convention * HACKING: Update to new Branch names.
Mathieu Lirzin c2757b97 2017-09-19T13:43:07 maint: Reset master
Paul Eggert 3562e384 2017-09-16T13:03:36 Prefer https: URLs In Gnulib, Emacs, etc. we are changing ftp: and http: URLs to use https:, to discourage man-in-the-middle attacks when downloading software. The attached patch propagates these changes upstream to Automake. This patch does not affect files that Automake is downstream of, which I'll patch separately. Althouth the resources are not secret, plain HTTP is vulnerable to malicious routers that tamper with responses from GNU servers, and this sort of thing is all too common when people in some other countries browse US-based websites. See, for example: Aceto G, Botta A, Pescapé A, Awan MF, Ahmad T, Qaisar S. Analyzing internet censorship in Pakistan. RTSI 2016. https://dx.doi.org/10.1109/RTSI.2016.7740626 HTTPS is not a complete solution here, but it can be a significant help. The GNU project regularly serves up code to users, so we should take some care here.
Paul Eggert 199e7a44 2017-09-16T13:03:36 Prefer https: URLs In Gnulib, Emacs, etc. we are changing ftp: and http: URLs to use https:, to discourage man-in-the-middle attacks when downloading software. The attached patch propagates these changes upstream to Automake. This patch does not affect files that Automake is downstream of, which I'll patch separately. Althouth the resources are not secret, plain HTTP is vulnerable to malicious routers that tamper with responses from GNU servers, and this sort of thing is all too common when people in some other countries browse US-based websites. See, for example: Aceto G, Botta A, Pescapé A, Awan MF, Ahmad T, Qaisar S. Analyzing internet censorship in Pakistan. RTSI 2016. https://dx.doi.org/10.1109/RTSI.2016.7740626 HTTPS is not a complete solution here, but it can be a significant help. The GNU project regularly serves up code to users, so we should take some care here.
Mathieu Lirzin 29408e8b 2017-09-15T12:04:19 maint: Document how to handle assignment exemption * HACKING: Update.
Mathieu Lirzin 386569b2 2017-05-18T14:50:03 bootstrap: Rename 'bootstrap.sh' to 'bootstrap'. Follow Gnulib's convention of using either "bootstrap" or "autogen.sh" file names for development bootstrap scripts. * bootstrap.sh: Rename to ... * bootstrap: ... this. * GNUmakefile (bootstrap): Adapt. * HACKING: Likewise. * Makefile.am (EXTRA_DIST): Likewise. * doc/automake.texi (Future of aclocal) (Error required file ltmain.sh not found): Likewise. * maintainer/maint.mk (autodiffs, update-copyright): Likewise.
Mathieu Lirzin d8add592 2017-03-02T18:55:53 maint: Update copyright years to 2017. This update has been made with 'make update-copyright'.
Jim Meyering 1370ce5f 2017-01-01T08:34:49 maint: update copyright dates for 2017 * all files: Run this command, using update-copyright from gnulib: UPDATE_COPYRIGHT_FORCE=1 \ UPDATE_COPYRIGHT_USE_INTERVALS=2 \ UPDATE_COPYRIGHT_MAX_LINE_LENGTH=79 \ update-copyright $(git ls-files)
Stefano Lattarini 5de75f07 2015-01-05T22:48:33 maint: update copyright years to 2015 (branch 'micro') Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini a78f63c5 2014-04-21T15:10:54 maint: update copyright years We've been in 2014 already for few months now... Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 055893ba 2013-12-24T13:49:44 HACKING: minor clarification Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 86e45fe1 2013-05-23T20:12:17 Merge branch 'micro' into maint * micro: tests: avoid '$MAKE' redirections, use 'run_make' instead tests: avoid use of redirected 'run_make' invocations lint: warn against redirected 'run_make' invocations comments: next GNU make release 4.0, not 3.83 tests: fix a potential spurious failure due to global config.site HACKING: it's OK to do testsuite refactoring in a micro version Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini d9a3a447 2013-05-22T20:13:41 HACKING: it's OK to do testsuite refactoring in a micro version Reported-by: Peter Rosin <peda@lysator.liu.se> Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 6aaa128d 2013-05-16T13:35:45 Merge branch 'micro' into maint * micro: tests: remove exec bit from all of them ('micro' branch) maint: tests no longer need to have executable bit set
Stefano Lattarini 48fc2d83 2013-05-16T12:13:32 maint: tests no longer need to have executable bit set It has been a while since they are runnable only through "make check" or "./runtest", and not directly. * HACKING: Adjust. * t/README: Likewise, and updated the surrounding text to get rid of obsolete statements and advices. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 52a76013 2013-05-15T22:54:15 Merge branch 'micro' into maint * micro: post-release: micro version bump (1.13.2a) release: stable micro release 1.13.2 vala tests: skip in a cross compiler setup HACKING: miscellaneous fixes, updates and enhancements NEWS: minor improvements to wording (about new versioning scheme) Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 3a4c7cf9 2013-05-15T19:34:41 HACKING: miscellaneous fixes, updates and enhancements Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 5daad702 2013-02-20T22:14:55 Merge branch 'branch-1.13.2' into maint * branch-1.13.2: coverage: expose automake bug#13760 tests: refactor/enhance tests about make dry-run mode maint: describe new versioning and branching scheme, and adjust to it Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 97aaf121 2013-02-17T10:25:29 maint: describe new versioning and branching scheme, and adjust to it See discussion about automake bug#13578 for more details and background. Basically, for the versioning scheme: - micro versions only for bug and regression fixing; - minor versions for new backward-compatible features, and new non-fatal deprecations; - major versions for backward-incompatibilities, complex new features, and major refactoring. And for the git branching scheme: + branch 'next' is for the upcoming major version; + branch 'master' is now for the upcoming minor version; + branch 'maint' is for the upcoming micro (bug-fixing) version; + the merging hierarchy is: 'maint' -> 'master' -> 'next'. * HACKING (Automake versioning and compatibility scheme): New. (Working with git): Adjust. * NEWS: Update and fix. * aclocal.in: Adjust some "FIXME" messages. * automake.in: Likewise. * m4/mkdirp.m4: Likewise. * t/aclocal-acdir.sh: Likewise. * t/aclocal-macrodir.tap: Likewise. * t/aclocal-macrodirs.tap: Likewise. * lib/Automake/Options.pm: Likewise. * m4/internal/ac-config-macro-dirs.m4: Likewise. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 57b72c4b 2013-02-13T19:39:38 style: call perl functions 'like_this()', not '&like_this()' We can do so now that our build rules auto-generate a list of prototypes for all functions ins our scripts. * automake.in: Adjust throughout. * HACKING: Adjust advises. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 1ab8fb6d 2013-01-11T18:57:28 HACKING: suggest more checks before releasing In particular, "make check-no-trailing-backslash-in-recipes", "make check-cc-no-c-o" and "make maintainer-check" should also be run. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 01685620 2013-01-10T23:28:45 HACKING: minor typofix Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 38bb5c65 2013-01-10T23:27:21 HACKING: bug-tracker, the PLANS directory, and how to plan "big" changes Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 27fc8979 2013-01-10T23:16:37 HACKING: rewindable branches should live in the 'experimental/*' namespace Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini ca307a40 2013-01-10T23:10:58 HACKING: fixlets about git branch rewinding policy Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 801cbef2 2013-01-10T23:10:02 HACKING: commit messages are not to follow GCS ChangeLog rules too strongly Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini d7aef9bd 2013-01-10T23:06:27 HACKING: "detailed explanation" in commit messages is almost mandatory Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 7138cc5e 2013-01-10T23:04:06 HACKING: we use "merge --log" even when merging master Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini ad2e3170 2013-01-10T23:01:28 HACKING: typofix Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 7df8b28c 2012-12-31T18:18:37 maint: update copyright year for 2013 (in branch maint) Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini f72c2300 2012-12-15T14:09:10 HACKING: release process: fixlets about the announcement * HACKING: The announcement should be generate *before* bumping the version number to the next alpha number. Also, only an abridged version of the announcement should be copied on the Savannah news feed (a link to the complete announcement should be linked from there, though). Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 4c550df0 2012-12-13T16:03:35 HACKING: update instructions to update the manuals at www.gnu.org Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 49fb69d8 2012-12-08T20:11:39 docs: add rule to generate manuals for www.gnu.org Less clerical work to do by hand. * Makefile.am (web-manuals): New rule. (clean_texinfo_clutter): New macro. * clean-web-manuals, clean-texinfo-clutter: New cleaning rules. (clean-local): Depend on them. * .gitignore: Update. * HACKING: Adjust instructions for generation of manuals. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 6e8997d8 2012-12-08T19:49:33 docs: copy the 'gendocs.sh' script from Texinfo CVS repository As well as the 'gendocs_template' file. And enhance the "make fetch" target to keep them synced. It's better than having to fetch these files by hand each time a release is to be made. * Makefile.am (FETCHFILES): List 'gendocs.sh' and 'gendocs_template'. (fetch): Fetch them, into 'lib/'. (EXRA_DIST): Distribute them. * HACKING: Adjust instructions for generation of manuals. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 234a9cad 2012-12-08T18:45:42 release: generate a stub for the release announcement It's much better than having to write it my hand each time; after all, most of it is either boilerplate or a cope of NEWS entries. * Makefile.am (determine_release_type): Also set the shell variable '$announcement_type' appropriately. (print-release-type): Print the value of this new variable as well. (announcement): New phony target, generate a files with the same name. The recipe uses the shell variable '$announcement_type'. (CLEANFILES): Clean it. (PACKAGE_MAILINGLIST): New make macro, used when generating the 'announcement' file. * HACKING: Explain how to take advantage of the new convenience target. * .gitignore: Ignore the 'announcement' file. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini d85a97bd 2012-11-17T19:42:58 hacking: release procedure: fix order of some steps * HACKING (Release procedure): The manuals should be rebuilt and uploaded at at www.gnu.org *before* bumping the version number to the next alpha release. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 1726b6d5 2012-08-12T21:30:56 readme: fixlets to HACKING * HACKING: Use longer "=====" lines to separate different section (this is just eye-candy admittedly, but I prefer it). (Release procedure): Don't tell to "update NEWS"; that should be updated throughout the normal course of development. Instead, tell to just check it. Improve description of the re-bootstrapping and rechecking procedure, also suggesting to use "git clean" beforehand (with all due warnings!). Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini a36a8f6e 2012-05-19T15:11:36 release: remove overly picky check * Makefile.am (git-tag-release): Do not check that the version number NEWS is updated w.r.t. $(VERSION); given the new way we manage NEWS, that would cause gratuitous spurious failures. * HACKING: Update. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini f44ae9ea 2012-04-30T21:17:06 hacking: copyright notices must be updated before releasing * HACKING (Release procedure): Suggest to use "make update-copyright". Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 5f810d0d 2012-04-28T10:21:31 fixup: avoid unconditional re-bootstrapping on "make dist" Since our 'bootstrap' script is distributed, the 'distdir' target depends on it. But in our GNUmakefile, we also have a 'bootstrap' target declared .PHONY, which when called re-bootstrap the Automake distribution. Thus, whenever we run "make dist", GNU make sees it must remake the 'bootstrap' target (as it is a dependency of the 'distdir' target), and thus ends up re-bootstrapping all the package (because of the .PHONY 'bootstrap' target in GNUmakefile). We fix this issue by renaming our bootstrap script to 'bootstrap.sh'. * bootstrap: Renamed ... * bootstrap.sh: ... to this. * GNUmakefile (bootstrap): Adjust. * Makefile.am (EXTRA_DIST): Likewise. (autodiffs): Likewise. * HACKING: Likewise. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini fdf80a97 2012-04-18T18:31:24 hacking: fix typo * HACKING (Test suite): Refer to file 't/README', not to the non-existent 'tests/README'. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 68be923c 2012-04-11T20:21:35 hacking: fixlets w.r.t. the release procedure * HACKING (Release procedure): Do not state that the result of "make fetch" is woefully incomplete: this is not true anymore today. Suggest to re-run the testsuite after a "make fetch", in case any file has been updated. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 0d0cafcd 2012-04-02T18:16:38 hacking: described new branching policy for 1.12 an later This change closes automake bug#11153. * HACKING (Working with git): Document the new policy for automake branching and merging, which will start being applied after 1.12 is released: - the maintenance branch will be 'maint', and we will cut the maintenance releases directly from there; - the development branch will be 'master', and we will cut the new releases directly from there; - 'maint' will be kept regularly merged into 'master'. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 24cd4ca1 2012-04-02T17:41:41 hacking: autotools-generated files are not committed anymore * HACKING (Working with git) Generated files like 'configure', 'Makefile.in' and 'aclocal.m4' are not committed anymore in our git repository since some months. Remove obsoleted advices that assumed they still were. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Stefano Lattarini 55c8794d 2012-04-02T17:36:24 hacking: simplify documentation of bootstrapping process * HACKING (Working with git): Do not suggest that, to ensure the bootstrapping process is performed with the latest autotools, the developer could explicitly pass $AUTOCONF and $AUTOM4TE in the environment to the ./bootstrap and ./configure invocations: that is a little tricky and quite fragile. Instead, suggest to just put modern-enough version of the autotools early in PATH. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>