summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* rm: convert more cases to am__rm_fMike Frysinger2023-01-091-3/+3
| | | | | | | | | | | | | | | | | | | | | | 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).
* doc: overriding targets doesn't mean third-party Makefiles.Karl Berry2023-01-081-10/+18
| | | | | | | | | | 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.
* maint: make update-copyrightMike Frysinger2023-01-049-11/+9
|
* maint: Update files from upstream with 'make fetch' + help2man.Karl Berry2022-10-011-15/+17
| | | | | | | | | * 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.
* automake: do not use -Q with emacs invocations.Richard Hopkins2022-09-271-1/+1
| | | | | | | | | | | | | 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.
* doc: refer to automake manual in all man pagesMike Frysinger2022-03-131-1/+1
| | | | | | | | | 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.
* manual: mention LT_INITMike Frysinger2022-02-231-0/+1
| | | | | | | 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.
* elisp: run emacs with --no-site-fileMike Frysinger2022-02-081-1/+1
| | | | | | | | | | | | | 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.
* manual: document Python version support statusMike Frysinger2022-02-061-0/+53
| | | | | | | 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.
* texi: define new AM_TEXI2FLAGS variableMike Frysinger2022-01-281-2/+4
| | | | | | | | | | | 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.
* texi: pass automatic -I to dvi & pdf generationMike Frysinger2022-01-281-0/+5
| | | | | | | | | | | | | | | | | | | | | | 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.
* progs, libs: support _RANLIB overridesMike Frysinger2022-01-241-0/+5
| | | | | | | | | | | | | 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.
* aclocal: add m4 search path info to --helpMike Frysinger2022-01-241-1/+1
| | | | | | | | | | 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.
* build: fix race in parallel buildsMike Frysinger2022-01-191-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | 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.
* maint: make update-copyrightJim Meyering2022-01-129-11/+9
|
* doc: %reldir% and %canon_reldir% do not expand to the empty string.Bruno Haible2021-12-181-10/+18
| | | | | | | 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}".)
* doc: rearrange Multiple Outputs node.Karl Berry2021-11-041-44/+24
| | | | | | | | | 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.
* doc: correct @node placement for new subsubsection.Karl Berry2021-11-011-1/+1
| | | | | | | 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.
* maint: remove trailing white space from a few filesJim Meyering2021-10-031-1/+1
| | | | | | | | | * 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.
* doc: show "RUNNING: <testname>" example using [AM_]TESTS_ENVIRONMENT.Karl Berry2021-09-281-21/+52
| | | | | | | | 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.
* doc: tweak Yacc/Lex text; subnode for the yacc linking hack.Karl Berry2021-09-281-55/+71
| | | | | | | | | * 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).
* python: only use Python's sys.* values if the new optionKarl Berry2021-09-191-7/+12
| | | | | | | | | | | | --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.
* maint: Update doc/help2man.Karl Berry2021-08-081-6/+6
| | | | * doc/help2man: update to 1.48.24
* maint: Update doc/help2man.Karl Berry2021-08-071-16/+21
| | | | * doc/help2man: update to 1.48.2.
* doc: typos from codespell.Dimitri Papadopoulos2021-08-071-1/+1
| | | | | | | | | | | | | | * 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.
* automake: silent make output for custom link commands.Nick Gasson2021-07-151-0/+3
| | | | | | | | | | | | | | 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.
* maint: make update-copyrightJim Meyering2021-07-118-8/+8
|
* maint: tweak comment wordingAllison Karlitskaya2021-07-111-3/+3
| | | | | * doc/automake.texi (List of Automake options): Nit. * t/dist-no-built-sources.sh: Likewise.
* dist: add new "dist-no-built-sources" automake option.Allison Karlitskaya2021-07-091-0/+15
| | | | | | | | | | | | | | | 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.
* dist: accept .md versions for README et al.Karl Berry2021-07-011-90/+141
| | | | | | | | | | | | | | | | | | | | 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.
* doc: omit "really" from manual.Karl Berry2021-06-081-69/+67
| | | | * doc/automake.texi: remove or replace "really".
* doc: --always-make doesn't work.Karl Berry2021-06-071-6/+15
| | | | | | | | * 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.
* doc: wording.Karl Berry2021-05-181-167/+164
| | | | | | * README: * t/python-virtualenv.sh: * doc/automake.texi: wording, typos, etc.
* python: use Python's sys.prefix and sys.exec_prefixJoshua Root2021-05-181-35/+45
| | | | | | | | | | | | | | | | | | | | | | | | 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.
* doc: a_LDFLAGS always overrides AM_LDFLAGS.Karl Berry2021-02-221-1/+5
| | | | | | | | 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.
* doc: [AM_]RUNTESTFLAGS not [AM_]RUNTESTDEFAULTFLAGS.Mike Frysinger2021-02-211-2/+2
| | | | | * doc/automake.texi (Other Variables): Change [AM_]RUNTESTDEFAULTFLAGS to [AM_]RUNTESTFLAGS.
* doc: user flags last does not always allow overriding.Karl Berry2021-02-111-12/+17
| | | | | | | This change addresses https://bugs.gnu.org/35526. * doc/automake.texi (Flag Variables Ordering): recognize that user flags last does not always allow overriding.
* doc: discuss AC_* ordering a little.Karl Berry2021-01-061-5/+12
| | | | | | | | * 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
* tags: support setting CTAGS, ETAGS, CSCOPE vars via ./configure.Reuben Thomas2020-12-051-5/+13
| | | | | | | | | | 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.
* warnings: be less forceful about a missing subdir-objects option.Karl Berry2020-12-031-4/+11
| | | | | | | | | | | | 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.
* doc: typo.Karl Berry2020-11-241-1/+1
| | | | | | This change fixes https://bugs.gnu.org/44845. * doc/automake.texi (Vala Support): zardoz.c not zardoc.c.
* doc: mention overriding SUBDIRS= with TESTS= and recursive make.Karl Berry2020-11-221-1/+13
| | | | | | | | | 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.
* python: determine Python (3.10) version number correctly.Miro Hron\v{c}ok2020-10-271-1/+1
| | | | | | | | | | | | 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.)
* doc: correct "moved in", to "moved to"Jim Meyering2020-10-231-1/+1
| | | | | | * NEWS: Correct wording. * contrib/README: Likewise. * doc/automake.texi: Likewise.
* Improve Vala compiler detection: use API version, not compiler versionReuben Thomas2020-10-231-6/+9
| | | | | * m4/vala.m4: check `valac --api-version', not `valac --version'. * doc/automake.texi: update documentation.
* automake: install-exec did not depend on $(BUILT_SOURCES).Karl Berry2020-10-061-11/+11
| | | | | | | | | | | | | | | 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.
* Update documentation of warnings options and strictness levels.Zack Weinberg2020-09-211-119/+127
| | | | | | | | | | | | | | | 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.
* docs: automake-history.texi @dircategory Software development.Robert Wanamaker2020-08-281-0/+5
| | | | | | | Per thread at: https://lists.gnu.org/archive/html/automake-patches/2020-08/msg00006.html * doc/automake-history.texi (@dircategory): Define.
* automake: support AM_TESTSUITE_SUMMARY_HEADER override.Karl Berry2020-06-061-2/+29
| | | | | | | | | | | | | | 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.
* docs: promote Makefile snippets that work properly with make -n.Akim Demaille2020-05-281-14/+24
| | | | | | | 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.
View Lorry Controller Status