[XS] Change in coreboot[main]: util/docker/Makefile: Create Documentation/_build for docker-build-docs

[Nicholas Chin (Code Review)]

Attention is currently required from: Martin L Roth, Nicholas Chin.

Hello Felix Singer, Martin L Roth, build bot (Jenkins),

I'd like you to reexamine a change. Please visit

https://review.coreboot.org/c/coreboot/+/81127?usp=email

to look at the new patch set (#3).

Change subject: util/docker/Makefile: Create Documentation/_build for docker-build-docs
......................................................................

util/docker/Makefile: Create Documentation/_build for docker-build-docs

If the host directory of a bind mount does not exist, Docker will create
it. However, the newly created directory will be owned by root due to
the Docker service running within a root context. The docker command in
the recipe for docker-build-docs binds Documentation/_build to /data-out
within the container, so if it doesn't already exist, the documentation
builder will be unable to copy the HTML output into /data-out since it
runs with the same UID and GID as the host user.

By creating, if necessary, the _build directory before the `docker run`
command, there should always be an existing directory owned by the host
user for docker to bind /data-out to (ignoring the case of an existing
_build directory the current user does not have permission to write to),
avoiding the issue where it cannot write the output.

TEST: make -C util/docker docker-build-docs completes without issues
with and without an existing Documentation/_build directory

Change-Id: I6be9bc1fdca48f4d924f5c07cc261189ab6862fd
Signed-off-by: Nicholas Chin 
---
M util/docker/Makefile
1 file changed, 1 insertion(+), 0 deletions(-)

git pull ssh://review.coreboot.org:29418/coreboot refs/changes/27/81127/3