kc3-lang/automake/doc
Branch :
Log
| Author | Commit | Date | CI | Message |
|---|---|---|---|---|
 |
61357c93 | 2024-05-31 08:58:23 | maint: secondary updates from make fetch. * doc/help2man: restore copyright list as in upstream. * lib/gendocs.sh: update with make fetch. * lib/texinfo.tex: likewise. | |
 |
0d49ecb2 | 2024-05-21 09:54:35 | doc: test-driver option args are separate words. For https://bugs.gnu.org/70638. As now mentioned in the manual, the description of the test-driver command-line interface has been wrong since 2011 when it was first added. The manual, and the driver usage messages themselves, have consistently shown option arguments joined to the option name with `=' characters, while the implementation of Automake has always provided option arguments in the following argument word, and the provided test drivers only accepted option arguments in the following argument word. Because Automake has never used the `=' syntax, there can't possibly be a working driver which actually follows the specification as written, so, despite the fierce language of the manual, we agreed that changing the specification was the right approach. The `test-driver' program's usage message has already been fixed (#22445), but the full extent of the problem wasn't noticed at that time. * doc/automake.texi (Command-line arguments for test drivers): Fix the table of options to show arguments passed as separate words; add footnote explaining this rather sorry situation. * doc/automake.texi (Use TAP with the Automake test harness): Remove `=' from documentation of `--diagnostic-string', because that was never acceptable either. * lib/tap-driver.sh: Fix usage message. * contrib/tap-driver.pl: Change usage message to match the defined protocol. (This implementation parses options using Perl's `Getopt::Long' module, so it accepts the `=' syntax as specified, but this program isn't actually used.) | |
 |
fa816226 | 2024-05-06 08:16:40 | doc: update Vala documentation From https://bugs.gnu.org/70557#29. * doc/automake.texi (Vala Support): Update the URL for Vala. Drop the mention of a version requirement, as no current system will have a too-old version of Vala. Note the restriction on conditional inclusion of source files in *_SOURCES. | |
|
2fa17ccc | 2024-01-23 08:53:18 | automake: recommend autoreconf -f with version mismatches. From https://bugs.gnu.org/68674. * bin/automake.in (scan_autoconf_traces): change error to suggest running autoreconf -f. The version mismatch is most likely to happen due to the cache files, which aclocal && automake (the previous recommendation) does not delete. (scan_autoconf_files): likewise. * doc/automake.texi (Auto-generating aclocal.m4): mention autoreconf. Other minor wording changes. | |
 |
ac64ce26 | 2024-01-17 14:48:13 | python: use posix_prefix instead of posix_local on Debian. From https://debbugs.gnu.org/cgi/bugreport.cgi?bug=54412#17. (Patch slightly adapted by Bogdan from original by Gianfranco, as posted by Stefano Rivera in message#14.) * m4/python.m4 (AM_PATH_PYTHON): replace Debian's posix_local scheme with posix_prefix. * doc/automake.texi (Python) <pythondir>: say a bit more. * NEWS: mention this. | |
|
420b53da | 2024-01-17 09:44:49 | doc: mention debian python 3.10 changes; master menu; etc. * doc/automake.texi (Creating amhello): mention libtool too. (FAQ): remove spurious leftover "Errors with distclean" menu entry. (Top): Regenerate master menu (M-x texinfo-master-menu). | |
 |
b80b5c47 | 2024-01-01 11:29:06 | maint: make update-copyright | |
|
ea454b4f | 2023-12-31 18:28:10 | doc: overview of autotools ordering. * doc/automake.texi (Creating amhello): briefly mention the order in which to run the autotools, a la autoreconf. A couple other tweaks. | |
 |
21ac1161 | 2023-12-30 15:37:05 | dist: Use -9 instead of --best, and only for gzip, to pacify Alpine. From https://bugs.gnu.org/68151. * lib/am/distdir.am (GZIP_ENV): Set to -9, not --best, since Alpine does not support --best. (distcheck): Don't use GZIP_ENV when invoking gzip for decompression, since Alpine does not support -1..-9 with decompression. * doc/automake.texi (The Types of Distributions): Document the change. * NEWS: mention this. (En passant, add more change links.) | |
|
01b62818 | 2023-12-25 15:42:34 | test: silent-defaults.sh rerun autotools each time. Follow-up to https://bugs.gnu.org/32868. * t/silent-defaults.sh: rerun $ACLOCAL && $AUTOMAKE for each trial, else test failed. (Why it has always succeeded before now, and/or what has changed, I don't know.) Remake the cache for each trial, for reliability. Echo trial description. * doc/automake.texi (Silent Rules): tweak text. (Unsilencing Automake): new node. Mention make --debug=p to completely unsilence rules. | |
|
8f43e75d | 2023-12-23 10:44:03 | doc: more on help2man and "Errors with distclean". This fixes (the rest of) https://bugs.gnu.org/67891. * doc/automake.texi (Errors with distclean): make a subsection of "Checking the Distribution". Contrast help2man usage examples of Autoconf (includes man pages in distribution) and Automake (no man pages, distributes the help2man script instead). (Checking the Distribution): convert subheadings to subsections. * doc/local.mk: also mention autoconf vs. automake approaches here, and point to the manual. (checklinkx): en passant, remove unused checklinkx exclude. | |
|
0fbca7e7 | 2023-12-10 15:12:00 | doc: add advice to list Yacc/Lex generated sources in BUILT_SOURCES. For https://bugs.gnu.org/62791. * doc/automake.texi (Yacc and Lex): it seems to be necessary to list the generated C source file for a Yacc/Lex file, as well as the header file, in BUILT_SOURCES. | |
|
fac41f94 | 2023-12-02 14:33:30 | doc: autoconf portability link, python NEWS. More for https://bugs.gnu.org/67268. * doc/automake.texi (Usage of Conditionals): link to Autoconf's Limitations of Builtins, e.g., https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.71/html_node/Limitations-of-Builtins.html * NEWS: Python version preferences are not just miscellaneous. | |
 |
