[webkit-changes] [WebKit/WebKit] 9e4a1e: [CMake] Changing files listed in gi-docgen's TOML ...

[Adrian Perez]

  Branch: refs/heads/main
  Home:   https://github.com/WebKit/WebKit
  Commit: 9e4a1ee88a137f0dcf667cc0d0ca2d36771c7e79
      https://github.com/WebKit/WebKit/commit/9e4a1ee88a137f0dcf667cc0d0ca2d36771c7e79
  Author: Adrian Perez de Castro <aperez at igalia.com>
  Date:   2023-05-09 (Tue, 09 May 2023)

  Changed paths:
    M Source/cmake/FindGIDocgen.cmake

  Log Message:
  -----------
  [CMake] Changing files listed in gi-docgen's TOML configuration does not rebuild documentation
https://bugs.webkit.org/show_bug.cgi?id=256518

Reviewed by Carlos Garcia Campos.

Use "gi-docgen gen-deps" to extract the list of files on which
documentation generation depends and transform tyhe output into a
Make fragment that can be passed as DEPFILE. This makes the build
system aware of the need for documentation rebuilds when e.g. the
Markdown files or images referenced as extra content files in the
TOML configuration file change. Unfortunately, there is a small bug
in gi-docgen and at the moment it does not list the URL mapping file
as a dependency in its output, so changes to such files will not
cause rebuilds until the gi-docgen bug is fixed.

* Source/cmake/FindGIDocgen.cmake: Arrange generating a DEPFILE for
  documentation targets.

Canonical link: https://commits.webkit.org/263862@main