freebsd-dev/contrib/bmake/unit-tests/depsrc-ignore.mk
Simon J. Gerraty e2eeea75eb Merge bmake-20201117
o allow env var MAKE_OBJDIR_CHECK_WRITABLE=no to skip writable
  checks in InitObjdir.  Explicit .OBJDIR target always allows
  read-only directory.

o More code cleanup and refactoring.

o More unit tests

MFC after:	1 week
2020-11-20 06:02:31 +00:00

67 lines
2.3 KiB
Makefile

# $NetBSD: depsrc-ignore.mk,v 1.5 2020/11/15 20:20:58 rillig Exp $
#
# Tests for the special source .IGNORE in dependency declarations,
# which ignores any command failures for that target.
#
# Even though 'ignore-errors' fails, 'all' is still made. Since 'all' is
# not marked with .IGNORE, it stops at the first failing command.
#
# XXX: The ordering of the messages in the output is confusing.
# The "ignored" comes much too late to be related to the "false
# ignore-errors". This is due to stdout being buffered.
#
# The "continuing" message comes from the -k option. If there had been
# other targets independent of "all", these would be built as well.
#
# Enabling the debugging option -de changes the order in which the messages
# appear. Now the "ignored" message is issued in the correct position.
# The explanation for the output reordering is that the output is buffered.
# As the manual page says, in debugging mode stdout is line buffered.
# In these tests the output is redirected to a file, therefore stdout is
# fully buffered.
#
# This is what actually happens, as of 2020-08-29. To verify it, set the
# following breakpoints in CompatRunCommand:
#
# * the "!silent" line, to see all commands
# * the "fflush" line, to see stdout being flushed
# * the "status = WEXITSTATUS" line
# * the "(continuing)" line
# * the "(ignored)" line
#
# The breakpoints are visited in the following order:
#
# "ignore-errors begin"
# Goes directly to STDOUT_FILENO since it is run in a child process.
# "false ignore-errors"
# Goes to the stdout buffer (CompatRunCommand, keyword "!silent") and
# the immediate call to fflush(stdout) copies it to STDOUT_FILENO.
# "*** Error code 1 (ignored)"
# Goes to the stdout buffer but is not flushed (CompatRunCommand, near
# the end).
# "ignore-errors end"
# Goes directly to STDOUT_FILENO.
# "all begin"
# Goes directly to STDOUT_FILENO.
# "false all"
# Goes to the stdout buffer, where the "*** Error code 1 (ignored)" is
# still waiting to be flushed. These two lines are flushed now.
# "*** Error code 1 (continuing)"
# Goes to the stdout buffer.
# "Stop."
# Goes to the stdout buffer.
# exit(1)
# Flushes the stdout buffer to STDOUT_FILENO.
all: ignore-errors
ignore-errors: .IGNORE
@echo $@ begin
false $@
@echo $@ end
all:
@echo $@ begin
false $@
@echo $@ end