8cdbdda5 | 2023-11-21 08:30:00 | automake: make the ARFLAGS default 'cr' instead of 'cru'. In some GNU/Linux distributions people started to compile 'ar' binary with --enable-deterministic-archives (binutils project). That, however, in combination with our previous long time working default AR_FLAGS=cru causes warnings on such installations: ar: `u' modifier ignored since `D' is the default (see `U') The 'u' option (at least with GNU binutils) did small optimization during repeated builds because it instructed 'ar' to not open/close unchanged *.o files and to rather read their contents from old archive file. However, its removal should not cause a big performance hit for usual workflows. Distributions started using --enable-deterministic-archives knowing that it would disable the 'u', just to rather have a bit more deterministic builds. Also, to justify this change a bit more, keeping 'u' in ARFLAGS could only result in many per-project changes to override Automake's ARFLAGS default, just to silence such warnings. Fixes bug#20082. Reported by Eric Blake. * bin/automake.in (handle_libraries): Use 'ARFLAGS=cr' by default. * doc/automake.texi (Building a library): Mention the changed ARFLAGS default. (@c LocalWords): Replace 'cru' with 'cr'. * m4/ar-lib.m4 (AM_PROG_AR): Cut out 'cru' string into separate ARFLAGS variable with new default 'cr'. * NEWS: Document. | |
|
f4b5d415 | 2023-11-18 18:25:16 | doc: mention shell operators preferred over `test` options. * doc/automake.texi (Usage of Conditionals): mention that shell operators (&&, ||, ()) are preferred over `test` options (-a, -o, \(\)). Idea and POSIX url reference from Michael Stapelberg, https://lists.gnu.org/archive/html/automake-patches/2016-10/msg00002.html | |
|
df85c29c | 2023-11-01 09:25:21 | doc: tiny Texinfo cleanups. * doc/automake.texi (Public macros): Missed @var usage. (Dependencies): "The Autoconf Manual" in cross-manual xref. | |
 |
edd08396 | 2023-11-01 09:18:57 | m4: update invocation of AC_PROG_LEX. * m4/lex.m4: Pass on any arguments given to AC_PROG_LEX. * doc/automake.texi: Describe this. * NEWS: Mention this. * THANKS: New contributor. | |
|
2d91e57b | 2023-10-30 10: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. | |
 |
1c618bce | 2023-10-06 08:18:33 | automake: new option posix to emit .POSIX target first. This patch is from https://bugs.gnu.org/55025. * lib/Automake/Options.pm (_is_valid_easy_option): declare new option "posix". * bin/automake.in (generate_makefile): if the "posix" option is present, add a .POSIX special target as the first non-comment line in the Makefile.in files. * NEWS: mention this. * doc/automake.texi: likewise. | |
 |
80d755f9 | 2023-08-05 17:58:10 | doc: missing docdir and lispdir in _DATA description. This changes fixes https://bugs.gnu.org/65032. * doc/automake.texi (Data): add docdir and lispdir, index doc_DATA and lisp_DATA. | |
|
dbdfa65c | 2023-07-20 18:03:27 | automake: disable GNU make's internal pattern rules, for speed. From https://bugs.gnu.org/64743. * lib/am/footer.am: Disable GNU make's internal pattern rules. * lib/Automake/Rule.pm (_conditionals_for_rule): Add special handling for these pattern rules from footer.am. (define): Likewise. * t/nodep.sh: Update test to avoid matching the new %:: rules. * t/fnoc.sh: Update test to avoid matching the new %:: SCCS rule. * NEWS: Mention this. * doc/automake.texi (Suffixes): Likewise. (Doc changes written by Karl.) | |
 |
