[Git-commits] [grml/grml-etc-core] 4a3593: doc: Error out properly when a generator fails

[Frank Terbeck]

  Branch: refs/heads/master
  Home:   https://github.com/grml/grml-etc-core
  Commit: 4a3593bce8a535dd6daa7d35267d2dbe04a7a291
      https://github.com/grml/grml-etc-core/commit/4a3593bce8a535dd6daa7d35267d2dbe04a7a291
  Author: Frank Terbeck <ft at grml.org>
  Date:   2022-02-08 (Tue, 08 Feb 2022)

  Changed paths:
    M doc/Makefile

  Log Message:
  -----------
  doc: Error out properly when a generator fails

In make only timestamps and return values matter. And the shell will create a
file and update its timestamp when it sees an output redirection. No matter if
the program driving the redirected data fails or not.

So even if the first generator run fails, rerunning make will work, with things
looking like they worked out just fine.

This fixes the issue by running the separate steps toward file generation one
by one.

This issue was brought up by Edward E. (cbrt64 on github) in PR#135 on github¹,
including a proof-of-concept implementation, as well as valuable feedback. This
implementation was derived from it. See the pull-request log for details.

¹ https://github.com/grml/grml-etc-core/pull/135