5c85a9d3 | 2023-07-13 15:32:34 | texi: assume .texi.in generates .texi. This change refines the fix for https://bugs.gnu.org/54063. * bin/automake.in (scan_texinfo_file): if .texi doesn't exist, but .texi.in exists, read the latter for the Texinfo source. Use the @setfilename argument, if present, to generate rules. * t/txinfo-no-texi-but-texi-in.sh: new test. * t/list-of-tests.mk (handwritten_tests): add it. * doc/automake.texi (Texinfo): document this. * NEWS: mention this. (Doc changes written by Karl.) | |
|
8859f820 | 2023-06-29 17:59:48 | doc: discuss setting uid/gid information in tarballs. In response to https://bugs.gnu.org/19615. * doc/automake.texi (Basics of Distribution): give example of specifying the TAR_OPTIONS (environment) variable used by GNU tar. | |
|
a456dfd6 | 2023-06-27 18:10:38 | doc: discuss workaround for V=99 failing. In response to https://bugs.gnu.org/20077. * doc/automake.texi (Tricks For Silencing Make): state and discuss workarounds for the limitation of $(V) only being settable to 0 or 1. | |
|
7db4d7d1 | 2023-06-24 18: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. | |
|
5b87f66c | 2023-05-29 17:54:07 | doc: improve NAME string for man pages. This change fixes https://bugs.gnu.org/62853 and https://bugs.gnu.org/62854. * doc/local.mk (update_mans): move $(AM_V_GEN): to calls; include --name="$${HELP2MAN_NAME}". (-%D%/aclocal-$(APIVERSION).1, %D%/automake-$(APIVERSION).1): set HELP2MAN_NAME in environment to pass to help2man. | |
|
e5168045 | 2023-05-27 17: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. | |
|
ae8d12e3 | 2023-05-27 17:55:15 | maint: Update files from upstream with 'make fetch' + help2man. * lib/INSTALL: update with make fetch. * lib/config.guess: Update. * lib/config.sub: Likewise. * lib/gendocs.sh: Likewise. * lib/gnupload: Likewise. * lib/texinfo.tex: Likewise. * lib/update-copyright: Likewise. * doc/help2man: now 1.49.1. | |
 |
f15852df | 2023-01-03 21:46:38 | rm: convert more cases to am__rm_f Fixes automake bug https://bugs.gnu.org/10828. Clean up a few more cases where we were doing `test ... || rm ...` to avoid calling `rm -f` without arguments by leveraging am__rm_f. These were harder to find in the source due to their constructed nature. The clean programs rules in particular were much more complicated than they needed to be. This logic boiled down to two things: delete the list of programs, and then delete the list without the exeext suffix, but only if the list of programs is non-empty. The check-TESTS rule was converted to am__rm_f, but a simplification was missed where the $list variable is inlined. * bin/automake.in: Delete test -z logic and always call am__rm_f. * contrib/check-html.am: Use $(am__rm_f) helper. * doc/automake.texi: Update examples to match current behavior. * lib/am/check.am: Inline $list variable. * lib/am/progs.am: Rewrite rule to use $(am__rm_f). | |
|
2c0a22f9 | 2023-01-08 17:56:40 | doc: overriding targets doesn't mean third-party Makefiles. Fixes automake bug https://bugs.gnu.org/60607. * doc/automake.texi (dvi and distcheck): simply show dvi: as an example of a do-nothing Makefile (xref to Extending), instead of cross-referencing the complicated method in Third-Party Makefiles. (Clean, Extending): wording tweaks. | |
|
34bdde96 | 2023-01-04 02:00:14 | maint: make update-copyright | |
|
2a1e6f74 | 2022-10-01 15:03:16 | maint: Update files from upstream with 'make fetch' + help2man. * lib/INSTALL: update with make fetch. * lib/config.guess: Update. * lib/config.sub: Likewise. * lib/gendocs.sh: Likewise. * lib/texinfo.tex: Likewise. * doc/help2man: now 1.49.1. | |
 |
cea8158f | 2022-09-27 18:04:20 | automake: do not use -Q with emacs invocations. This change is for https://bugs.gnu.org/58102. (By the way, the previous two commits were for bugs 58026 (silent .elc compilation) and 58025 (load bytecomp), respectively, but I forgot to mention them.) * m4/lispdir.m4 (AM_PATH_LISPDIR): omit -Q option. Also (from karl), use -no-site-file (one hyphen) for consistency with the other options. * NEWS: mention this. * doc/automake.texi (Hard-Coded Install Paths): likewise. | |
|
fee9a828 | 2022-03-13 00:12:23 | doc: refer to automake manual in all man pages Fixes automake bug https://bugs.gnu.org/54363. There is no "aclocal" manual as it's all integrated into the automake manual, so have all the help2man calls force automake as the manual. * doc/local.mk: Use --info-page=automake for man pages. | |
|
d5dc4e0a | 2022-02-23 00:44:11 | manual: mention LT_INIT The AC_PROG_LIBTOOL macro name is the old/deprecated one, so include LT_INIT here too to avoid confusing people who have switched. * doc/automake.texi: Add LT_INIT after AC_PROG_LIBTOOL. | |
|
5c9e117c | 2022-02-08 00:39:40 | elisp: run emacs with --no-site-file Fixes automake bug https://bugs.gnu.org/21547. If users have interactive site file logic, the lispdir probing can hang, as can the compilation of elisp files. Use --no-site-file to disable loading any of that possible user logic. * NEWS: Note emacs --no-site-file change. * doc/automake.texi: Run emacs with --no-site-file. * lib/am/lisp.am: Likewise. * m4/lispdir.m4: Likewise. | |
|
8ff90705 | 2022-02-06 01:23:47 | manual: document Python version support status Clarify to users what versions of Python are supported and until when. This will make it easier for us to decide what versions to support. * doc/automake.texi: Add Supported Python versions section. | |
|
9daa34db | 2022-01-24 03:08:13 | texi: define new AM_TEXI2FLAGS variable To provide a bit more flexibility when invoking TEXI2DVI & TEXI2PDF, and provide a bit of symmetry with .info & .html generation, provide a AM_TEXI2FLAGS setting that is passed to all TEXI2xxx invocations. * doc/automake.texi: Mention new AM_TEXI2FLAGS setting. * lib/am/texibuild.am: Pass $(AM_TEXI2FLAGS) to TEXI2DVI & TEXI2PDF. * NEWS: Mention AM_TEXI2FLAGS. * t/txinfo-many-output-formats.sh: Check for AM_TEXI2FLAGS. | |
|
c1b799a0 | 2022-01-24 02:53:13 | texi: pass automatic -I to dvi & pdf generation Fixes automake bug https://bugs.gnu.org/23599. When generating info/html pages, automake adds -I flags to source dirs that contain the texi files, but it doesn't do this for dvi or pdf formats. Instead, automake has been relying on texi2dvi to use makeinfo for expanding macros, and it hasn't done that by default in a long time. Since adding --expand to the texi2dvi call is undesirable (due to bad and unpredictable BEHAVIOR), pass those automatic -I flags directly to TEXI2DVI & TEXI2PDF so they work regardless of --expand behavior. We have to keep the MAKEINFO= setting around as texi2dvi might itself fall back to it if the version of tex is old or broken. * bin/automake.in: Add comment about $makeinfoflags usage. * doc/automake.texi: Mention automatic -I subdir flags. * lib/am/texibuild.am: Pass %MAKEINFOFLAGS% to TEXI2DVI & TEXI2PDF. * t/txinfo-subdir-pr343.sh: Check for -I subdir usage. | |
|
975ea4d9 | 2022-01-19 05:14:47 | progs, libs: support _RANLIB overrides Much like we have per-target support for _AR and _LINK, add an _RANLIB override too. This allows selection of specific ranlib tools in case a non-standard archiver tool was forced. * bin/automake.in: Check for _RANLIB per-target settings. * doc/automake.texi: Document _RANLIB override. * lib/am/library.am: Change $(RANLIB) to $(%XLIBRARY%_RANLIB). * t/list-of-tests.mk: Add ranlib_override.sh. * t/ranlib_override.sh: New test. * NEWS: Mention new feature. | |
|
4c2c73bf | 2022-01-20 02:03:23 | aclocal: add m4 search path info to --help Add a short summary to --help of the current paths that will be searched. Make sure to omit this from the man page when running help2man since pre-inst-env specifically clears some and others to the current build directory. * bin/aclocal.in: Include m4 search paths in usage. * doc/local.mk: Run help2man with AUTOMAKE_HELP2MAN=true. | |
|
5d022858 | 2022-01-18 04:47:09 | build: fix race in parallel builds As reported by Hongxu Jia: > The automake-$(APIVERSION) is a hardlink of automake, if it is > created later than update_mans executing, there is a failure > [snip] > |: && mkdir -p doc && ./pre-inst-env /usr/bin/env perl ../automake-1.16.1/doc/help2man --output=doc/aclocal-1.16.1 aclocal-1.16 > |help2man: can't get `--help' info from aclocal-1.16 > |Try `--no-discard-stderr' if option outputs to stderr > Makefile:3693: recipe for target 'doc/aclocal-1.16.1' failed > [snip] > > The automake_script is required by update_mans and update_mans > invokes automake-$(APIVERSION) rather than automake to generate > doc, so we should assign `automake-$(APIVERSION)' to automake_script. > > The same reason to tweak aclocal_script. However, rather than update the _script variables to point to the hardlinked copies of the programs, we can have the help2man steps run the existing scripts directly. This makes the relationship a bit more explicit and avoids implicit dependencies on names. * doc/local.mk: Pass $(aclocal_script) and $(automake_script) to $(update_mans). * THANKS: Add Hongxu Jia. | |
 |
6c8ff6a8 | 2022-01-12 14:15:12 | maint: make update-copyright | |
|
40f4b5dd | 2021-12-18 18:26:46 | doc: %reldir% and %canon_reldir% do not expand to the empty string. This change fixes https://bugs.gnu.org/52500. * doc/automake.texi (Include): correct wrong text. (Along the way, correct plain-text "Makefile" to "@file{Makefile}".) | |
|
948c5fa4 | 2021-11-04 18:17:39 | doc: rearrange Multiple Outputs node. This change fixes https://bugs.gnu.org/48188. * doc/automake.texi (Multiple Outputs): move GNU pattern rule approach to the front, since it is probably best if GNU make can be assumed. Suggestion from Frank Heckenbach. Also, remove one of the examples that did not work, per Paul Smith. | |
|
f4ac56ee | 2021-11-01 18:24:25 | doc: correct @node placement for new subsubsection. This change addresses https://bugs.gnu.org/51532. * doc/automake.texi (Linking Multiple Yacc Parsers): unfortunately I misplaced the @node after the @subsection; correct that. | |
|
524d9961 | 2021-10-03 19:48:31 | maint: remove trailing white space from a few files * NEWS: Remove trailing white space. * NEWS-2.0: Likewise. * contrib/checklinkx: Likewise. * doc/local.mk (chlx_args): Likewise. * m4/python.m4: Likewise. * t/test-extensions-empty.sh: Likewise. | |
|
6f842a90 | 2021-09-28 18:27:57 | doc: show "RUNNING: <testname>" example using [AM_]TESTS_ENVIRONMENT. This change addresses https://bugs.gnu.org/49309. * doc/automake.texi (Testsuite Environment Overrides): new subsubsection, separating out [AM_]TESTS_ENVIRONMENT description. Add example to get "RUNNING: <testname>" when a test starts. | |
|
80ad99a6 | 2021-09-28 14:59:22 | doc: tweak Yacc/Lex text; subnode for the yacc linking hack. * doc/automake.texi (Alternative): remove obsolete footnote. (Yacc and Lex): tweak wording, more consistent capitalization. (Linking Multiple Yacc Parsers): new subsection. Also add @shortcontents. Also update texinfo-master-menu (for the first time in ages). | |
|
56387843 | 2021-09-19 15:12:27 | python: only use Python's sys.* values if the new option --with-python-sys-prefix is specified; otherwise, return to previous behavior of using the GNU ${prefix} and ${exec_prefix}. * doc/automake.texi (Python): document the new behavior. * m4/python.m4 (AM_PATH_PYTHON): conditionalize use of Python's sys.* values on the new option --with-python-sys-prefix. * t/python-prefix.sh: doc update. * t/python-vars.sh: test both GNU and Python prefix values. * NEWS: mention this. | |
|
4ace473b | 2021-08-08 18:04:01 | maint: Update doc/help2man. * doc/help2man: update to 1.48.24 | |
|
b2487b78 | 2021-08-07 17:59:40 | maint: Update doc/help2man. * doc/help2man: update to 1.48.2. | |
 |
522e0d40 | 2021-08-07 17: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. | |
 |
57688bd5 | 2021-07-15 18:37:09 | automake: silent make output for custom link commands. Patch posted: https://lists.gnu.org/archive/html/automake-patches/2021-07/msg00010.html * bin/automake.in (define_per_target_linker_variable): Use AM_V_${target}_LINK if defined as the verbose variable name for custom link commands. * doc/automake.texi (Program and Library Variables): Document the new variable. * t/link_override.sh: Add extra checks for silent make rules. * NEWS: Mention this. * THANKS: new contributor. | |
|
a470a47f | 2021-07-11 19:19:42 | maint: make update-copyright | |
 |
3d9460bc | 2021-07-09 09:03:30 | maint: tweak comment wording * doc/automake.texi (List of Automake options): Nit. * t/dist-no-built-sources.sh: Likewise. | |
|
13659a73 | 2021-07-09 09:03:30 | dist: add new "dist-no-built-sources" automake option. Fixes automake bug https://debbugs.gnu.org/49317. * bin/automake.in: implement new option "no-dist-built-sources" to omit the dependency of distdir on $(BUILT_SOURCES). (Allison's original patch used the option name dist-pure; trivially renamed.) * lib/am/distdir.am (distdir) [DIST_BUILT_SOURCES]: conditionalize the dependency. * lib/Automake/Options.pm (_is_valid_easy_option): list it. * doc/automake.texi (List of Automake options): document it. * NEWS: mention it. * t/dist-no-built-sources.sh: test it. * t/list-of-tests.mk (handwritten_TESTS): add it. | |
|
16569085 | 2021-07-01 18:21:51 | dist: accept .md versions for README et al. This change was suggested by madmurphy; some ideas were taken from the patch he provided. https://lists.gnu.org/archive/html/automake-patches/2021-06/msg00005.html * bin/automake.in (@toplevelmd_ok): new global, listing the files for which we will accept .md versions. (@common_files): remove those files from there. (handle_dist): check for .md if non-.md is absent. (handle_minor_options): check for README-alpha.md. (check_gnu_standards): accept .md version if present. (check_gnits_standards): likewise. (usage): output list of .md-accepted files. * doc/automake.texi (Basics of Distribution): document. * t/toplevelmd.sh: new test. * t/list-of-tests.mk (handwritten_tests): add it. * NEWS: mention new feature. | |
|
e7724fb1 | 2021-06-08 17:58:10 | doc: omit "really" from manual. * doc/automake.texi: remove or replace "really". | |
|
ccca652a | 2021-06-07 18:09:25 | doc: --always-make doesn't work. * doc/automake.texi (Rebuilding): the GNU Make option --always-make does not work with Automake. Report from Johan Persson, https://lists.gnu.org/archive/html/automake/2021-06/msg00002.html. Also, use "GNU Make" (capital M) more consistently. | |
|
337c4bae | 2021-05-18 18:34:56 | doc: wording. * README: * t/python-virtualenv.sh: * doc/automake.texi: wording, typos, etc. | |
 |
ed8daa06 | 2021-05-18 15:11:59 | python: use Python's sys.prefix and sys.exec_prefix for PYTHON_PREFIX and PYTHON_EXEC_PREFIX; new configure options --with-python_prefix and --with-python_exec_prefix to set explicitly. This change fixes https://bugs.gnu.org/35322. * m4/python.m4 (AM_PATH_PYTHON): use Python's sys.prefix and sys.exec_prefix for PYTHON_PREFIX and PYTHON_EXEC_PREFIX, instead of $prefix and $exec_prefix. But use a variable reference to ${prefix} if it is contained within sys.prefix; similarly for exec_prefix. Also support new configure options to set explicitly. (PYTHON_PREFIX, PYTHON_EXEC_PREFIX): AC_SUBST these. (am_cv_python_pythondir): use our new $am_cv_python_prefix, substituting ${PYTHON_PREFIX}. (am_cv_python_pyexecdir): likewise. * doc/automake.texi (Python): PYTHON_PREFIX, PYTHON_EXEC_PREFIX, document new approach. * t/instmany-python.sh: set PYTHON_PREFIX as needed. * t/python-vars.sh (PYTHON_EXEC_PREFIX, PYTHON_PREFIX): also set from Python's sys.{exec_,}prefix; use ${PYTHON_{EXEC,}PREFIX} instead of ${exec_,}prefix. | |
|
03d1ab0a | 2021-02-22 18:23:16 | doc: a_LDFLAGS always overrides AM_LDFLAGS. This change addresses https://bugs.gnu.org/34925. * doc/automake.texi (Program and Library Variables): document that using a_LDFLAGS at all, even in the false branch of a conditional, means that AM_LDFLAGS is ignored. | |
|
784fcf21 | 2021-02-21 18:26:15 | doc: [AM_]RUNTESTFLAGS not [AM_]RUNTESTDEFAULTFLAGS. * doc/automake.texi (Other Variables): Change [AM_]RUNTESTDEFAULTFLAGS to [AM_]RUNTESTFLAGS. | |
|
89a76c9c | 2021-02-11 18:05:15 | doc: user flags last does not always allow overriding. This change addresses https://bugs.gnu.org/35526. * doc/automake.texi (Flag Variables Ordering): recognize that user flags last does not always allow overriding. | |
|
f80a940a | 2021-01-06 17:57:08 | doc: discuss AC_* ordering a little. * doc/automake.texi (Optional): mention that AC_CONFIG_AUX_DIR must be called before AM_INIT_AUTOMAKE, and recommend that other AC_CONFIG_* macros be called after. This seems to be the most common practice. Autoconf does not currently impose ordering: https://savannah.gnu.org/support/?110416 | |
|
d2ccbd7e | 2020-12-05 18:11:55 | tags: support setting CTAGS, ETAGS, CSCOPE vars via ./configure. This change fixes https://bugs.gnu.org/45013. * m4/init.m4: add default settings and AC_SUBST calls for the variables `CTAGS', `ETAGS' and `CSCOPE'. * lib/am/tags.am: remove default settings of the above variables. * doc/automake.texi (Tags): mention and index. * NEWS: mention. | |
|
e83520ff | 2020-12-03 11:00:53 | warnings: be less forceful about a missing subdir-objects option. This change somewhat ameliorates https://bugs.gnu.org/20699. * bin/automake.in (handle_single_transform): change forward-incompatibility message for subdir-objects to be less draconian and less certain that the change will ever be made. * t/subobj.sh: message text has changed. * doc/automake.texi (Program and Library Variables): mention the unfortunate fact that one directory can clean in a sibling, subdir-objects notwithstanding. | |
|
1f166f3c | 2020-11-24 14:24:22 | doc: typo. This change fixes https://bugs.gnu.org/44845. * doc/automake.texi (Vala Support): zardoz.c not zardoc.c. | |
|
dd616e2d | 2020-11-22 10:13:16 | doc: mention overriding SUBDIRS= with TESTS= and recursive make. This change palliates https://bugs.gnu.org/42883, though it's not a real fix. * doc/automake.texi (Parallel Test Harness): with recursive make, when limiting the tests run, also presumably needed to override SUBDIRS. | |
 |
e21d46fd | 2020-10-27 14:33:46 | python: determine Python (3.10) version number correctly. This change fixes https://bugs.gnu.org/44239 (and https://bugzilla.redhat.com/show_bug.cgi?id=1889732). * m4/python.m4: use print('%u.%u' % sys.version_info[:2]) for the version number instead of merely sys.version[:3], so the numbers are treated as numbers. * t/python-vars.sh (PYTHON_VERSION): Likewise. * doc/automake.texi: Document it. * NEWS: mention it. (Minor tweaks from Karl Berry.) | |
|
310edf02 | 2020-10-23 21:13:09 | doc: correct "moved in", to "moved to" * NEWS: Correct wording. * contrib/README: Likewise. * doc/automake.texi: Likewise. | |
|
f832992d | 2020-10-21 23:31:46 | Improve Vala compiler detection: use API version, not compiler version * m4/vala.m4: check `valac --api-version', not `valac --version'. * doc/automake.texi: update documentation. | |
|
dbc1c9e7 | 2020-10-06 18:16:14 | automake: install-exec did not depend on $(BUILT_SOURCES). This change fixes https://bugs.gnu.org/43683. * lib/am/install.am (install-exec): %maybe_BUILT_SOURCES% dependency, twice. Basic patch from madmurphy (tiny change), message#8. (.MAKE) [maybe_BUILT_SOURCES]: depend on install-exec. * NEWS: mention it. * doc/automake.texi (Sources): mention this (also that make dist depends on $(BUILT_SOURCES)). * t/built-sources-install-exec.sh: new test. * t/list-of-tests.mk (handwritten_TESTS): add it. * t/built-sources-install.sh: typo. * t/built-sources-check.sh: typo. | |
 |
e0d69cc7 | 2020-09-21 14:16:33 | Update documentation of warnings options and strictness levels. The warning categories ‘cross’ and ‘portability-recursive’ were not mentioned in the manual. Also clarify the relationship between warnings categories and strictness levels, and streamline the description of strictness levels by merging the “Gnits” section into the “Strictness” section. * doc/automake.texi (Gnits, Strictness): Combine these sections. Minor revisions to explanation of strictness levels. (automake Invocation): Add documentation of all the warnings categories that have been added since the last time this section was updated. Minor clarifications. | |
 |
39fd2153 | 2020-08-28 17:29:06 | docs: automake-history.texi @dircategory Software development. Per thread at: https://lists.gnu.org/archive/html/automake-patches/2020-08/msg00006.html * doc/automake-history.texi (@dircategory): Define. | |
|
216d1834 | 2020-06-06 15:42:54 | automake: support AM_TESTSUITE_SUMMARY_HEADER override. This change handles https://bugs.gnu.org/11745. * lib/am/check.am (AM_TESTSUITE_SUMMARY_HEADER): new variable. Default value is " for $(PACKAGE_STRING)", including quotes, to keep the default output the same. ($(TEST_SUITE_LOG)): use it, unquoted. * doc/automake.texi (Scripts-based Testsuites): document it. * NEWS: mention it. * t/testsuite-summary-header.sh: new test. * t/list-of-tests.mk (handwritten_tests): add it. * t/ax/testsuite-summary-checks.sh: fix typo. | |
 |
660dfaeb | 2020-05-28 17:45:15 | docs: promote Makefile snippets that work properly with make -n. This change handles https://bugs.gnu.org/10852. * doc/automake.texi (Multiple Outputs): Split commands than reinvoke $(MAKE) to avoid file removals during dry runs. | |
|
c838e042 | 2020-05-25 18:30:53 | docs: forgot TAR in NEWS; fix " -- " in manual. * NEWS: it seems the TAR envvar was never mentioned in NEWS; add it, back for 1.11.3 when it was apparently implemented. * doc/automake.texi: consistently use "---" instead of " --". | |
|
14ac16ec | 2020-05-25 18:20:01 | docs: TAR envvar overrides "tar" for make dist. This change finishes https://bugs.gnu.org/9822. * doc/automake.texi (Basics of Distribution): mention that environment variable TAR overrides "tar". | |
|
04567be6 | 2020-05-17 09:36:15 | automake: new variable AM_DISTCHECK_DVI_TARGET to override "dvi". This change fixes https://bugs.gnu.org/8289. * lib/am/distdir.am (AM_DISTCHECK_DVI_TARGET): define as dvi. (distcheck): use it, isntead of hardcoding dvi. * lib/Automake/Variable.pm (%_silent_variable_override): add AM_DISTCHECK_DVI_TARGET. * t/distcheck-override-dvi.sh: new test. * t/list-of-tests.mk (handwritten_TESTS): add it. * doc/automake.texi (Checking the Distribution): document this. (Third-Party Makefiles): explicitly mention that EMPTY_AUTOMAKE_TARGETS is not a built-in or special name. Various other index entries and wording tweaks. * NEWS (Distribution): mention this. | |
|
656befe5 | 2020-05-07 18:26:33 | docs: make dist implies make dvi. This change handles https://bugs.gnu.org/7994. * doc/automake.texi (Preparing Distributions): make distcheck runs make dvi. (Auxiliary Programs) <texinfo.tex>: mention that make dist runs make dvi, and therefore a TeX system is required when Texinfo sources are present. Add @cmindex entries for all auxiliary programs while we're here. | |
|
c211745e | 2020-04-23 17:40:39 | bug#40699: "dist Hook" documentation in manual is incorrect or unclear about write permissions On 2020-04-20 14:59:00 -0600, Karl Berry wrote: > i.e. it does not change the permissions in order to make the removal > work recursively > > Right, I see it now. Had been testing the wrong thing. > > So, can you propose a specific change for the manual? -k I think that it is sufficient to fix the example (the explanation is just below). BTW, the second example is also incorrect. commit a639e5b51cadbaff88ca4059b4db4571c811070c Author: Vincent Lefevre <vincent@vinc17.net> Date: 2020-04-23 17:33:54 +0200 doc: fix dist-hook examples | |
|
df5460e0 | 2020-03-31 18:21:22 | doc: update urls in manual and include checklinkx script. * doc/automake.texi: update many urls; http -> https, search.cpan.org -> metacpan.org/pod/distribution, node names, etc. Remove sourceware.org/cgi-bin/gnatsweb.pl and miller.emu.id.au/pmiller/books/rmch/ as these are 404 and no good replacement is evident. s/perl/Perl/ a couple times in text for good measure. * contrib/checklinkx: new script, a small modification of W3C checklink <https://validator.w3.org/checklink/docs/checklink.html> (W3C license, which is free software), starting from version 4.81 installed from CPAN: https://metacpan.org/pod/distribution/W3C-LinkChecker/bin/checklink.pod * doc/local.mk (checklinkx): new target to invoke it, with variables. * Makefile.am (EXTRA_DIST): distribute it. * NEWS: mention all this. | |
|
3d14ef91 | 2020-03-16 18:29:59 | maint: sync fdl.texi. * doc/fdl.texi: sync with gnulib/doc/fdl.texi, for https://fsf.org and some Texinfo fixes. | |
|
8e05f006 | 2020-01-26 18:06:04 | doc: clarify build tree location * doc/automake.texi (VPATH Builds): more words about the build tree location. Suggestion from Jefferson Carpenter, 31 May 2018: <https://lists.gnu.org/archive/html/automake-patches/2018-05/msg00003.html> | |
|
cf27a3df | 2020-01-01 11:44:41 | maint: make update-copyright | |
 |
5c466eaf | 2019-10-04 16:39:24 | dist: add dist-zstd option Add support for using the zstd compression algorithm. Use a default compression setting of -19, and ".zst" as the suffix. * bin/automake.in (handle_dist): Add zstd to the list of known dist- suffixes. (preprocess_file): Map ZSTD to dist-zstd. * doc/automake.texi: Document the new option. * lib/Automake/Options.pm (_is_valid_easy_option): Add dist-zstd. * lib/am/distdir.am (dist-zstd): New rule. (?ZSTD?DIST_TARGETS): Add definition. (distcheck): Add a case for *.tar.zst*. * t/dist-formats.tap: Add tests. * NEWS: Mention the change. | |
|
5ae02cc8 | 2019-10-14 13:46:55 | maint: make update-copyright | |
 |
6624f88b | 2018-10-23 20:55:44 | doc: Fix various typos and phrasing This change fixes automake bug#32150. * doc/automake.texi: Various typos and phrasing changes. | |
|
fab4fb3a | 2018-01-03 01:52:34 | doc: Document the portability of various tar formats better * doc/automake.texi (List of Automake options): Document the portability of the tar-ustar and tar-pax options better. | |
 |
bbaa4cdc | 2018-01-04 16:19:30 | maint: Update copyright years to 2018 This update has been made with 'make update-copyright'. | |
|
5e202df2 | 2017-09-23 12:19:43 | maint: Make Emacs use 'makefile-automake-mode' * bin/local.mk: Specify mode name in the first line. * contrib/t/local.mk: Likewise. * doc/local.mk: Likewise. * lib/Automake/local.mk: Likewise. * lib/am/local.mk: Likewise. * lib/local.mk: Likewise. * m4/local.mk: Likewise. * t/local.mk: Likewise. | |
|
c2757b97 | 2017-09-19 13:43:07 | maint: Reset master | |
|
3562e384 | 2017-09-16 13: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. | |
|
199e7a44 | 2017-09-16 13: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. | |
|
f389ecb8 | 2017-08-31 19:23:42 | Merge branch 'minor' | |
|
e94c0186 | 2017-08-31 14:42:13 | build: Rename "Makefile.inc" Makefile fragments to "local.mk" This is done to follow a convention used by a lot of GNU packages. * bin/Makefile.inc: Rename to ... * bin/local.mk: ... this. * doc/Makefile.inc: Rename to ... * doc/local.mk: ... this. * lib/Automake/Makefile.inc: Rename to ... * lib/Automake/local.mk: ... this. * lib/am/Makefile.inc: Rename to ... * lib/am/local.mk: ... this. * lib/Makefile.inc: Rename to ... * lib/local.mk: ... this. * m4/Makefile.inc: Rename to ... * m4/local.mk: ... this. * contrib/t/Makefile.inc: Rename to ... * contrib/t/local.mk: ... this. * t/Makefile.inc: Rename to ... * t/local.mk: ... this. Adapt. * Makefile.am: Adapt. | |
|
ab2d33e6 | 2017-08-29 21:15:14 | aclocal: Support ACLOCAL_AUTOMAKE_DIR environment variable * bin/aclocal.in: Reset '@automake_includes' and '@system_includes' in for build environment. Allow setting '@automake_includes' with ACLOCAL_AUTOMAKE_DIR environment variable. (parse_arguments): Ignore 'dirlist' when '@system_includes' is empty. * doc/automake.texi (aclocal Options): Document ACLOCAL_AUTOMAKE_DIR. * bin/wrap-aclocal.in: Remove extra command line options. * pre-inst-env.in: Set ACLOCAL_AUTOMAKE_DIR and ACLOCAL_PATH environment variables. * t/ax/test-defs.in: Adapt. * t/ansi2knr-no-more.sh (warn_rx): Likewise. | |
|
dd0b8142 | 2017-08-29 14:16:24 | config: Support AUTOMAKE_LIBDIR environment variable * lib/Automake/Config.in: Let AUTOMAKE_LIBDIR environment variable override the default location for '$libdir'. * doc/automake.texi (automake Invocation): Document AUTOMAKE_LIBDIR. * pre-inst-env.in (AUTOMAKE_LIBDIR): Set AUTOMAKE_LIBDIR. * bin/wrap-automake.in: Don't use "--libdir" option. |